Skip to main content
For AI agents: a documentation index is available at https://docs.parallel.ai/llms.txt. The full text of all docs is at https://docs.parallel.ai/llms-full.txt. You may also fetch any page as Markdown by appending .md to its URL or sending Accept: text/markdown.
The Search API takes a natural language objective and returns relevant excerpts optimized for LLMs, replacing multiple keyword searches with a single call for broad or complex queries.
Available via MCP: Search is available as a tool as part of the Parallel Search MCP. Our MCP is optimized for best practices on Search and Extract usage. Start here with MCP for your use case. If you’re interested in direct use of the API, follow the steps below.
Looking for people or companies? Entity Search is a fast, synchronous people-and-company search — the real-time counterpart to FindAll — returning a set of matching results in seconds. It is distinct from the Search API, which retrieves pages and excerpts across the whole web.

1. Set Up Prerequisites

Generate your API key on Platform. Then, set up with the TypeScript SDK, Python SDK or with cURL:

Sample Request

This request uses the default advanced mode (~3s, highest quality). For latency-sensitive use cases, add "mode": "turbo" as a top-level request field for a p50 of 200ms at a lower cost. The rest of the request stays the same. See Search Modes for a runnable example.

Sample Response

The API returns a JSON response with the following structure. The SDK examples above iterate over results to print each result’s title, URL, and excerpts. If any non-fatal input adjustments or validation warnings have occurred, they will be in the warnings field.

Next Steps

  • Best Practices — learn how to craft effective objectives and search queries
  • Search Modes — explore mode presets for different use cases
  • API Reference — full parameter specifications, constraints, and response schema
  • Rate Limits — default quotas per product