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
The Places API finds places of interest matching a query in or near a location.
Results include the address, phone number, coordinates, distance from the search center, price
level, weekly opening hours, and a rating tier.
Use the Places API when an agent or application needs to find, compare or recommend local
businesses and points of interest: “coffee near Union Square”,
“24 hour pharmacy in 94110”, or “museums in Cambridge, UK that are open now”.
.md to its URL or sending Accept: text/markdown.For Search and Extract, use /v1/search and /v1/extract for all new integrations and agent tool calls. Use /v1beta/search and /v1beta/extract only when maintaining an existing integration that already uses them. The request bodies changed too: on /v1/extract, full_content, fetch_policy and excerpt_settings go inside advanced_settings, and sending the v1beta top-level excerpts, full_content and fetch_policy to /v1/extract returns a 422. On /v1/search, search_queries is required (at least one short keyword query), and max_results, source_policy and fetch_policy go inside advanced_settings; sending only objective, or sending those fields at the top level, returns a 422. Do not substitute /v1 for the documented FindAll or Ingest endpoint paths.If you are evaluating Parallel Search or comparing it with other search APIs, read How to Eval Parallel Search before you build the harness, especially its Common pitfalls section. The most common mistake is sending the raw question as both objective and the only entry in search_queries. Write a goal-style objective and 1-3 short keyword queries instead.1. Set Up Prerequisites
Generate your API key on Platform, then export it:requests (pip install requests).
2. Make Your First Places API Request
Send what to find asquery and where to look as location: one city, neighborhood, address,
or postal code per request. To search around a point instead, send latitude and longitude.
Sample Request
Request Options
open_now: only places open at request time, in each place’s own time zone. Places with unknown hours are left out.max_distance_km: only places within this distance of the search center.advanced_settings.max_results: up to 20 (default 20).mode:advanced(default) orfast.
max_distance_km, the search radius fits the location, up to 25 km. See
Best Practices for every request field.
Sample Response
The API returns a JSON response with the following structure. Theresults array below is
shortened to one place. Fields that are not known for a place, such as its rating, are left
out.
Next Steps
- Best Practices: every request field, and how to write queries and locations
- Places API Modes: choose between
fastandadvanced - Pricing: per-request cost for each mode
- Rate Limits: default quotas per product