readthedocs-search-api

Query the Read the Docs Search API for documentation across projects.

8|4|Updated Dec 22, 2025
One-click install
npx skills add https://github.com/readthedocs/skills --skill readthedocs-search-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: readthedocs-search-api
Source: https://github.com/readthedocs/skills/tree/main/skills/readthedocs-search-api
Command: npx skills add https://github.com/readthedocs/skills --skill readthedocs-search-api

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Query the Read the Docs Search API to locate documentation across projects and repositories, enabling programmatic discovery of relevant pages without manual browsing.

Core Features & Use Cases

  • Global search: Query millions of pages across Read the Docs to locate documentation for topics, libraries, or projects.
  • Project-scoped results: Use filters like project:{slug} to narrow results to a specific project.
  • Structured responses & pagination: Navigate through paginated results and extract fields such as project, version, title, path, domain, and highlights.
  • Use Case: Quickly find API docs and related guides for a given project to accelerate onboarding or research.

Quick Start

Set RTD_HOST to your Read the Docs site and query the API endpoint /api/v3/search/?q=<query>&page=<n> to fetch results.

Frequently Asked Questions about readthedocs-search-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search documentation across multiple projects programmatically?

To search documentation across projects, query the Read the Docs Search API endpoint with the q parameter to locate relevant pages across public repositories without requiring authentication.

Does the Read the Docs Search API require authentication to query public docs?

No, the Read the Docs Search API is public and requires no authentication for accessing public documentation across Community and Business sites.

How do I filter search results to a specific project on Read the Docs?

Filter search results to a specific project on Read the Docs by applying the project:{slug} filter within your query to narrow the returned documentation pages.

How does pagination work when querying the Read the Docs Search API?

Pagination works by passing the page parameter to the API endpoint, allowing you to navigate through structured search results and extract fields like project, version, title, path, and highlights.

What is the best way to find API docs and guides for a library without manual browsing?

The best way to find API docs and guides without manual browsing is to programmatically query the Read the Docs Search API, enabling fast discovery of relevant pages to accelerate onboarding or research.

Can I configure the Read the Docs Search API to query a specific site?

Yes, you can configure the Search API to query a specific site by setting the RTD_HOST variable to your Read the Docs site before making requests to the /api/v3/search/ endpoint.