Yahoo News API endpoint
Returns a page of articles Yahoo recommends alongside a given article -- the "you may also like" strip at the bottom of an article page -- with cursor-based pagination. Sourced from Yahoo's own recommendation gateway.
/yahoo-news/relatedReturns a page of articles Yahoo recommends alongside a given article -- the "you may also like" strip at the bottom of an article page. Sourced from Yahoo's own recommendation gateway, not from the article page itself (this strip is loaded on demand and never appears in the article page's HTML).
Query parameters:
content_id (required) -- the article id, i.e. the id field returned
by /yahoo-news/home, /yahoo-news/category, or /yahoo-news/article.cursor (optional) -- pagination cursor, taken from a previous
response's next_cursor. Omit for the first page.count (optional) -- number of related articles to return, default 10,
clamped to 1-50.Notable response behavior:
/yahoo-news/home and
/yahoo-news/category: id, title, url, summary, published_at,
source, source_url, category, comment_count, thumbnail_url,
and sized images.has_next_page/next_cursor drive pagination: pass next_cursor back
as cursor to fetch the next page. next_cursor is omitted once
has_next_page is false.content_id must look like a Yahoo News article id (a UUID); a
malformed value returns 400 before any upstream request is made. A
well-formed but nonexistent id still returns a successful page of
generic recommendations rather than an error -- this matches Yahoo's
own upstream behavior.| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| id | 10 | |
| title | 10 | median 74 characters |
| url | 10 | yahoo.com and 1 other host |
| summary | 10 | median 133 characters |
| published_at | 10 | 2026-10-10 to 2026-10-13 |
| source | 10 | “Good Morning America” and 8 other values |
| source_url | 10 | goodmorningamerica.com and 8 other hosts |
| comment_count | 10 | 0 to 1,734, median 205 |
| thumbnail_url | 10 | media.zenfs.com |
| images | 10 | median 1 entry |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| content_id | string | Yes | Article id (the id field returned by home/category/article) | 6463c2b7-dfa6-3313-9e0d-a0b1cb5e6506 | |
| cursor | string | No | Pagination cursor from a previous response's next_cursor | ||
| count | integer | No | Number of related articles to return, default 10, clamped to 1..50 | 10 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/yahoo-news/related?content_id=6463c2b7-dfa6-3313-9e0d-a0b1cb5e6506&count=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"content_id": "6463c2b7-dfa6-3313-9e0d-a0b1cb5e6506",
"items": [
{
"id": "71fc77ef-f02d-3e6c-9114-20d641f0381a",
"title": "Trump Humiliated as U.N. Speech Bombs With Bored Audience",
"url": "https://www.yahoo.com/news/politics/articles/trump-humiliated-u-n-speech-172143586.html",
"summary": "It was meant to be one of the most important foreign policy speeches of his presidency...",
"published_at": "2026-09-22T17:21:43Z",
"source": "The Daily Beast",
"source_url": "http://www.thedailybeast.com",
"category": "Politics",
"comment_count": 2740,
"thumbnail_url": "https://media.zenfs.com/en/thedailybeast.com/3e2809417604599d922d5f497c8f105d.jpg",
"images": [
{
"url": "https://s.yimg.com/lo/mysterio/api/938d190fbcf674d41f8459f113f8d74dfac0c600806b468a8609a77b49da3c06/lightyear_networkapi/smartcrop_w296_h296_faces%3Bquality_85%3Bformat_webp/https%3A%2F%2Fmedia.zenfs.com%2Fen%2Fthedailybeast.com%2F3e2809417604599d922d5f497c8f105d.jpg",
"width": 296,
"height": 296
}
]
}
],
"has_next_page": true,
"next_cursor": "eyJyZWdpb24iOiJhc2lhLXNvdXRoZWFzdDEiLCJzZXNzaW9uX2lkIjoiYjVjM2YxMjdmYWE5NDYzYWFjMTA5ZDliMTU2YmIxN2MiLCJwYWdlX2luZGV4IjoxMCwibmFtZXNwYWNlIjoicmVjaXJjIn0="
}
}Request schema
No body schema
Response schema
#/definitions/yahoonews.relatedResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | yahoonews.RelatedResponse | No | ||||
| data.content_id | string | No | ||||
| data.has_next_page | boolean | No | ||||
| data.items | array | No | StreamItem record, 15 fields: authors, category, comment_count, id, images, published_at, source, source_url, summary, thumbnail_url, title, url. Described under Yahoo News Home API. | |||
| data.next_cursor | string | No | ||||
| 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-news/related?content_id=6463c2b7-dfa6-3313-9e0d-a0b1cb5e6506&count=10" \
-H "x-api-key: $CRAWLORA_API_KEY"