---
title: "Search for repositories"
method: GET
path: "/repos/search"
tags: ["repository"]
---

# Search for repositories

`GET /repos/search`

## Query parameters

- `q` string
- `topic` boolean
- `includeDesc` boolean
- `uid` integer
- `priority_owner_id` integer
- `team_id` integer
- `starredBy` integer
- `private` boolean
- `is_private` boolean
- `template` boolean
- `archived` boolean
- `mode` string
- `exclusive` boolean
- `sort` string
- `order` string
- `page` integer
- `limit` integer

## Response `200`

SearchResults

- SearchResults — SearchResults results of a successful search
  - `data` Repository[] — Data contains the repository search results
    - `allow_fast_forward_only_merge` boolean
    - `allow_manual_merge` boolean
    - `allow_merge_commits` boolean
    - `allow_merge_update` boolean
    - `allow_rebase` boolean
    - `allow_rebase_explicit` boolean
    - `allow_rebase_update` boolean
    - `allow_squash_merge` boolean
    - `archived` boolean
    - `archived_at` string, date-time
    - `autodetect_manual_merge` boolean
    - `avatar_url` string
    - `branch_count` integer
    - `clone_url` string
    - `created_at` string, date-time
    - `default_allow_maintainer_edit` boolean
    - `default_branch` string
    - `default_delete_branch_after_merge` boolean
    - `default_merge_style` string
    - `default_target_branch` string
    - `default_update_style` string
    - `description` string
    - `empty` boolean
    - `external_tracker` ExternalTracker — ExternalTracker represents settings for external tracker
      - `external_tracker_format` string — External Issue Tracker URL Format. Use the placeholders {user}, {repo} and {index} for the username, repository name and issue index.
      - `external_tracker_regexp_pattern` string — External Issue Tracker issue regular expression
      - `external_tracker_style` string — External Issue Tracker Number Format, either `numeric`, `alphanumeric`, or `regexp`
      - `external_tracker_url` string — URL of external issue tracker.
    - `external_wiki` ExternalWiki — ExternalWiki represents setting for external wiki
      - `external_wiki_url` string — URL of external wiki.
    - `fork` boolean
    - `forks_count` integer
    - `full_name` string
    - `has_actions` boolean
    - `has_code` boolean
    - `has_issues` boolean
    - `has_packages` boolean
    - `has_projects` boolean
    - `has_pull_requests` boolean
    - `has_releases` boolean
    - `has_wiki` boolean
    - `html_url` string
    - `id` integer
    - `ignore_whitespace_conflicts` boolean
    - `internal` boolean
    - `internal_tracker` InternalTracker — InternalTracker represents settings for internal tracker
      - `allow_only_contributors_to_track_time` boolean — Let only contributors track time (Built-in issue tracker)
      - `enable_issue_dependencies` boolean — Enable dependencies for issues and pull requests (Built-in issue tracker)
      - `enable_time_tracker` boolean — Enable time tracking (Built-in issue tracker)
    - `language` string
    - `languages_url` string
    - `licenses` string[]
    - `link` string
    - `mirror` boolean
    - `mirror_interval` string
    - `mirror_last_sync_at` string, date-time
    - `mirror_updated` string, date-time
    - `name` string
    - `object_format_name` 'sha1' | 'sha256' — ObjectFormatName of the underlying git repository
    - `open_issues_count` integer
    - `open_pr_counter` integer
    - `original_url` string
    - `owner` User — User represents a user
      - `active` boolean — Is user active
      - `avatar_url` string — URL to the user's avatar
      - `created` string, date-time
      - `description` string — the user's description
      - `email` string, email
      - `followers_count` integer — user counts
      - `following_count` integer
      - `full_name` string — the user's full name
      - `html_url` string — URL to the user's gitea page
      - `id` integer — the user's id
      - `is_admin` boolean — Is the user an administrator
      - `language` string — User locale
      - `last_login` string, date-time
      - `location` string — the user's location
      - `login` string — login of the user, same as `username`
      - `login_name` string — identifier of the user, provided by the external authenticator (if configured)
      - `prohibit_login` boolean — Is user login prohibited
      - `restricted` boolean — Is user restricted
      - `source_id` integer — The ID of the user's Authentication Source
      - `starred_repos_count` integer
      - `visibility` 'public' | 'limited' | 'private' — User visibility level option: public, limited, private
      - `website` string — the user's website
    - `parent` Repository — recursive
    - `permissions` Permission — Permission represents a set of permissions
      - `admin` boolean
      - `pull` boolean
      - `push` boolean
    - `private` boolean
    - `projects_mode` string
    - `release_counter` integer
    - `repo_transfer` RepoTransfer — RepoTransfer represents a pending repo transfer
      - `doer` User — User represents a user
        - `active` boolean — Is user active
        - `avatar_url` string — URL to the user's avatar
        - `created` string, date-time
        - `description` string — the user's description
        - `email` string, email
        - `followers_count` integer — user counts
        - `following_count` integer
        - `full_name` string — the user's full name
        - `html_url` string — URL to the user's gitea page
        - `id` integer — the user's id
        - `is_admin` boolean — Is the user an administrator
        - `language` string — User locale
        - `last_login` string, date-time
        - `location` string — the user's location
        - `login` string — login of the user, same as `username`
        - `login_name` string — identifier of the user, provided by the external authenticator (if configured)
        - `prohibit_login` boolean — Is user login prohibited
        - `restricted` boolean — Is user restricted
        - `source_id` integer — The ID of the user's Authentication Source
        - `starred_repos_count` integer
        - `visibility` 'public' | 'limited' | 'private' — User visibility level option: public, limited, private
        - `website` string — the user's website
      - `recipient` User — User represents a user
        - `active` boolean — Is user active
        - `avatar_url` string — URL to the user's avatar
        - `created` string, date-time
        - `description` string — the user's description
        - `email` string, email
        - `followers_count` integer — user counts
        - `following_count` integer
        - `full_name` string — the user's full name
        - `html_url` string — URL to the user's gitea page
        - `id` integer — the user's id
        - `is_admin` boolean — Is the user an administrator
        - `language` string — User locale
        - `last_login` string, date-time
        - `location` string — the user's location
        - `login` string — login of the user, same as `username`
        - `login_name` string — identifier of the user, provided by the external authenticator (if configured)
        - `prohibit_login` boolean — Is user login prohibited
        - `restricted` boolean — Is user restricted
        - `source_id` integer — The ID of the user's Authentication Source
        - `starred_repos_count` integer
        - `visibility` 'public' | 'limited' | 'private' — User visibility level option: public, limited, private
        - `website` string — the user's website
      - `teams` Team[]
        - `can_create_org_repo` boolean — Whether the team can create repositories in the organization
        - `description` string — The description of the team
        - `id` integer — The unique identifier of the team
        - `includes_all_repositories` boolean — Whether the team has access to all repositories in the organization
        - `name` string — The name of the team
        - `organization` Organization — Organization represents an organization
          - `avatar_url` string — The URL of the organization's avatar
          - `description` string — The description of the organization
          - `email` string — The email address of the organization
          - `full_name` string — The full display name of the organization
          - `id` integer — The unique identifier of the organization
          - `location` string — The location of the organization
          - `name` string — The name of the organization
          - `repo_admin_change_team_access` boolean — Whether repository administrators can change team access
          - `username` string — username of the organization deprecated
          - `visibility` 'public' | 'limited' | 'private' — The visibility level of the organization (public, limited, private)
          - `website` string — The website URL of the organization
        - `permission` 'none' | 'read' | 'write' | 'admin' | 'owner'
        - `units` string[] — Deprecated: This variable should be replaced by UnitsMap and will be dropped in later versions.
        - `units_map` object
        - `visibility` 'public' | 'limited' | 'private' — Team visibility within the organization. "private" teams are only listable by members and org owners; "limited" teams are listable by any organization member; "public" teams are listable by any signed-in user.
    - `size` integer
    - `ssh_url` string
    - `stars_count` integer
    - `template` boolean
    - `topics` string[]
    - `updated_at` string, date-time
    - `url` string
    - `watchers_count` integer
    - `website` string
  - `ok` boolean — OK indicates if the search was successful

## Other responses

- `422` — APIValidationError is error format response related to input validation

---

[API](https://skmtc.net/gitea/apis/gitea-api.md) · [All operations](https://skmtc.net/gitea/apis/gitea-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitea/gitea-api/versions/350de506cefa/schema)