Docs menu
IOL API endpoint
IOL top stories API
Returns the 30 newest stories from IOL (Independent Online, South Africa), with no parameters. Each item has its title, canonical article URL, short summary, publication time, author byline and lead image.
GETapiKey1 credit/requestIOLpublicnews.newsResponseDoc
IOL/iol/newsEndpoint facts
- Method
- GET
- API path
- /iol/news
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- IOL
- Response schema
- #/definitions/publicnews.newsResponseDoc
How this endpoint behaves
Returns the latest public stories from IOL (Independent Online, South Africa's largest news site): title, canonical article URL, a short summary, publication time, author byline, and lead image. The feed covers the newest news stories (30 items).
Example response (truncated):
{"code":200,"data":{"items":[{"title":"Limpopo businessman Howard Mashaba sentenced for intimidation and protection-order breach","url":"https://iol.co.za/news/south-africa/limpopo/2026-09-24-limpopo-businessman-howard-mashaba-sentenced-for-intimidation-and-protection-order-breach","summary":"A Limpopo businessman was fined R25,000 and handed suspended prison terms after being convicted of intimidation and contravening a protection order.","published_at":"2026-09-24T13:57:00Z","author":"Zainul Dawood","image_url":"https://iol-prod.appspot.com/image/7c037788de044f7087b92d14a582faaf66c5f6c4"}]}}
Sampled response
- Request, 14 Oct 2026
- GET /iol/news
- Items in items
- 30
- Fields filled in every checked item
- 5
- Fields empty in some or all items
- 1
| Field | Filled in, of 30 checked | Values in the sample |
|---|---|---|
| title | 30 | median 77 characters |
| url | 30 | iol.co.za |
| summary | 30 | median 187 characters |
| published_at | 30 | 2026-10-13 |
| author | 13 | |
| image_url | 30 | iol-prod.appspot.com |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/iol/news" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"items": [
{
"title": "Limpopo businessman Howard Mashaba sentenced for intimidation and protection-order breach",
"url": "https://iol.co.za/news/south-africa/limpopo/2026-09-24-limpopo-businessman-howard-mashaba-sentenced-for-intimidation-and-protection-order-breach",
"summary": "A Limpopo businessman was fined R25,000 and handed suspended prison terms after being convicted of intimidation and contravening a protection order.",
"published_at": "2026-09-24T13:57:00Z",
"author": "Zainul Dawood",
"image_url": "https://iol-prod.appspot.com/image/7c037788de044f7087b92d14a582faaf66c5f6c4"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.newsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.NewsResponse | No | ||||
| data.items | array | No | ||||
| data.items[].author | string | 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[].type | string | No | ||||
| data.items[].url | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 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/iol/news" \
-H "x-api-key: $CRAWLORA_API_KEY"