Docs menu

The Atlantic API endpoint

The Atlantic article content API

Returns one public Atlantic article's metadata and body paragraphs from a canonical article URL. `metered` reflects the site's own soft-paywall flag for that article; the body returned here is the same one the site's own page serves to an anonymous visitor and is never truncated because of it. An article whose page genuinely withholds its body is reported as a restricted-access error instead of a hollow response.

GETapiKey2 credits/requestThe Atlantictheatlantic.articleResponseDoc/theatlantic/article

Endpoint facts

Method: GET
API path: /theatlantic/article
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: The Atlantic
Response schema: #/definitions/theatlantic.articleResponseDoc

The Atlantic API Try The Atlantic article content API in Playground The Atlantic API documentation

How this endpoint behaves

Query parameter: required url, a canonical Atlantic article URL (e.g. https://www.theatlantic.com/politics/2026/09/example-slug/688738/). Query strings and fragments are stripped; the URL is canonicalized to https://www.theatlantic.com.

Returns one public Atlantic article's metadata — title, description, published_at, updated_at, section, authors, image_url, tags — plus its body paragraphs in order and metered, the site's own soft-paywall flag for that article.

Behavior:

metered reflects whether the site treats the article as premium for a repeat reader (its Zephr meter). The body returned here is the same body the site's own page serves to an anonymous visitor and is never truncated because metered is true.
An article whose page genuinely carries no body content is reported as 403 (restricted) rather than a hollow success when the upstream also marked it metered, and as 503 otherwise (parser drift).
Non-article URLs and non-Atlantic hosts return 400 before any upstream request.

Sampled response

Request, 14 Oct 2026: GET /theatlantic/article?url=https%3A%2F%2Fwww.theatlantic.com%2Fpolitics%2F2026%2F09%2Faustin-ice-shooting-body-camera%2F688738%2F
Fields returned with a value: 11

Field	In the sample	Value in the sample
url	Has a value	theatlantic.com
title	Has a value	51 characters
description	Has a value	102 characters
published_at	Has a value	2026-09-22
updated_at	Has a value	2026-09-22
section	Has a value	“Politics”
authors	Has a value	1 entry
image_url	Has a value	cdn.theatlantic.com
tags	Has a value	6 entries
metered	Has a value	true
paragraphs	Has a value	13 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
url	string	Yes		Canonical The Atlantic article URL	https://www.theatlantic.com/politics/2026/09/example-slug/688738/
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/theatlantic/article?url=https%3A%2F%2Fwww.theatlantic.com%2Fpolitics%2F2026%2F09%2Fexample-slug%2F688738%2F" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "url": "https://www.theatlantic.com/politics/2026/09/example-slug/688738/",
    "title": "Example Article Title",
    "description": "An example subtitle for the article.",
    "published_at": "2026-09-22T16:29:21Z",
    "updated_at": "2026-09-22T17:12:16Z",
    "section": "Politics",
    "authors": [
      "Jane Example"
    ],
    "image_url": "https://cdn.theatlantic.com/img/lead.jpg",
    "tags": [
      "Example Tag"
    ],
    "metered": true,
    "paragraphs": [
      "First paragraph of the article.",
      "Second paragraph of the article."
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/theatlantic.articleResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	theatlantic.ArticleResponse	No
data.authors	array	No
data.description	string	No
data.image_url	string	No
data.metered	boolean	No
data.paragraphs	array	No
data.published_at	string	No
data.section	string	No
data.tags	array	No
data.title	string	No
data.updated_at	string	No
data.url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
403	Forbidden	#/definitions/app.Response
404	Not Found	#/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/theatlantic/article?url=https%3A%2F%2Fwww.theatlantic.com%2Fpolitics%2F2026%2F09%2Fexample-slug%2F688738%2F" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More The Atlantic endpoint docs The Atlantic API The Atlantic author API documentation The Atlantic headlines API documentation The Atlantic sections API documentation

Open in Playground Back to group

Docs menu

The Atlantic API endpoint

The Atlantic article content API

GETapiKey2 credits/requestThe Atlantictheatlantic.articleResponseDoc/theatlantic/article

Endpoint facts

Method: GET
API path: /theatlantic/article
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: The Atlantic
Response schema: #/definitions/theatlantic.articleResponseDoc

The Atlantic API Try The Atlantic article content API in Playground The Atlantic API documentation

How this endpoint behaves

Behavior:

metered reflects whether the site treats the article as premium for a repeat reader (its Zephr meter). The body returned here is the same body the site's own page serves to an anonymous visitor and is never truncated because metered is true.
An article whose page genuinely carries no body content is reported as 403 (restricted) rather than a hollow success when the upstream also marked it metered, and as 503 otherwise (parser drift).
Non-article URLs and non-Atlantic hosts return 400 before any upstream request.

Sampled response

Request, 14 Oct 2026: GET /theatlantic/article?url=https%3A%2F%2Fwww.theatlantic.com%2Fpolitics%2F2026%2F09%2Faustin-ice-shooting-body-camera%2F688738%2F
Fields returned with a value: 11

Field	In the sample	Value in the sample
url	Has a value	theatlantic.com
title	Has a value	51 characters
description	Has a value	102 characters
published_at	Has a value	2026-09-22
updated_at	Has a value	2026-09-22
section	Has a value	“Politics”
authors	Has a value	1 entry
image_url	Has a value	cdn.theatlantic.com
tags	Has a value	6 entries
metered	Has a value	true
paragraphs	Has a value	13 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
url	string	Yes		Canonical The Atlantic article URL	https://www.theatlantic.com/politics/2026/09/example-slug/688738/
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/theatlantic/article?url=https%3A%2F%2Fwww.theatlantic.com%2Fpolitics%2F2026%2F09%2Fexample-slug%2F688738%2F" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "url": "https://www.theatlantic.com/politics/2026/09/example-slug/688738/",
    "title": "Example Article Title",
    "description": "An example subtitle for the article.",
    "published_at": "2026-09-22T16:29:21Z",
    "updated_at": "2026-09-22T17:12:16Z",
    "section": "Politics",
    "authors": [
      "Jane Example"
    ],
    "image_url": "https://cdn.theatlantic.com/img/lead.jpg",
    "tags": [
      "Example Tag"
    ],
    "metered": true,
    "paragraphs": [
      "First paragraph of the article.",
      "Second paragraph of the article."
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/theatlantic.articleResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	theatlantic.ArticleResponse	No
data.authors	array	No
data.description	string	No
data.image_url	string	No
data.metered	boolean	No
data.paragraphs	array	No
data.published_at	string	No
data.section	string	No
data.tags	array	No
data.title	string	No
data.updated_at	string	No
data.url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
403	Forbidden	#/definitions/app.Response
404	Not Found	#/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/theatlantic/article?url=https%3A%2F%2Fwww.theatlantic.com%2Fpolitics%2F2026%2F09%2Fexample-slug%2F688738%2F" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More The Atlantic endpoint docs The Atlantic API The Atlantic author API documentation The Atlantic headlines API documentation The Atlantic sections API documentation

Open in Playground Back to group

The Atlantic article content API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

The Atlantic article content API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related