Docs menu
The New Yorker API endpoint
The New Yorker sections API
Lists every The New Yorker section accepted by the headlines endpoint, with slug, display name, and feed URL. This is the complete set of public text-article feeds the publisher serves; cartoon, podcast, video, and puzzle feeds are not included.
GETapiKey1 credit/requestThe New Yorkerpublicnews.sectionsResponseDoc
The New Yorker/newyorker/sectionsEndpoint facts
- Method
- GET
- API path
- /newyorker/sections
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- The New Yorker
- Response schema
- #/definitions/publicnews.sectionsResponseDoc
How this endpoint behaves
Returns every section accepted by newyorker-headlines, with its slug, display name, and feed URL. The set was checked directly against the live site (2026-09-24) and is the complete list of public text-article feeds The New Yorker serves; every other channel or department candidate has no feed.
Accepted section slugs: everything, news, culture, humor, magazine, business, tech, daily-comment, news-desk, cultural-comment, photo-booth, page-turner, borowitz-report.
Notes:
magazineis the current print issue.everythingis the site-wide firehose.businessandtechcurrently serve the same combined business, science, and tech feed.- Cartoon, podcast, video, puzzle, and gallery feeds are not included because they are not text articles.
Sampled response
- Request, 14 Oct 2026
- GET /newyorker/sections
- Items in sections
- 13
- Fields filled in every checked item
- 3
| Field | Filled in, of 13 checked | Values in the sample |
|---|---|---|
| slug | 13 | |
| name | 13 | “Everything” and 12 other values |
| url | 13 | newyorker.com |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/newyorker/sections" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"sections": [
{
"slug": "everything",
"name": "Everything",
"url": "https://www.newyorker.com/feed/everything"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.sectionsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.SectionsResponse | No | ||||
| data.sections | array | No | ||||
| data.sections[].name | string | No | ||||
| data.sections[].slug | string | No | ||||
| data.sections[].url | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 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/sections" \
-H "x-api-key: $CRAWLORA_API_KEY"