Git.Top Search API
The Search API from Git.Top — 1 operation(s) for search.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/git-top:git-top-search-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Git.Top Agent Search API
version: 0.1.0
description: Agent-native GitHub project knowledge API for search, project lookup, alternatives, comparison, graph reasoning, quality, and schema discovery. High-confidence clients should inspect metadata.source, metadata.reason, trust fields, classification evidence, quality_signal_confidence, verification signals, and migration validation steps, and use require_d1=true when seed fallback should fail closed.
servers:
- url: https://git.top
description: Production
- url: http://localhost:8787
description: Local Worker
tags:
- name: Search
paths:
/api/search:
get:
summary: Search project knowledge by query, category, deployment, difficulty, language…
parameters:
- name: q
in: query
required: false
description: Search query
schema:
type: string
- name: category
in: query
required: false
description: Project category
schema:
type: string
- name: deployment
in: query
required: false
description: Deployment target
schema:
type: string
- name: difficulty
in: query
required: false
description: Difficulty level
schema:
type: string
- name: language
in: query
required: false
description: Primary language
schema:
type: string
- name: project_kind
in: query
required: false
description: 'Project type: project or collection'
schema:
type: string
- name: min_confidence
in: query
required: false
description: 'Minimum classification confidence: low, medium, or high'
schema:
type: string
- name: cloudflare_ready
in: query
required: false
description: Boolean Cloudflare readiness filter
schema:
type: string
- name: ranking
in: query
required: false
description: Use browse for broad category/deployment discovery
schema:
type: string
- name: profile
in: query
required: false
description: 'Response profile: full (default), compact, decision, or evidence. Compact profiles omit raw knowledge rows.'
schema:
type: string
- name: limit
in: query
required: false
description: Maximum result count
schema:
type: string
- name: cursor
in: query
required: false
description: Opaque next_cursor bound to this query and corpus snapshot
schema:
type: string
- name: require_d1
in: query
required: false
description: Fail closed unless D1-backed data is available
schema:
type: string
responses:
'200':
description: Project search results with metadata
content:
application/json:
schema:
$ref: '#/components/schemas/SearchResponse'
example:
profile: full
query:
q: cloudflare agent framework
limit: 3
require_d1: true
search:
applied_filters:
q: cloudflare agent framework
known_filter_values:
project_kind:
- project
- collection
min_confidence:
- low
- medium
- high
projects:
- project_id: cloudflare/agents
repo: cloudflare/agents
name: agents
github_url: https://github.com/cloudflare/agents
language: TypeScript
license: MIT
project_kind: project
category:
- agent_framework
description: Build and deploy AI agents on Cloudflare Workers.
deployments:
- cloudflare
- serverless
difficulty: intermediate
cloudflare_ready: true
git_top_score: 86
quality_score: 82
agent_score: 90
verification:
schema_version: git-top.verification.v1
overall_status: partial
observed_at: '2026-07-04T00:00:00.000Z'
signals:
activity:
status: observed
source: github_metadata
evidence:
- project.pushed_at
- metrics.recent_push_days
license:
status: observed
source: github_metadata
evidence:
- project.license
documentation:
status: observed
source: github_metadata
evidence:
- project.description
runtime:
status: inferred
source: git_top_heuristic
evidence:
- agent_card.deployment
- agent_card.cloudflare_ready
install:
status: not_run
source: git_top_runtime
evidence:
- installation/build probe is not enabled
security:
status: not_run
source: git_top_runtime
evidence:
- dependency/security scan is not enabled
mcp:
status: not_applicable
source: git_top_runtime
evidence:
- project is not classified as mcp_server
coverage:
observed: 3
inferred: 1
not_run: 2
unknown: 0
next_steps:
- Run an installation/build probe before production adoption.
- Run a dependency and security scan before treating the score as a trust claim.
quality_signal_confidence:
stars_30d_delta: snapshot
commits_30d: complete
releases_180d: partial
contributors_90d: complete
evidence:
source_fields:
- agent_card.classification
- metrics
- verification.signals
caveats: []
confidence_reason: Evidence is usable for comparison.
verification:
schema_version: git-top.verification.v1
overall_status: partial
observed_at: '2026-07-04T00:00:00.000Z'
signals:
activity:
status: observed
source: github_metadata
evidence:
- project.pushed_at
- metrics.recent_push_days
license:
status: observed
source: github_metadata
evidence:
- project.license
documentation:
status: observed
source: github_metadata
evidence:
- project.description
runtime:
status: inferred
source: git_top_heuristic
evidence:
- agent_card.deployment
- agent_card.cloudflare_ready
install:
status: not_run
source: git_top_runtime
evidence:
- installation/build probe is not enabled
security:
status: not_run
source: git_top_runtime
evidence:
- dependency/security scan is not enabled
mcp:
status: not_applicable
source: git_top_runtime
evidence:
- project is not classified as mcp_server
coverage:
observed: 3
inferred: 1
not_run: 2
unknown: 0
next_steps:
- Run an installation/build probe before production adoption.
- Run a dependency and security scan before treating the score as a trust claim.
last_verified_at: '2026-07-04T00:00:00.000Z'
caveats: []
confidence_reason: Evidence is usable for comparison.
source_fields:
- agent_card.classification
- metrics
- verification.signals
last_verified_at: '2026-07-04T00:00:00.000Z'
page:
offset: 0
limit: 3
has_more: true
next_cursor: eyJ2IjoxLCJzIjoiZDE6NTAwOnNuYXBzaG90IiwicSI6InF1ZXJ5IiwibyI6M30
snapshot_id: d1:500:2026-07-04T00:00:00.000Z
metadata:
source: d1
reason: d1_query
project_count: 500
generated_at: '2026-07-04T00:00:00.000Z'
snapshot_id: d1:500:2026-07-04T00:00:00.000Z
latest_synced_at: '2026-07-04T00:00:00.000Z'
schema_version: git-top.knowledge.v1
candidate_retrieval: d1_first
candidate_count: 42
candidate_limit: 1000
loaded_project_limit: 1000
truncated: false
tags:
- Search
operationId: getApiSearch
x-operation-id-source: derived
components:
schemas:
SearchResponse:
type: object
required:
- profile
- query
- search
- projects
- page
- metadata
properties:
profile:
type: string
enum:
- full
- compact
- decision
- evidence
default: full
query:
type: object
additionalProperties: true
search:
type: object
properties:
applied_filters:
type: object
additionalProperties: true
known_filter_values:
type: object
additionalProperties: true
empty_reason:
type: string
suggestions:
type: array
items:
type: string
query_interpretation:
type: object
properties:
original:
type: string
normalized:
type: string
transformations:
type: array
items:
type: string
additionalProperties: true
projects:
type: array
description: Project cards shaped by profile. compact returns bounded identity, fit, score, and verification fields; full preserves the complete project card.
items:
type: object
additionalProperties: true
knowledge:
type: array
description: Raw project knowledge rows retained only for the default full profile.
items:
type: object
additionalProperties: true
page:
$ref: '#/components/schemas/CursorPage'
metadata:
$ref: '#/components/schemas/Metadata'
additionalProperties: true
Metadata:
type: object
description: Common provenance envelope for agent-facing responses. Agents should require source=d1 for high-confidence production claims and disclose seed fallback.
properties:
source:
type: string
enum:
- d1
- seed
reason:
type: string
project_count:
type: integer
generated_at:
type: string
format: date-time
snapshot_id:
type: string
description: Stable identity for the corpus snapshot used by this response.
latest_synced_at:
type:
- string
- 'null'
format: date-time
schema_version:
type: string
enum:
- git-top.knowledge.v1
loaded_project_limit:
type: integer
description: Maximum D1 knowledge or search-candidate rows loaded into the bounded ranking set when present.
truncated:
type: boolean
description: Whether the D1-backed ranking or candidate set reached its limit and may omit additional matching rows.
candidate_retrieval:
type: string
enum:
- d1_first
description: Search-only marker indicating that deterministic filters and broad query matching ran in D1 before TypeScript ranking.
candidate_count:
type: integer
description: Number of D1 search candidates passed to the authoritative TypeScript filter and ranking stage.
candidate_limit:
type: integer
description: Maximum number of D1 search candidates passed to the ranking stage.
warnings:
type: array
items:
type: string
description: Fallback, count, freshness, or trust caveats that agents should account for before citing results.
CursorPage:
type: object
required:
- offset
- limit
- has_more
- next_cursor
- snapshot_id
properties:
offset:
type: integer
minimum: 0
limit:
type: integer
minimum: 1
maximum: 100
has_more:
type: boolean
next_cursor:
type:
- string
- 'null'
description: Opaque cursor for the next page, or null on the final page.
snapshot_id:
type: string
description: Corpus snapshot to which this page and cursor are bound.
securitySchemes:
syncSecret:
type: http
scheme: bearer
description: Admin endpoints require the SYNC_SECRET bearer token.
feedbackSecret:
type: http
scheme: bearer
description: Optional FEEDBACK_SECRET. Without it, proposals are validated and fingerprinted but not persisted.