Images | You.com | Documentation

Beta and unmaintained. This endpoint works, but it is not under active development. The response shape and its availability can change without notice, so do not build a production dependency on it.

Returns the URLs of images associated to the user query.

Access is limited to early access partners. To request access, email [email protected].

<Warning> **Beta and unmaintained.** This endpoint works, but it is not under active development. The response shape and its availability can change without notice, so do not build a production dependency on it. </Warning> Returns the URLs of images associated to the user query. Access is limited to early access partners. To request access, email [[email protected]](mailto:[email protected]).

Authentication

X-API-Keystring

A unique API Key is required to authorize API access. For details, see how to get your API Key.

Query parameters

qstringRequiredDefaults to The image you are searching for

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

Response

A JSON object containing an array of image search results.

imagesobjectOptional

metadataobjectOptional

Errors

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

1	{
2	"images": {
3	"results": [
4	{
5	"title": "8 Test Day Tips for Success",
6	"page_url": "https://www.c2educate.com/8-test-day-tips-success/",
7	"image_url": "https://s26378.pcdn.co/wp-content/uploads/sat-or-act-test-1030x519.jpg"
8	}
9	]
10	},
11	"metadata": {
12	"query": "The image you are searching for",
13	"search_uuid": "c6c8f8cf-b6fc-4248-9828-24fc0dcf7be5"
14	}
15	}

$	curl -G https://api.you.com/v1/images \
>	-H "X-API-Key: <apiKey>" \
>	--data-urlencode "q=The image you are searching for"