Docs menu
The National API endpoint
The National article API
Returns article metadata and the body served to an anonymous visitor for one canonical The National story URL. The endpoint does not bypass subscriber or access gates and reports paywalled when the page marks content as restricted.
GETapiKey2 credits/requestThe Nationalpublicnews.articleResponseDoc
The National/national/articleEndpoint facts
- Method
- GET
- API path
- /national/article
- Auth
- apiKey
- Credits
- 2 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- The National
- Response schema
- #/definitions/publicnews.articleResponseDoc
How this endpoint behaves
Query parameter: url is required and must be a canonical HTTPS story URL on thenationalnews.com with a dated editorial path. URL query strings are ignored when normalizing the article URL.
Returns the article title, author, publication and update times, section, summary, canonical URL, and readable body paragraphs from the response available to an anonymous visitor. The endpoint does not bypass subscriber gates; paywalled reports publisher access markers where present.
Workflow check
Start from the checked request: GET /national/article?url=https%3A%2F%2Fwww.thenationalnews.com%2Ffuture%2Ftechnology%2F2026%2F09%2F29%2Fai-trump-midterm-poll-democrats%2F. Live check on 2026-10-14: one record. Fields present in every checked record: url, title, description, published_at, updated_at, section, authors, image_url.
For a known public contributor profile, continue with Get a The National author profile.
Live monitoring
- Monitored request
- GET /national/article?url=https%3A%2F%2Fwww.thenationalnews.com%2Ffuture%2Ftechnology%2F2026%2F09%2F29%2Fai-trump-midterm-poll-democrats%2F
- Checks passed, 7 days to 14 Oct 2026
- 100%
- Median response time
- 3.12 s
Sampled response
- Request, 14 Oct 2026
- GET /national/article?url=https%3A%2F%2Fwww.thenationalnews.com%2Ffuture%2Ftechnology%2F2026%2F09%2F29%2Fai-trump-midterm-poll-democrats%2F
- Fields returned with a value
- 9
| Field | In the sample | Value in the sample |
|---|---|---|
| url | Has a value | thenationalnews.com |
| title | Has a value | 66 characters |
| description | Has a value | 69 characters |
| published_at | Has a value | 2026-09-29 |
| updated_at | Has a value | 2026-09-30 |
| section | Has a value | “Technology” |
| authors | Has a value | 1 entry |
| image_url | Has a value | thenationalnews.com |
| paragraphs | Has a value | 17 entries |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| url | string | Yes | Canonical thenationalnews.com article URL | https://www.thenationalnews.com/future/technology/2026/09/29/ai-trump-midterm-poll-democrats/ | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/national/article?url=https%3A%2F%2Fwww.thenationalnews.com%2Ffuture%2Ftechnology%2F2026%2F09%2F29%2Fai-trump-midterm-poll-democrats%2F" \ -H "x-api-key: $CRAWLORA_API_KEY"
Illustrative JSON response shape
{
"code": 200,
"data": {
"title": "Example UAE story",
"url": "https://www.thenationalnews.com/news/uae/2026/09/30/example-story/",
"authors": [
"The National"
],
"section": "News",
"paragraphs": [
"The first public paragraph."
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.articleResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.ArticleResponse | No | ||||
| data.authors | array | No | ||||
| data.description | string | No | ||||
| data.image_url | string | No | ||||
| data.paragraphs | array | No | ||||
| data.paywalled | boolean | No | Paywalled is true when the publisher serves only a teaser of this article to anonymous readers, so Paragraphs is a partial body rather than the full text. It is omitted when the full public body was returned. | |||
| 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 |
| 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/national/article?url=https%3A%2F%2Fwww.thenationalnews.com%2Ffuture%2Ftechnology%2F2026%2F09%2F29%2Fai-trump-midterm-poll-democrats%2F" \
-H "x-api-key: $CRAWLORA_API_KEY"