GitHub Topic Search API

Search GitHub topics by keyword, optionally limited to featured or curated topics. Each result includes the topic name, display name, description and who created it.

Endpoint: POST /github/search-topics
Price: 1 credit per request
SDK: client.github.searchTopics()
MCP tool: github_search_topics

Start free with 100 credits Read docs →

Terminal

$curl -X POST "https://api.bridgly.app/github/search-topics" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "machine learning",
  "featured": true,
  "count": 10
}'

request.py

import os
import requests
response = requests.post(
    "https://api.bridgly.app/github/search-topics",
    headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"},
    json={
        "query": "machine learning",
        "featured": True,
        "count": 10,
    },
)
data = response.json()

request.js

const response = await fetch("https://api.bridgly.app/github/search-topics", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIDGLY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "query": "machine learning",
    "featured": true,
    "count": 10
  }),
});
const data = await response.json();

request.ts

import { Bridgly } from "@bridgly/sdk";
const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });
const res = await client.github.searchTopics({
  query: "machine learning",
  featured: true,
  count: 10
});
if (res.type === "success") {
  console.log(res.data);
}

[ REQUEST AND RESPONSE ]

What does the GitHub Topic Search API return?

GitHub topics API: search GitHub topics by keyword, with filters for featured, curated and repository count. Each result has its name and description. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

querystring: Free-text search terms, matched against the default fields for this search type, e.g. "web framework".
featuredboolean: Only featured topics. Maps to `is:featured`.
curatedboolean: Only curated topics. Maps to `is:curated`.
repositoriesobject: Filter by number of repositories using the topic. Provide any of gt / gte / lt / lte; combine a lower and upper bound for a range.
repositories.gtnumber · nullable: Strictly greater than this value.
repositories.gtenumber · nullable: Greater than or equal to this value.
repositories.ltnumber · nullable: Strictly less than this value.
repositories.ltenumber · nullable: Less than or equal to this value.
createdobject: Filter by topic creation date. Provide any of gt / gte / lt / lte as YYYY-MM-DD dates; combine a lower and upper bound for a range.
created.gtstring · nullable: Strictly after this date (YYYY-MM-DD).
created.gtestring · nullable: On or after this date (YYYY-MM-DD).
created.ltstring · nullable: Strictly before this date (YYYY-MM-DD).
created.ltestring · nullable: On or before this date (YYYY-MM-DD).
countinteger · 1–10 · default 10: Number of results to return (1–10). Defaults to 10.
startinteger · 0–999: Number of results to skip (0–999). Defaults to 0. Only the first 1,000 results of a search can be paged through.

Example response

200 OK · application/json

{
  "timeMs": 1840,
  "creditsCost": 1,
  "data": {
    "query": "string",
    "totalCount": 0,
    "topics": [
      {
        "name": "string",
        "displayName": "string",
        "shortDescription": "string",
        "description": "string",
        "createdBy": "string",
        "featured": true,
        "curated": true,
        "score": 0
      }
    ],
    "nextStart": 0
  }
}

[ USE CASES ]

What can you build with the GitHub Topic Search API?

Tag repositories

Pick the established topic names to label your projects.

Explore categories

See which topics exist around a technology and how widely they are used.

Build directories

Organize a list of tools by GitHub’s own topics.

[ FAQ ]

GitHub Topic Search API questions

How do I find GitHub topics for a subject?

Send a keyword such as machine learning, and set featured or curated to only get the topics GitHub highlights. Each topic has its name, display name, description and creator.

What can I do with GitHub topic data?

Pick the right topics to tag your repository with, or map a technology space. Pass a topic to the GitHub Repository Search API to list the repositories under it.

How do I get more than 10 results from a GitHub topic search?

Each call returns up to 10 topics. Send the same query with start set to the nextStart from the response for the next ones. GitHub only lets you page through the first 1,000 results of a search, so narrow the query to reach the rest.

How do I use the GitHub Topic Search API?

Send a POST request to https://api.bridgly.app/github/search-topics with the filters you want in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.github.searchTopics(). AI agents connected to Bridgly over MCP can call the github_search_topics tool.

How much does the GitHub Topic Search API cost?

Costs 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.00 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

[ MORE ENDPOINTS ]

More GitHub endpoints

The same API key works on every endpoint. See all GitHub API endpoints.

Try the GitHub Topic Search API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI

free credits

On business email signup. No credit card required.

Start free with 100 credits

Book a demo Read the docs