# Search1API Documentation

> Search1API is web access infrastructure for AI agents. Use this index to discover the product overview, pricing, docs, agent interfaces, and machine-readable API specs.

## Product
- [Homepage](https://s1.dev/): Product overview for Search1API.
- [Homepage Markdown](https://s1.dev/index.md): Agent-friendly overview of the product, interfaces, and endpoints.
- [About Search1API](https://s1.dev/about): Product purpose, operator identity, and trust evidence.
- [Contact Search1API](https://s1.dev/contact): Official private support channels and safe diagnostic guidance.
- [Search1API Privacy](https://s1.dev/privacy): Readable privacy summary with a link to the controlling policy.
- [Proxies](https://s1.dev/proxies): Compare fixed Static ISP proxies with rotating residential proxies for automation, account access, scraping, and regional testing.
- [Pricing](https://s1.dev/pricing): Pricing page for the core APIs and agent interfaces.
- [Web Search MCP Server](https://s1.dev/mcp-server): Hosted MCP server exposing five tools (search, news, crawl, sitemap, trending) to any MCP client. OAuth 2.1 or API key, with client configurations for Claude Code, Cursor, VS Code, Windsurf and Claude.ai.
- [Agent Skill and CLI](https://s1.dev/agent-skills): The Search1API agent skill and `s1` CLI for terminal agents. The skill decides when to search, when to read a URL instead, and how deep to go.
- [Integrations](https://s1.dev/integrations): Directory of native integrations, grouped by coding agents, frameworks, automation, and apps.
- [Claude Code](https://s1.dev/integrations/claude-code): Hosted MCP server or the agent skill, either installed with one command.
- [Codex](https://s1.dev/integrations/codex): Hosted MCP server via `codex mcp add --url`, with OAuth login or an API key in `config.toml`.
- [Cursor](https://s1.dev/integrations/cursor): One-click install from the Cursor Directory, or the hosted endpoint in `mcp.json`.
- [DeepSeek Harness](https://s1.dev/integrations/deepseek-harness): The `dsh-s1` plugin registers web access as first-class dsh tools, in-process.
- [LangChain](https://s1.dev/integrations/langchain): The official `search1api-langchain` toolkit exposes search, news, and crawl as LangChain tools.
- [n8n](https://s1.dev/integrations/n8n): The `n8n-nodes-search1api` community node adds search, news, page retrieval, sitemap, and trending.
- [LobeHub](https://s1.dev/integrations/lobehub): Built-in search provider and crawler for self-hosted LobeHub, configured with environment variables.
- [Python Search API](https://s1.dev/python-search-api): Official `search1api` client for Python, with typed errors, retries, async support, and deepcrawl polling.
- [Node.js Search API](https://s1.dev/nodejs-search-api): Official `@search1api/client` for Node.js and TypeScript, typed against the public OpenAPI contract.
- [Pricing Markdown](https://s1.dev/pricing.md): Agent-friendly pricing, credits, and endpoint summary.
- [Proxies Markdown](https://s1.dev/proxies.md): Agent-friendly proxy plans, IP tenancy, bandwidth, and pricing.

## Documentation
- [API Docs](https://s1.dev/docs): Public documentation entry point for the Search1API platform.
- [Search1API OpenAPI and llms.txt](https://s1.dev/docs/integrations/openapi): OpenAPI schema, code-generation guidance, and agent-readable indexes.
- [Search1API MCP server guide](https://s1.dev/docs/integrations/mcp): Hosted Streamable HTTP endpoint, tool list, authentication, and client configuration.
- [Search1API CLI guide](https://s1.dev/docs/integrations/cli): Installation, OAuth login, commands, flags, and JSON output for the official `s1` CLI.
- [Official SDKs](https://s1.dev/docs/integrations/sdks): TypeScript and Python clients with typed responses, errors, retries, and deepcrawl polling.
- [Search1API Agent Skill](https://s1.dev/docs/integrations/skills): Install and use the reusable Search1API skill in supported agent hosts.

## Core APIs
- [Search1API Overview](https://blog.s1.dev/posts/search-api): Overview of the Search1API API families and common use cases.
- [Changelog](https://blog.s1.dev/changelog): Product and API updates.

## Search engines
Each engine is a `search_service` value on the same Search endpoint; the response shape is identical and the `snippet` contract differs per engine.
- [Google Search API](https://s1.dev/google-search-api): Default engine. General web results, with optional page content in the same request.
- [Bing Search API](https://s1.dev/bing-search-api): Bing web results after Microsoft retired its own Search API v7 on 2025-08-11.
- [DuckDuckGo Search API](https://s1.dev/duckduckgo-search-api): A second general index for cross-checking a Google result set.
- [Yahoo Search API](https://s1.dev/yahoo-search-api): Yahoo web results. Supplied by Bing under their search alliance, so expect heavy overlap.
- [GitHub Search API](https://s1.dev/github-search-api): Repositories. Title is `owner/repo`; snippet is `language | N stars | description`.
- [arXiv Search API](https://s1.dev/arxiv-search-api): Papers and preprints. Snippet is `authors | ISO date | abstract`.
- [Reddit Search API](https://s1.dev/reddit-search-api): Posts and discussion. Snippet is `r/subreddit | /u/author | post text`.
- [X Search API](https://s1.dev/x-search-api): Posts. Title carries the display name and `@handle`; snippet is the post text.
- [YouTube Search API](https://s1.dev/youtube-search-api): Videos. Snippet is `channel | runtime | description`.
- [Wikipedia Search API](https://s1.dev/wikipedia-search-api): Reference articles. Snippet is an extract from the article body.
- [IMDb Search API](https://s1.dev/imdb-search-api): Films and television. Snippet is `Rank: N | year | top-billed cast`.
- [WeChat Search API](https://s1.dev/wechat-search-api): Official Account articles. Snippet is `account name | date | excerpt`; article bodies via `crawl_results`.
- [Bilibili Search API](https://s1.dev/bilibili-search-api): Chinese-language video. Snippet is `uploader | runtime | description`.
- [Baidu Search API](https://s1.dev/baidu-search-api): Chinese web, including Baidu Baike and state media.
- [360 Search API](https://s1.dev/360-search-api): A second Chinese index, distinct from Baidu; useful for corroboration.
- [Quark Search API](https://s1.dev/quark-search-api): A third Chinese index, leaning on Alibaba and UC content.

## Agent Interfaces
- [Authentication for Agents](https://s1.dev/auth.md): OAuth 2.1 discovery, PKCE authorization, dynamic client registration, token refresh, and legacy API-key compatibility.
- [MCP Endpoint](https://mcp.search1api.com/mcp): Remote MCP entry point for Search1API.
- [Search1API CLI on npm](https://www.npmjs.com/package/search1api-cli): Official `s1` command-line interface for Search1API.
- [Search1API CLI source](https://github.com/superagents-lab/search1api-cli): Source code, releases, and issues for the official CLI.
- [Search1API Skills](https://github.com/superagents-lab/search1api-cli/tree/master/skills/search1api): Canonical reusable skills for agent environments.

## Machine-readable Specs
- [OpenAPI Specification](https://api.search1api.com/openapi.json): Public API schema for Search1API.
- [REST API Index](https://s1.dev/api/llms.txt): Section-scoped index for agents that only need the HTTP API.
- [Agentic Resource Catalog](https://s1.dev/.well-known/ai-catalog.json): ARD catalog of the MCP server, API schema, skill, and plugin manifest.
- [MCP Server Card](https://s1.dev/.well-known/mcp/server-card.json): Pre-connection description of the hosted MCP server and its tools.