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 most agents, add "mode": "fast" for high-quality results in around 700ms; use "mode": "turbo" (p50 of 250ms) when latency and cost matter most. 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