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 Image Search API one or more keyword queries and, optionally, a natural language objective. The API returns the most relevant images from across the web.

​
Request Fields

Send requests to POST https://api.parallel.ai/v1/images/search with your API key in the x-api-key header. search_queries is required; all other fields are optional. The API rejects unknown fields. See the API Reference for the full parameter definitions.

​
Example

​
Writing Objectives and Queries

  • Describe what should be in the picture. Name the subject and the details that distinguish the image you want, such as the angle, setting, time of day, or style: “Product photos of the Eames lounge chair on a white background” rather than “Eames chair”.
  • Keep queries short and specific. Use a few keywords per query, the way you would type them into an image search box. Use two or three queries when different phrasings or angles would surface different images.
  • Put requirements in the objective. Constraints that are hard to express as keywords, such as “showing the full span” or “no people in frame”, belong in the objective.
  • Use location for regional results. Set advanced_settings.location when the right images depend on the country, such as local landmarks, storefronts, or regional products.