Yahoo Search API endpoint
Returns Yahoo's image-search results for a query: title, direct image URL, the page hosting the image, source domain, thumbnail, and original image dimensions when available. Results are fetched from Yahoo's own server-rendered image-search page.
/yahoo-search/imagesQuery parameters:
q (required) — the search query.Notable response behavior:
image_url is the direct image file Yahoo indexed; page_url is the web
page that hosts it. These are always distinct upstream fields, never the
same URL.width/height are omitted when Yahoo did not carry the original image's
dimensions for a given result.results array, not an
error.| Field | Filled in, of 60 checked | Values in the sample |
|---|---|---|
| position | 60 | 1 to 60, median 30 |
| title | 60 | “Who created ChatGPT?” and 59 other values |
| image_url | 60 | cloudfront-us-east-2.images.arcpublishing.com and 42 other hosts |
| page_url | 60 | |
| domain | 60 | “www.perplexity.ai” and 45 other values |
| thumbnail_url | 60 | tse3.mm.bing.net and 3 other hosts |
| width | 60 | |
| height | 60 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| q | string | Yes | Search query | chatgpt | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/yahoo-search/images?q=chatgpt" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"query": "chatgpt",
"results": [
{
"position": 1,
"title": "Chatgpt Cheat Sheet For Writing Prompts",
"image_url": "https://gizmodo.com/app/uploads/2024/07/ChatGPT-Voice-Chat.jpeg",
"page_url": "https://example.com/chatgpt-cheat-sheet",
"domain": "example.com",
"thumbnail_url": "https://tse4.mm.bing.net/th/id/OIP.example",
"width": 1920,
"height": 1080
}
]
}
}Request schema
No body schema
Response schema
#/definitions/yahoosearch.imagesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | yahoosearch.ImagesResponse | No | ||||
| data.query | string | No | chatgpt | |||
| data.results | array | No | ||||
| data.results[].domain | string | No | example.com | |||
| data.results[].height | integer | No | 1080 | |||
| data.results[].image_url | string | No | https://example.com/chatgpt.jpg | |||
| data.results[].page_url | string | No | https://example.com/article | |||
| data.results[].position | integer | No | 1 | |||
| data.results[].thumbnail_url | string | No | ||||
| data.results[].title | string | No | ChatGPT logo | |||
| data.results[].width | integer | No | 1920 | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/yahoo-search/images?q=chatgpt" \
-H "x-api-key: $CRAWLORA_API_KEY"