The Atlantic API endpoint
Returns the current front-page article cards for one Atlantic section: each story's title, canonical URL, description, byline, publication time, and lead image. Section must be a slug returned by /theatlantic/sections.
/theatlantic/headlinesQuery parameter: required section, a slug from /theatlantic/sections. Values: ideas, politics, economy, international, national-security, technology, science, health, education, culture, family, books, photography.
| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| title | 10 | median 34 characters |
| url | 10 | theatlantic.com |
| description | 10 | median 70 characters |
| author | 10 | |
| published_at | 10 | 2026-10-02 to 2026-10-12 |
| image_url | 10 | cdn.theatlantic.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | Section slug from /theatlantic/sections Allowed values: ideas, politics, economy, international, national-security, technology, science, health, education, culture, family, books, photography. | politics | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/theatlantic/headlines?section=politics" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"section": "politics",
"items": [
{
"title": "Example Headline",
"url": "https://www.theatlantic.com/politics/2026/09/example-headline/688738/",
"description": "An example teaser sentence.",
"author": "Jane Example",
"published_at": "2026-09-22T16:29:21Z",
"image_url": "https://cdn.theatlantic.com/img/wide1.jpg"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/theatlantic.headlinesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | theatlantic.HeadlinesResponse | No | ||||
| data.items | array | No | HeadlineItem record, 6 fields: author, description, image_url, published_at, title, url. Described under The Atlantic author API. | |||
| 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/theatlantic/headlines?section=politics" \
-H "x-api-key: $CRAWLORA_API_KEY"