Docs menu

The New Yorker API endpoint

The New Yorker article API

Returns public The New Yorker article metadata and body paragraphs from a canonical article URL. The New Yorker uses a metered paywall: when a page marks itself as gated, only the publicly served text is returned and is_truncated is true; is_accessible_for_free reports the page's own access flag.

GETapiKey2 credits/requestThe New Yorkerpublicnews.newyorkerArticleResponseDoc/newyorker/article

Endpoint facts

Method: GET
API path: /newyorker/article
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: The New Yorker
Response schema: #/definitions/publicnews.newyorkerArticleResponseDoc

The New Yorker Scraper API Try The New Yorker article API in Playground The New Yorker API documentation

How this endpoint behaves

Query parameter: url is a canonical HTTPS newyorker.com article URL, either /<channel>/<department>/<slug> (channels news, culture, humor, books, tech, science, business, sports) or /magazine/YYYY/MM/DD/<slug>. Cartoon, podcast, video, gallery, and puzzle URLs are rejected as invalid params. Query strings are ignored.

Returns public metadata (title, description, publication and update time, section, authors, lead image) and the body paragraphs.

Paywall behavior: The New Yorker meters articles behind a paywall.

is_accessible_for_free mirrors the page's own free-access flag.
is_truncated is true when the page marks itself as gated. In that case paragraphs holds only the text the page publicly serves and must not be treated as the complete story.
When is_truncated is false, paragraphs is the full body the page served.

Sampled response

Request, 14 Oct 2026: GET /newyorker/article?url=https%3A%2F%2Fwww.newyorker.com%2Fnews%2Fthe-lede%2Fwhat-chinas-vibe-coding-capital-can-tell-us-about-the-ai-boom
Fields returned with a value: 11

Field	In the sample	Value in the sample
url	Has a value	newyorker.com
title	Has a value	64 characters
description	Has a value	160 characters
published_at	Has a value	2026-09-23
updated_at	Has a value	2026-09-23
section	Has a value	“the lede”
authors	Has a value	1 entry
image_url	Has a value	media.newyorker.com
is_accessible_for_free	Has a value	true
is_truncated	Has a value	false
paragraphs	Has a value	25 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
url	string	Yes		Canonical The New Yorker article URL	https://www.newyorker.com/news/the-lede/example-article-slug
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/newyorker/article?url=https%3A%2F%2Fwww.newyorker.com%2Fnews%2Fthe-lede%2Fexample-article-slug" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "data": {
    "url": "https://www.newyorker.com/news/the-lede/example-article-slug",
    "title": "Example article",
    "published_at": "2026-09-23T18:25:32Z",
    "section": "the lede",
    "authors": [
      "Example Author"
    ],
    "is_accessible_for_free": true,
    "is_truncated": false,
    "paragraphs": [
      "Example public paragraph."
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/publicnews.newyorkerArticleResponseDoc

Field	Type	Required
data	newyorker.ArticleResponse	No
data.authors	array	No
data.description	string	No
data.image_url	string	No
data.is_accessible_for_free	boolean	No
data.is_truncated	boolean	No
data.paragraphs	array	No
data.published_at	string	No
data.section	string	No
data.title	string	No
data.updated_at	string	No
data.url	string	No

Failure responses

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

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/newyorker/article?url=https%3A%2F%2Fwww.newyorker.com%2Fnews%2Fthe-lede%2Fexample-article-slug" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More The New Yorker endpoint docs The New Yorker Scraper API The New Yorker contributor profile API documentation The New Yorker section headlines API documentation The New Yorker top stories API documentation The New Yorker sections API documentation

Open in Playground Back to group

Docs menu

The New Yorker API endpoint

The New Yorker article API

GETapiKey2 credits/requestThe New Yorkerpublicnews.newyorkerArticleResponseDoc/newyorker/article

Endpoint facts

Method: GET
API path: /newyorker/article
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: The New Yorker
Response schema: #/definitions/publicnews.newyorkerArticleResponseDoc

The New Yorker Scraper API Try The New Yorker article API in Playground The New Yorker API documentation

How this endpoint behaves

Returns public metadata (title, description, publication and update time, section, authors, lead image) and the body paragraphs.

Paywall behavior: The New Yorker meters articles behind a paywall.

is_accessible_for_free mirrors the page's own free-access flag.
is_truncated is true when the page marks itself as gated. In that case paragraphs holds only the text the page publicly serves and must not be treated as the complete story.
When is_truncated is false, paragraphs is the full body the page served.

Sampled response

Request, 14 Oct 2026: GET /newyorker/article?url=https%3A%2F%2Fwww.newyorker.com%2Fnews%2Fthe-lede%2Fwhat-chinas-vibe-coding-capital-can-tell-us-about-the-ai-boom
Fields returned with a value: 11

Field	In the sample	Value in the sample
url	Has a value	newyorker.com
title	Has a value	64 characters
description	Has a value	160 characters
published_at	Has a value	2026-09-23
updated_at	Has a value	2026-09-23
section	Has a value	“the lede”
authors	Has a value	1 entry
image_url	Has a value	media.newyorker.com
is_accessible_for_free	Has a value	true
is_truncated	Has a value	false
paragraphs	Has a value	25 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
url	string	Yes		Canonical The New Yorker article URL	https://www.newyorker.com/news/the-lede/example-article-slug
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/newyorker/article?url=https%3A%2F%2Fwww.newyorker.com%2Fnews%2Fthe-lede%2Fexample-article-slug" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "data": {
    "url": "https://www.newyorker.com/news/the-lede/example-article-slug",
    "title": "Example article",
    "published_at": "2026-09-23T18:25:32Z",
    "section": "the lede",
    "authors": [
      "Example Author"
    ],
    "is_accessible_for_free": true,
    "is_truncated": false,
    "paragraphs": [
      "Example public paragraph."
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/publicnews.newyorkerArticleResponseDoc

Field	Type	Required
data	newyorker.ArticleResponse	No
data.authors	array	No
data.description	string	No
data.image_url	string	No
data.is_accessible_for_free	boolean	No
data.is_truncated	boolean	No
data.paragraphs	array	No
data.published_at	string	No
data.section	string	No
data.title	string	No
data.updated_at	string	No
data.url	string	No

Failure responses

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

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/newyorker/article?url=https%3A%2F%2Fwww.newyorker.com%2Fnews%2Fthe-lede%2Fexample-article-slug" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

The New Yorker article API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

The New Yorker article API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related