# Search1API Docs

> Official documentation for Search1API web search, news, crawling, webpage screenshots, extraction, integrations, authentication, credits, and error handling.

- [Introduction](https://s1.dev/docs): Search1API gives AI applications one API for discovering, reading, and structuring information from the live web.
- Get Started
  - [Quickstart](https://s1.dev/docs/get-started/quickstart): Create an API key, make one web search request, and understand the response.
- Essentials
  - [Authentication](https://s1.dev/docs/essentials/authentication): Choose OAuth 2.1 or API keys, send bearer credentials safely, and recover from authentication failures.
  - [Credits and limits](https://s1.dev/docs/essentials/credits-and-limits): Understand Search1API request costs, account balances, top-ups, auto top-up, rate limits, and timeouts.
  - [Error handling](https://s1.dev/docs/essentials/error-handling): Handle Search1API authentication, payment, validation, rate-limit, and upstream errors.
- Guides
  - [Choosing an endpoint](https://s1.dev/docs/guides/choosing-an-endpoint): Match a Search1API endpoint to the information you have and the result you need.
  - [Improving search results](https://s1.dev/docs/guides/improving-search-results): Choose sources, retrieve full page text, and narrow Search1API results by site, time, and language.
- Integrations
  - [Official SDKs](https://s1.dev/docs/integrations/sdks): Use the official TypeScript and Python clients for typed requests, errors, retries, batches, and deepcrawl polling.
  - [LangChain](https://s1.dev/docs/integrations/langchain): Give LangChain agents live web search, news, and page content with the official search1api-langchain toolkit.
  - [MCP server](https://s1.dev/docs/integrations/mcp): Give Claude, Cursor, VS Code or any MCP client live web access with a hosted Search1API MCP endpoint — no code required.
  - [LobeHub](https://s1.dev/docs/integrations/lobehub): Configure Search1API as the search and crawler provider for LobeHub's built-in Web Search in a self-hosted deployment.
  - [CLI](https://s1.dev/docs/integrations/cli): Authorize with OAuth 2.1, then search the web, read pages and check trends from your terminal.
  - [Agent skill](https://s1.dev/docs/integrations/skills): Install the Search1API skill so Claude knows when to search, when to crawl, and how to tune the query — not just how to call the API.
  - [n8n](https://s1.dev/docs/integrations/n8n): Add web search, news, page retrieval, sitemap discovery and trending topics to n8n workflows with the verified n8n-nodes-search1api community node.
  - [OpenAPI and llms.txt](https://s1.dev/docs/integrations/openapi): Machine-readable entry points to Search1API — an OpenAPI schema for code generators, and llms.txt for agents.
  - [DeepSeek Harness](https://s1.dev/docs/integrations/deepseek-harness): Give your DeepSeek Harness agent live web access with the native dsh-s1 plugin — web search, news, page retrieval, sitemap discovery, and trending topics as first-class dsh tools.

- **API Reference**
- Basic
  - [Search](https://s1.dev/docs/basic/search): Search the web across multiple engines and return ranked results, optional images, and full page content for selected results.
  - [News](https://s1.dev/docs/basic/news): Search recent news across multiple sources with site, language, and time filters, plus optional full page content.
  - [Crawl](https://s1.dev/docs/basic/crawl): Fetch a web page and return clean, readable content for agents, summarization, and retrieval workflows.
  - [Screenshot](https://s1.dev/docs/basic/screenshot): Render a public webpage as PNG, JPEG, or WebP with controls for the viewport, page readiness, and capture area.
- Advanced
  - [Extract (Beta)](https://s1.dev/docs/advanced/extract): Extract structured data from a URL based on a prompt and schema. Every request costs 10 credits.
  - [Deepcrawl (Beta)](https://s1.dev/docs/advanced/deepcrawl): API endpoints for initiating and monitoring asynchronous deep crawl tasks. Starting a task costs 20 credits; status checks are free.
  - [Trending](https://s1.dev/docs/advanced/trending): API endpoint for retrieving trending topics from popular platforms
  - [Reasoning (Discontinued)](https://s1.dev/docs/advanced/reasoning): The legacy reasoning endpoint has been permanently discontinued.
  - [Sitemap](https://s1.dev/docs/advanced/sitemap): API endpoint for retrieving sitemap links from a website
- Utility
  - [Models (Discontinued)](https://s1.dev/docs/utility/models): The legacy reasoning models endpoint has been permanently discontinued.
  - [Usage](https://s1.dev/docs/utility/usage): Return the remaining credit balance for the authenticated Search1API account.