TimesLIVE API Documentation

First request

Endpoint

GET /timeslive/sections

Cost

1 credit/request

curl "https://api.crawlora.net/api/v1/timeslive/sections" \
  -H "x-api-key: $CRAWLORA_API_KEY"

How to use TimesLIVE endpoints

TimesLIVE is South African reporting across 23 editorial desks, including national, regional, business, sport, and opinion coverage. A live /timeslive/sections response on 2026-10-14 contained 23 section records; refresh it before scheduling because publisher feeds change. Choose a verified editorial slug from the section list and retain it with each headline pull. Arc feeds support offset paging upstream, but the public API only accepts a section, so use repeated calls only where the API documentation permits and do not represent them as page-controlled. Podcasts are a separate product. Article text comes from public page paragraphs and premium/free markers are preserved when supplied. An absent marker is not proof that a story is subscriber-free; no author endpoint is available. Use the endpoint cards for this integration's accepted inputs.

1. Step 1

   Choose a verified editorial desk

   A live /timeslive/sections response on 2026-10-14 contained 23 section records; refresh it before scheduling because publisher feeds change. Choose a verified editorial slug from the section list and retain it with each headline pull. Arc feeds support offset paging upstream, but the public API only accepts a section, so use repeated calls only where the API documentation permits and do not represent them as page-controlled. Podcasts are a separate product.

2. Step 2

   Keep premium and free markers with timestamps

   The 23 editorial desks can focus a headline pull, but upstream offset support does not create a Crawlora page parameter. Keep premium/free markers and publication timestamps when returned; absence of a premium marker is not evidence of open access.

3. Step 3

   Retain the desk with each headline pull

   The 23 editorial desks can focus a headline pull, but upstream offset support does not create a Crawlora page parameter. Keep premium/free markers and publication timestamps when returned; absence of a premium marker is not evidence of open access. Pass only a value returned by /timeslive/sections and accepted by /timeslive/headlines; preserve the selected desk with its results.

4. Step 4

   Read premium markers, not their absence

   Article text comes from public page paragraphs and premium/free markers are preserved when supplied. An absent marker is not proof that a story is subscriber-free; no author endpoint is available. Keep teaser, truncation, premium, or access fields beside the canonical URL so downstream users can see what the publisher actually returned.

Other Media & Streaming APIs