GET/iol/articleapiKey2 credits/request
Returns an IOL article by `url`, a canonical `iol.co.za` story link. The response has the title, description, section (the deepest in the breadcrumb, such as `Crime and Courts`), authors, lead image, publish and update times, and body `paragraphs`. Section, author, tag and search pages are rejected. `paywalled` is never set.
Required: url.
Sampled 14 Oct 2026: 9 fields returned with a value. In the sample: published_at: 2026-09-24; section: “Crime and Courts”; url: iol.co.za; title: 90 characters; authors: 1 entry; description: 175 characters; updated_at: 2026-09-24; image_url: iol-prod.appspot.com.
Open in Playground
GET/iol/authorapiKey2 credits/request
Returns an IOL author profile, identified by `slug` (such as `xolile-mtembu`) or a canonical `iol.co.za/authors/<slug>/` `url`; provide exactly one. The response has the name, `role` and `image_url` when present, and up to 25 recent articles with title, URL, summary, section and a `published_date` taken from the article URL. Unknown authors return not found.
Optional: slug, url.
Sampled 14 Oct 2026: 25 items. Filled in every item: title, url, summary, section, published_date. In the sample: published_date: 2026-10-05 to 2026-10-13; url: iol.co.za; title: median 77 characters; summary: median 193 characters.
Open in Playground
GET/iol/headlinesapiKey1 credit/request
Returns recent IOL headlines for one section path. `section` is required and takes a value such as `news`, `news/south-africa/gauteng`, `sport/rugby/springboks`, `business/economy` or `entertainment/music`. Each item has its title, URL, summary, publication time and image, plus the author when the outlet names one. Unlisted values are rejected.
Required: section (123 allowed values, including news, news/africa, news/brics, news/crime-and-courts, news/education, news/energy, news/environment, news/feel-good, news/opinion, news/partnered, news/politics, news/politics/opinion, news/south-africa, news/south-africa/eastern-cape, news/south-africa/free-state, news/south-africa/gauteng, news/south-africa/kwazulu-natal, news/south-africa/limpopo, news/south-africa/mpumalanga, news/south-africa/north-west, news/south-africa/northern-cape, news/south-africa/western-cape, news/world, sport, sport/athletics, sport/betting, sport/boxing, sport/cricket, sport/cricket/domestic, sport/cricket/international, sport/cricket/proteas, sport/cricket/proteas-women, sport/golf, sport/horse-racing, sport/mma, sport/opinion, sport/rugby, sport/rugby/imbokodo, sport/rugby/international, sport/rugby/springboks).
Sampled 14 Oct 2026: 30 items. Filled in every item: title, url, summary, published_at, image_url. Not in every item: author (19). In the sample: published_at: 2026-10-12 to 2026-10-13; url: iol.co.za; title: median 77 characters; summary: median 186 characters; image_url: iol-prod.appspot.com.
Open in Playground
GET/iol/newsapiKey1 credit/request
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.
Takes no parameters.
Sampled 14 Oct 2026: 30 items. Filled in every item: title, url, summary, published_at, image_url. Not in every item: author (13). In the sample: published_at: 2026-10-13; url: iol.co.za; title: median 77 characters; summary: median 187 characters; image_url: iol-prod.appspot.com.
Open in Playground
GET/iol/sectionsapiKey1 credit/request
Returns the verified IOL section inventory accepted by the headlines endpoint: news, sport, business, lifestyle, entertainment, technology, motoring, travel and opinion, their sub-sections, provincial news and the sister-title feeds.
Takes no parameters.
Sampled 14 Oct 2026: 123 items. Filled in every item: slug, name, url. In the sample: name: “News” and 122 other values; url: iol.co.za.
Open in Playground
IOL API endpoints