# Search1API REST API

> Live web access for AI agents over HTTPS. Base URL: https://api.search1api.com

## Specification
- [OpenAPI 3.1 schema](https://api.search1api.com/openapi.json): Every operation, parameter, and response schema.
- [API catalog](https://s1.dev/.well-known/api-catalog): RFC 9727 linkset pointing at the schema, docs, and status.
- [Health](https://api.search1api.com/health): Service status.

## Authentication
- [auth.md](https://s1.dev/auth.md): OAuth 2.1 discovery, PKCE, dynamic client registration, errors, and revocation.
- [Protected resource metadata](https://api.search1api.com/.well-known/oauth-protected-resource): RFC 9728 document naming the authorization server.

Send credentials as `Authorization: Bearer <token>`. A 401 carries a
`WWW-Authenticate` challenge whose `resource_metadata` URL is authoritative.

## Endpoints
- [Search](https://api.search1api.com/search): Multi-engine web search. 1 credit per request.
- [Agentic Search](https://api.search1api.com/ask): A decision model (TypeSafe Jev today) detects intent, routes across up to 5 engines, and reranks results. 5 credits per request.
- [News](https://api.search1api.com/news): Recent news search across supported sources. 1 credit per request.
- [Crawl](https://api.search1api.com/crawl): Extract content from a webpage. 1 credit per request.
- [Screenshot](https://api.search1api.com/screenshot): Capture a rendered screenshot of a webpage. 2 credits per request.
- [Sitemap](https://api.search1api.com/sitemap): Discover URLs and site structure. 1 credit per request.
- [Trending](https://api.search1api.com/trending): Trending topics from supported sources. 1 credit per request.
- [DeepCrawl](https://api.search1api.com/deepcrawl): Crawl a full site asynchronously and package the result. 20 credits per request.
- [Extract](https://api.search1api.com/extract): Extract structured data from a URL with a prompt and schema. 10 credits per request.
- [Feedback](https://s1.dev/docs/utility/feedback): POST https://api.search1api.com/feedback with a message and your existing bearer credential. Free; do not include private content or credentials.

## Pricing
- [Credits and plans](https://s1.dev/pricing.md): Per-endpoint credit costs, free tier, subscriptions, and top-ups.

## Other interfaces
- [MCP server card](https://s1.dev/.well-known/mcp/server-card.json): Tool surface for agents that prefer MCP over REST.
- [Documentation](https://s1.dev/docs)