API Reference
Collect Ghanaian news and entertainment coverage across politics, business, sports, opinions, health, lifestyle, and regional/world stories with documented. 9 endpoints documented below.
curl -X GET "https://api.crawlora.net/api/v1/ghanaweb/sections" \
-H "x-api-key: $CRAWLORA_API_KEY"GhanaWeb is Ghanaian news and entertainment coverage across politics, business, sports, opinions, health, lifestyle, and regional/world stories. A live /ghanaweb/sections response on 2026-10-14 contained 15 section records; refresh it before scheduling because publisher feeds change. Use the returned section list to select article-bearing desks; Education and Religion were omitted after they failed to produce story cards. For historical coverage, discover month values through archive/months, then request YYYYMM with page and limit. Video sections are separate from article desks and accept only documented news, sports, business, and entertainment values. Article URLs must contain the supported numeric story ID. The archive is month-based, not a general author search; publisher pages state that stories do not carry individual bylines, so the organization name is not a person profile. Use the endpoint cards for this integration's accepted inputs.
A live /ghanaweb/sections response on 2026-10-14 contained 15 section records; refresh it before scheduling because publisher feeds change. Use the returned section list to select article-bearing desks; Education and Religion were omitted after they failed to produce story cards. For historical coverage, discover month values through archive/months, then request YYYYMM with page and limit. Video sections are separate from article desks and accept only documented news, sports, business, and entertainment values.
The month archive requires a YYYYMM value discovered from archive/months, alongside the documented page and limit. Keep video section values separate from article sections, and use numeric story IDs for article lookup; publisher guidance says stories do not carry individual bylines.
The month archive requires a YYYYMM value discovered from archive/months, alongside the documented page and limit. Keep video section values separate from article sections, and use numeric story IDs for article lookup; publisher guidance says stories do not carry individual bylines. Pass only a value returned by /ghanaweb/sections and accepted by /ghanaweb/headlines; preserve the selected desk with its results.
Article URLs must contain the supported numeric story ID. The archive is month-based, not a general author search; publisher pages state that stories do not carry individual bylines, so the organization name is not a person profile. Keep teaser, truncation, premium, or access fields beside the canonical URL so downstream users can see what the publisher actually returned.
GhanaWeb API endpoints/ghanaweb/archiveapiKey1 credit/requestReturns paginated canonical article URLs from one month sitemap. Discover accepted month values from ghanaweb-archive-months; the service only fetches child sitemap URLs derived from that official index.
Required: month. Optional: page, limit.
Sampled 14 Oct 2026: 20 items. Filled in every item: url, updated_at. In the sample: updated_at: 2026-09-30; url: ghanaweb.com.
/ghanaweb/archive/monthsapiKey1 credit/requestLists the `YYYYMM` months currently available in GhanaWeb's article archive, each with the time it was last updated. Use a returned month with the GhanaWeb archive endpoint; the set grows over time. It takes no parameters.
Takes no parameters.
Sampled 14 Oct 2026: 180 items. Filled in every item: month, updated_at. In the sample: updated_at: 2010-09-30 to 2026-10-14; month: 201,009 to 202,610, median 201,802.
/ghanaweb/articleapiKey2 credits/requestReturns public article metadata and readable body paragraphs. GhanaWeb's JSON-LD identifies the publisher rather than person authors, so authors are omitted.
Required: url.
Sampled 14 Oct 2026: 8 fields returned with a value. In the sample: published_at: 2026-09-28; section: “Business”; url: ghanaweb.com; title: 74 characters; paragraphs: 14 entries; description: 177 characters; updated_at: 2026-09-28; image_url: cdn.ghanaweb.com.
/ghanaweb/headlinesapiKey1 credit/requestReturns the article cards currently listed on one GhanaWeb section. `section` is required and takes one of 15 slugs such as `news`, `sports`, `crime`, `tabloid` or `regional`. Each item has its `title`, `url` and, when the card shows one, `image_url`. Summary, author and publication time are not returned.
Required: section (15 allowed values: news, sports, business, entertainment, africa, opinions, editorial, crime, regional, health, politics, tabloid, world, lifestyle, features).
Sampled 14 Oct 2026: 1 item. Filled in every item: title, url. In the sample: url: ghanaweb.com; title: median 45 characters.
/ghanaweb/newsapiKey1 credit/requestLists GhanaWeb's current stories across the site, with no parameters. Each item carries its headline as `title`, the canonical article `url` and the `published_at` time. No author, summary or image is returned.
Takes no parameters.
Sampled 14 Oct 2026: 133 items. Filled in every item: title, url, published_at. In the sample: published_at: 2026-10-13 to 2026-10-14; url: ghanaweb.com; title: median 72 characters.
/ghanaweb/sectionsapiKey1 credit/requestLists the 15 article sections GhanaWeb accepts for `ghanaweb-headlines`, from `news` and `sports` to `tabloid`, `lifestyle` and `features`. Each entry has a `slug`, display `name` and section `url`. Video and other non-article areas are left out.
Takes no parameters.
Sampled 14 Oct 2026: 15 items. Filled in every item: slug, name, url. In the sample: name: “News” and 14 other values; url: ghanaweb.com.
/ghanaweb/video-sectionsapiKey1 credit/requestLists the four GhanaWeb TV video categories accepted by `ghanaweb-videos`: `news`, `sports`, `business` and `entertainment`. Each entry has a `slug`, a display `name` and the category `url` on GhanaWeb. Takes no parameters.
Takes no parameters.
Sampled 14 Oct 2026: 4 items. Filled in every item: slug, name, url. In the sample: name: “News” and 3 other values; url: ghanaweb.com.
/ghanaweb/videoapiKey2 credits/requestReturns metadata for one GhanaWeb TV video by its required numeric `id`: title, page URL, image URL, published and updated times, and the YouTube embed URL. The video file itself is not returned.
Required: id.
Sampled 14 Oct 2026: 7 fields returned with a value. In the sample: published_at: 2026-09-28; url: ghanaweb.com; title: 66 characters; updated_at: 2026-09-28; image_url: cdn.ghanaweb.com; embed_url: youtube.com.
/ghanaweb/videosapiKey1 credit/requestReturns current public video cards for one GhanaWeb TV category, including metadata and a canonical detail URL. This endpoint does not retrieve video media.
Required: section (4 allowed values: news, sports, business, entertainment).
Sampled 14 Oct 2026: 32 items. Filled in every item: id, title, url, image_url, published_at, views. In the sample: views: 121 to 116,105, median 2,502; published_at: “13 Oct 2026” and 11 other values; url: ghanaweb.com; title: median 72 characters; image_url: cdn.ghanaweb.com.