Docs menu

The New Yorker API endpoint

The New Yorker contributor profile API

Returns a The New Yorker contributor's name, photo, biography, external profile links, and the first page of their recent articles from a canonical contributor URL.

GETapiKey2 credits/requestThe New Yorkerpublicnews.newyorkerAuthorResponseDoc/newyorker/author

Endpoint facts

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

The New Yorker Scraper API Try The New Yorker contributor profile API in Playground The New Yorker API documentation

How this endpoint behaves

Query parameters:

url (required): a canonical https://www.newyorker.com/contributors/<slug> URL.

biography, image_url, and links reflect whatever the contributor's page carries. Each link's type is derived from its host and is one of twitter, instagram, facebook, linkedin, threads, bluesky, tiktok, youtube, or website. Each article's published_at is the page's date-only value (YYYY-MM-DD), and type is the department label. Only the first page of articles is returned. Returns 404 for an unknown contributor.

Example response (truncated):

{"code":200,"data":{"url":"https://www.newyorker.com/contributors/casey-cep","name":"Casey Cep","image_url":"https://media.newyorker.com/photos/example/1:1/w_1159,h_1159,c_limit/example.png","biography":["Casey Cep is a staff writer at The New Yorker."],"links":[{"type":"twitter","url":"https://www.twitter.com/example"}],"articles":[{"title":"Example article","url":"https://www.newyorker.com/magazine/2026/09/28/example-article","type":"Profiles","published_at":"2026-09-21","author":"Casey Cep"}]}}

Sampled response

Request, 14 Oct 2026: GET /newyorker/author?url=https%3A%2F%2Fwww.newyorker.com%2Fcontributors%2Fcasey-cep
Items in articles: 20
Fields filled in every checked item: 7

Field	Filled in, of 20 checked	Values in the sample
title	20	median 42 characters
url	20	newyorker.com
type	20
summary	20	median 115 characters
published_at	20	2024-06-24 to 2026-09-30
author	20
image_url	20	media.newyorker.com

Request parameters

Parameter	Type	Required	Default	Description	Example
url	string	Yes		Canonical The New Yorker contributor URL	https://www.newyorker.com/contributors/casey-cep
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/newyorker/author?url=https%3A%2F%2Fwww.newyorker.com%2Fcontributors%2Fcasey-cep" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "data": {
    "url": "https://www.newyorker.com/contributors/casey-cep",
    "name": "Casey Cep",
    "image_url": "https://media.newyorker.com/photos/example/1:1/w_1159,h_1159,c_limit/example.png",
    "biography": [
      "Casey Cep is a staff writer at The New Yorker."
    ],
    "links": [
      {
        "type": "twitter",
        "url": "https://www.twitter.com/example"
      }
    ],
    "articles": [
      {
        "title": "Example article",
        "url": "https://www.newyorker.com/magazine/2026/09/28/example-article",
        "type": "Profiles",
        "published_at": "2026-09-21",
        "author": "Casey Cep"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/publicnews.newyorkerAuthorResponseDoc

Field	Type	Required
data	newyorker.AuthorResponse	No
data.articles	array	No
data.articles[].author	string	No
data.articles[].image_url	string	No
data.articles[].published_at	string	No
data.articles[].summary	string	No
data.articles[].title	string	No
data.articles[].type	string	No
data.articles[].url	string	No
data.biography	array	No
data.image_url	string	No
data.links	array	No
data.links[].type	string	No
data.links[].url	string	No
data.name	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/author?url=https%3A%2F%2Fwww.newyorker.com%2Fcontributors%2Fcasey-cep" \
  -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 article 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 contributor profile API

Returns a The New Yorker contributor's name, photo, biography, external profile links, and the first page of their recent articles from a canonical contributor URL.

GETapiKey2 credits/requestThe New Yorkerpublicnews.newyorkerAuthorResponseDoc/newyorker/author

Endpoint facts

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

The New Yorker Scraper API Try The New Yorker contributor profile API in Playground The New Yorker API documentation

How this endpoint behaves

Query parameters:

url (required): a canonical https://www.newyorker.com/contributors/<slug> URL.

Example response (truncated):

{"code":200,"data":{"url":"https://www.newyorker.com/contributors/casey-cep","name":"Casey Cep","image_url":"https://media.newyorker.com/photos/example/1:1/w_1159,h_1159,c_limit/example.png","biography":["Casey Cep is a staff writer at The New Yorker."],"links":[{"type":"twitter","url":"https://www.twitter.com/example"}],"articles":[{"title":"Example article","url":"https://www.newyorker.com/magazine/2026/09/28/example-article","type":"Profiles","published_at":"2026-09-21","author":"Casey Cep"}]}}

Sampled response

Request, 14 Oct 2026: GET /newyorker/author?url=https%3A%2F%2Fwww.newyorker.com%2Fcontributors%2Fcasey-cep
Items in articles: 20
Fields filled in every checked item: 7

Field	Filled in, of 20 checked	Values in the sample
title	20	median 42 characters
url	20	newyorker.com
type	20
summary	20	median 115 characters
published_at	20	2024-06-24 to 2026-09-30
author	20
image_url	20	media.newyorker.com

Request parameters

Parameter	Type	Required	Default	Description	Example
url	string	Yes		Canonical The New Yorker contributor URL	https://www.newyorker.com/contributors/casey-cep
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/newyorker/author?url=https%3A%2F%2Fwww.newyorker.com%2Fcontributors%2Fcasey-cep" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "data": {
    "url": "https://www.newyorker.com/contributors/casey-cep",
    "name": "Casey Cep",
    "image_url": "https://media.newyorker.com/photos/example/1:1/w_1159,h_1159,c_limit/example.png",
    "biography": [
      "Casey Cep is a staff writer at The New Yorker."
    ],
    "links": [
      {
        "type": "twitter",
        "url": "https://www.twitter.com/example"
      }
    ],
    "articles": [
      {
        "title": "Example article",
        "url": "https://www.newyorker.com/magazine/2026/09/28/example-article",
        "type": "Profiles",
        "published_at": "2026-09-21",
        "author": "Casey Cep"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/publicnews.newyorkerAuthorResponseDoc

Field	Type	Required
data	newyorker.AuthorResponse	No
data.articles	array	No
data.articles[].author	string	No
data.articles[].image_url	string	No
data.articles[].published_at	string	No
data.articles[].summary	string	No
data.articles[].title	string	No
data.articles[].type	string	No
data.articles[].url	string	No
data.biography	array	No
data.image_url	string	No
data.links	array	No
data.links[].type	string	No
data.links[].url	string	No
data.name	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/author?url=https%3A%2F%2Fwww.newyorker.com%2Fcontributors%2Fcasey-cep" \
  -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 contributor profile 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 contributor profile API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related