Gitea icon

Gitea

Interact with Gitea via API
Join our community

Actions393

Overview

This node allows users to search for repositories within a Gitea instance using various filters and criteria. It is useful when you want to programmatically find repositories based on keywords, ownership, team membership, or other repository attributes. For example, you can search for all repositories related to a specific topic, owned by a particular user, or starred by a certain user.

Common scenarios include:

  • Finding repositories with a specific keyword in their name or description.
  • Filtering repositories by owner, team, or user contributions.
  • Searching only private or public repositories.
  • Sorting repositories by creation date, size, stars, or forks.
  • Paginating through large sets of repository results.

Properties

Name Meaning
Q Keyword to search for in repository names or topics.
Topic Boolean flag to limit search to repositories with the keyword as a topic.
Include Desc Boolean flag to include searching the keyword within repository descriptions.
Uid Numeric user ID to filter repositories that the user owns or contributes to.
Priority Owner Id Numeric ID of a repository owner to prioritize in the search results.
Team Id Numeric team ID to filter repositories belonging to a specific team.
Starred By Numeric user ID to filter repositories starred by that user.
Private Boolean to include private repositories accessible to the user (default true).
Is Private Boolean to show only public, private, or all repositories (default shows all).
Template Boolean to include template repositories accessible to the user (default true).
Archived Boolean to filter only archived, non-archived, or all repositories (default shows all).
Mode String specifying type of repository: "fork", "source", "mirror", or "collaborative".
Exclusive Boolean indicating if search should return only repos owned by the user specified in Uid (default true).
Sort Attribute to sort repositories by: "alpha", "created", "updated", "size", "git_size", "lfs_size", "stars", "forks", or "id". Default is "alpha".
Order Sort order: "asc" (ascending) or "desc" (descending). Default is "asc". Ignored if Sort not specified.
Page Page number of results to return (1-based).
Limit Number of results per page (page size).

Output

The node outputs JSON data containing the list of repositories matching the search criteria. Each item in the output typically includes repository details such as name, owner, description, visibility (private/public), whether it is archived or a template, star count, fork count, and other metadata relevant to each repository.

If binary data is returned (not typical for this operation), it would represent associated files or attachments, but this node primarily returns structured JSON repository information.

Dependencies

  • Requires an API key credential to authenticate with the Gitea instance.
  • The node communicates with the Gitea API endpoint configured via credentials.
  • No additional external dependencies are required beyond the Gitea API access.

Troubleshooting

  • Authentication errors: Ensure the API key or token provided has sufficient permissions to access repository data.
  • Empty results: Verify that the search parameters are correct and that repositories matching the criteria exist.
  • Invalid parameter values: Check that numeric IDs (e.g., uid, team_id) are valid and correspond to existing users or teams.
  • API rate limits: If many requests are made in a short time, the Gitea server may throttle requests; consider adding delays or reducing request frequency.
  • Sorting or filtering issues: Confirm that the sort and order parameters use supported values as described.

Links and References

Discussion