Skip to main content
GET
/
images
Returns a list of images hits for query
curl --request GET \
  --url https://image-search.ydc-index.io/images \
  --header 'X-API-Key: <api-key>'
{
  "images": {
    "results": [
      {
        "title": "8 Test Day Tips for Success",
        "page_url": "https://www.c2educate.com/8-test-day-tips-success/",
        "image_url": "https://s26378.pcdn.co/wp-content/uploads/sat-or-act-test-1030x519.jpg"
      }
    ]
  },
  "metadata": {
    "query": "The image you are searching for",
    "search_uuid": "c6c8f8cf-b6fc-4248-9828-24fc0dcf7be5"
  }
}

Documentation Index

Fetch the complete documentation index at: https://old-docs.you.com/llms.txt

Use this file to discover all available pages before exploring further.

NOTE: The You.com Image Search is currently available to exclusive early access partners.To express interest in early access, please reach out via email to api@you.com.
ATTENTION: The correct cURL code to use in your API call is in the playground. Click on Try it in the bar above to open the playground.

​
Description

This endpoint returns the URLs of images associated to the user query.

Authorizations

​
X-API-Key
string
header
required

The unique API Key required to authorize API access. Learn how to get yours in the “Get your API key” section of the documentation.

Query Parameters

​
q
string
default:The image you are searching for
required

The search query used to retrieve relevant image results from the web.

Response

A JSON object containing an array of image search results.

​
images
object
​
metadata
object