New York Times API endpoint
Returns a New York Times section RSS feed: each story's title, canonical URL, description, author, publication time, and lead image. Section must be a slug returned by /nyt/sections.
/nyt/headlinesQuery parameter: required section, a section slug. Discover the full accepted set from /nyt/sections; examples include HomePage, World, US, Business, Technology, Opinion. An unknown section returns 400.
Returns one NYT section feed: each story's title, canonical url, description, author, published_at, and lead image_url.
| Field | Filled in, of 51 checked | Values in the sample |
|---|---|---|
| title | 51 | median 63 characters |
| url | 51 | nytimes.com |
| description | 51 | median 113 characters |
| author | 51 | |
| published_at | 51 | “Tue, 13 Oct 2026 13:17:24 +0000” and 50 other values |
| image_url | 47 | static01.nyt.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | Section slug from /nyt/sections | World | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/nyt/headlines?section=World" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"section": "World",
"items": [
{
"title": "A Diplomat From Myanmar Refuses to Give Up New York City Post",
"url": "https://www.nytimes.com/2026/09/20/world/asia/myanmar-mission-un-envoy.html",
"description": "For more than five years, U Kyaw Moe Tun has refused to give up his United Nations post.",
"author": "Verena Hölzl",
"published_at": "Sun, 20 Sep 2026 04:01:07 +0000",
"image_url": "https://static01.nyt.com/images/example.jpg"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/nyt.headlinesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | nyt.HeadlinesResponse | No | ||||
| data.items | array | No | ||||
| data.items[].author | string | No | ||||
| data.items[].description | string | No | ||||
| data.items[].image_url | string | No | ||||
| data.items[].published_at | string | No | ||||
| data.items[].title | string | No | ||||
| data.items[].url | string | No | ||||
| data.section | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/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/nyt/headlines?section=World" \
-H "x-api-key: $CRAWLORA_API_KEY"