Docs menu
The New Yorker API endpoint
The New Yorker section headlines API
Returns fresh headlines from one public The New Yorker section feed. Section must be one of the slugs returned by the sections endpoint.
GETapiKey1 credit/requestThe New Yorkerpublicnews.headlinesResponseDoc
The New Yorker/newyorker/headlinesEndpoint facts
- Method
- GET
- API path
- /newyorker/headlines
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- The New Yorker
- Response schema
- #/definitions/publicnews.headlinesResponseDoc
How this endpoint behaves
Query parameter: section is required and must be one of everything, news, culture, humor, magazine, business, tech, daily-comment, news-desk, cultural-comment, photo-booth, page-turner, or borowitz-report. Any other value returns an invalid-params error. Use newyorker-sections to list them.
Each item has a title, canonical URL, department label in type, summary, author, publication time, and lead image where the feed provides them. Cartoons, podcasts, videos, and galleries are omitted.
Sampled response
- Request, 14 Oct 2026
- GET /newyorker/headlines?section=news
- Items in items
- 25
- Fields filled in every checked item
- 6
- Fields empty in some or all items
- 1
| Field | Filled in, of 25 checked | Values in the sample |
|---|---|---|
| title | 25 | median 46 characters |
| url | 25 | newyorker.com |
| type | 25 | “News / The Lede” and 13 other values |
| summary | 25 | median 134 characters |
| published_at | 25 | 2026-09-17 to 2026-10-13 |
| author | 23 | |
| image_url | 25 | media.newyorker.com |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | The New Yorker section slug Allowed values: everything, news, culture, humor, magazine, business, tech, daily-comment, news-desk, cultural-comment, photo-booth, page-turner, borowitz-report. | everything | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/newyorker/headlines?section=everything" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"section": "news",
"items": [
{
"title": "Example headline",
"url": "https://www.newyorker.com/news/the-lede/example-article-slug",
"type": "News / The Lede",
"published_at": "2026-09-23T18:25:32Z"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.headlinesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.HeadlinesResponse | No | ||||
| data.items | array | No | HeadlineItem record, 7 fields: author, image_url, published_at, summary, title, type, url. Described under The New Yorker top stories API. | |||
| data.section | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/newyorker/headlines?section=everything" \
-H "x-api-key: $CRAWLORA_API_KEY"