Docs menu
Al Jazeera API endpoint
Al Jazeera section headlines API
Returns the newest public Al Jazeera stories from one section archive page. topic is a section slug; use aljazeera-categories for the current value space.
GETapiKey1 credit/requestAl Jazeeraaljazeera.topicResponseDoc
Al Jazeera/aljazeera/topicEndpoint facts
- Method
- GET
- API path
- /aljazeera/topic
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- Al Jazeera
- Response schema
- #/definitions/aljazeera.topicResponseDoc
How this endpoint behaves
Query parameter: required topic, an Al Jazeera section slug returned by aljazeera-categories, for example news, middle-east, or tag/human-rights.
Returns the newest public text-story cards from that section archive, including title, canonical URL, summary, and lead image when available. Video cards are excluded because the article endpoint supports text stories only. Card metadata is limited to what the archive page itself exposes; publication time is not reliably present on the listing. An unknown or stale section slug returns 400.
Live monitoring
- Monitored request
- GET /aljazeera/topic?topic=news
- Checks passed, 7 days to 14 Oct 2026
- 100%
- Median response time
- 3.15 s
Sampled response
- Request, 14 Oct 2026
- GET /aljazeera/topic?topic=news
- Items in items
- 10
- Fields filled in every checked item
- 4
| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| title | 10 | “Imran Khan’s PTI braces to fight federal takeover of Khyber…” and 9 other values |
| url | 10 | aljazeera.com |
| summary | 10 | median 110 characters |
| image_url | 10 | aljazeera.com |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| topic | string | Yes | Al Jazeera section slug | news | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/aljazeera/topic?topic=news" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"topic": "news",
"items": [
{
"title": "Example Al Jazeera headline",
"url": "https://www.aljazeera.com/news/2026/9/20/example-story",
"summary": "A short story summary.",
"image_url": "https://www.aljazeera.com/wp-content/uploads/2026/09/example.jpg?resize=770%2C513"
}
]
},
"msg": "OK"
}Request schema
No body schema
Response schema
#/definitions/aljazeera.topicResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | aljazeera.TopicResponse | No | ||||
| data.items | array | No | ||||
| data.items[].image_url | string | No | ||||
| data.items[].published_at | string | No | ||||
| data.items[].summary | string | No | ||||
| data.items[].title | string | No | ||||
| data.items[].url | string | No | ||||
| data.topic | 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/aljazeera/topic?topic=news" \
-H "x-api-key: $CRAWLORA_API_KEY"