Docs menu

ForeignPolicy API endpoint

Foreign Policy article content API

Returns a public Foreign Policy article's metadata and full body paragraphs from a canonical article URL. is_gated reports the site's own content-tier marker; the full body is always returned regardless, since Foreign Policy serves it in full to anonymous requests either way.

GETapiKey2 credits/requestForeignPolicyforeignpolicy.articleResponseDoc/foreignpolicy/article

Endpoint facts

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

Foreign Policy API Try Foreign Policy article content API in Playground ForeignPolicy API documentation

How this endpoint behaves

Query parameter: required url, a canonical https://foreignpolicy.com/YYYY/MM/DD/slug/ article URL.

Live monitoring

Monitored request: GET /foreignpolicy/article?url=https%3A%2F%2Fforeignpolicy.com%2F2026%2F04%2F15%2Fchina-ports-maritime-power%2F
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.56 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /foreignpolicy/article?url=https%3A%2F%2Fforeignpolicy.com%2F2026%2F04%2F15%2Fchina-ports-maritime-power%2F
Fields returned with a value: 8

Field	In the sample	Value in the sample
url	Has a value	foreignpolicy.com
title	Has a value	39 characters
published_at	Has a value	2026-04-15
updated_at	Has a value	2026-05-29
section	Has a value	“Deep Dive”
authors	Has a value	2 entries
is_gated	Has a value	true
paragraphs	Has a value	26 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
url	string	Yes		Canonical foreignpolicy.com article URL	https://foreignpolicy.com/2026/04/15/china-ports-maritime-power/
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/foreignpolicy/article?url=https%3A%2F%2Fforeignpolicy.com%2F2026%2F04%2F15%2Fchina-ports-maritime-power%2F" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "data": {
    "url": "https://foreignpolicy.com/2026/04/15/china-ports-maritime-power/",
    "title": "China's Port Buy-Up Strategy",
    "description": "Beijing is less focused on acquiring sovereign control, more so in assuring its own strategic security.",
    "published_at": "2026-04-15T00:01:53-04:00",
    "updated_at": "2026-05-29T17:40:09-04:00",
    "section": "China",
    "authors": [
      "Alexander Wooley",
      "Lea Thome"
    ],
    "image_url": "https://foreignpolicy.com/wp-content/uploads/2026/04/example.jpg",
    "is_gated": true,
    "paragraphs": [
      "First paragraph of the story.",
      "Second paragraph of the story."
    ]
  },
  "msg": "OK"
}

Request schema

No body schema

Response schema

#/definitions/foreignpolicy.articleResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	foreignpolicy.ArticleResponse	No
data.authors	array	No
data.description	string	No
data.image_url	string	No
data.is_gated	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
msg	string	No	OK

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/foreignpolicy/article?url=https%3A%2F%2Fforeignpolicy.com%2F2026%2F04%2F15%2Fchina-ports-maritime-power%2F" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More ForeignPolicy endpoint docs Foreign Policy API Foreign Policy author profile API documentation Foreign Policy site-wide headlines API documentation Foreign Policy Live conversation API documentation Foreign Policy Live conversations API documentation Foreign Policy project hub API documentation Foreign Policy project directory API documentation

Open in Playground Back to group

Docs menu

ForeignPolicy API endpoint

Foreign Policy article content API

GETapiKey2 credits/requestForeignPolicyforeignpolicy.articleResponseDoc/foreignpolicy/article

Endpoint facts

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

Foreign Policy API Try Foreign Policy article content API in Playground ForeignPolicy API documentation

How this endpoint behaves

Query parameter: required url, a canonical https://foreignpolicy.com/YYYY/MM/DD/slug/ article URL.

Live monitoring

Monitored request: GET /foreignpolicy/article?url=https%3A%2F%2Fforeignpolicy.com%2F2026%2F04%2F15%2Fchina-ports-maritime-power%2F
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.56 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /foreignpolicy/article?url=https%3A%2F%2Fforeignpolicy.com%2F2026%2F04%2F15%2Fchina-ports-maritime-power%2F
Fields returned with a value: 8

Field	In the sample	Value in the sample
url	Has a value	foreignpolicy.com
title	Has a value	39 characters
published_at	Has a value	2026-04-15
updated_at	Has a value	2026-05-29
section	Has a value	“Deep Dive”
authors	Has a value	2 entries
is_gated	Has a value	true
paragraphs	Has a value	26 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
url	string	Yes		Canonical foreignpolicy.com article URL	https://foreignpolicy.com/2026/04/15/china-ports-maritime-power/
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/foreignpolicy/article?url=https%3A%2F%2Fforeignpolicy.com%2F2026%2F04%2F15%2Fchina-ports-maritime-power%2F" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "data": {
    "url": "https://foreignpolicy.com/2026/04/15/china-ports-maritime-power/",
    "title": "China's Port Buy-Up Strategy",
    "description": "Beijing is less focused on acquiring sovereign control, more so in assuring its own strategic security.",
    "published_at": "2026-04-15T00:01:53-04:00",
    "updated_at": "2026-05-29T17:40:09-04:00",
    "section": "China",
    "authors": [
      "Alexander Wooley",
      "Lea Thome"
    ],
    "image_url": "https://foreignpolicy.com/wp-content/uploads/2026/04/example.jpg",
    "is_gated": true,
    "paragraphs": [
      "First paragraph of the story.",
      "Second paragraph of the story."
    ]
  },
  "msg": "OK"
}

Request schema

No body schema

Response schema

#/definitions/foreignpolicy.articleResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	foreignpolicy.ArticleResponse	No
data.authors	array	No
data.description	string	No
data.image_url	string	No
data.is_gated	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
msg	string	No	OK

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/foreignpolicy/article?url=https%3A%2F%2Fforeignpolicy.com%2F2026%2F04%2F15%2Fchina-ports-maritime-power%2F" \
  -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

Foreign Policy article content API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Foreign Policy article content API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related