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.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. Do not substitute /v1 for the documented FindAll or Ingest endpoint paths.
Send the Place Search API what to find and where to look. The API returns matching places, best first, each with the best known URL for the place when it has one.

​
Request Fields

Send requests to POST https://api.parallel.ai/v1/places/search with your API key in the x-api-key header. query is required, plus one place to search: location, or latitude and longitude, or both. All other fields are optional. The API rejects unknown fields.

​
Example

​
Writing Queries and Locations

  • Put what in query and where in location. Send "query": "tacos" with "location": "Mission District, San Francisco", not "query": "tacos in the Mission". The location sets the search area.
  • Send one location per request. The field is a single place. A comma inside the name is part of that place ("Cambridge, MA"). A comma-separated list of places is not supported, even within the 200-character limit. Search each place in its own request.
  • Name the kind of place, or the place itself. Short queries work best: "climbing gym", "vegan bakery", "Fitzwilliam Museum". Leave out words like “best” or “cheap”, and use open_now instead of “open now”.
  • Make the location specific enough to place on a map. Add the city or region to neighborhood names: "Le Marais, Paris" rather than "Le Marais". Postal codes and street addresses work too.
  • Add the region or country to names that exist in several places. Send "Cambridge, UK" or "Cambridge, MA", not "Cambridge".
  • Set max_distance_km to widen or narrow the search. Send 1 for walking distance, or a larger value to search beyond a small town.
  • Send both location and coordinates when you have them. latitude and longitude set the center exactly, which is best for “near me” searches. location helps find more places nearby. Keep the two consistent: send the neighborhood or city that contains the point.