Open data APIv1
Free · no key · no rate limit

Open data API

Afrobeats has no open chart dataset. Every figure here is checked against the body that owns it, and published in machine-readable form. The only condition is attribution.

384 chart entries251 certifications69 countries chartedCC BY 4.0

Endpoints

All GET, all JSON, all sending Access-Control-Allow-Origin: * so you can call them straight from the browser.

GET/api/v1/stats1 objectHeadline career totals plus the dated series of Spotify monthly-listener highs (a point is added only when the peak moves, so it ends on the day the peak was set; the latest dated current reading is on /music/listeners).GET/api/v1/charts384 entriesEvery official chart entry, by release, with the country and chart body behind each peak.GET/api/v1/certifications251 certificationsEvery certification, by release, with the awarding body, level and multiplier.GET/api/v1/songs14 songsThe song catalogue, with verified Spotify track IDs, track links and streaming totals.GET/api/v1/awards251 nominationsEvery competitive nomination as one row — ceremony, year, category, work, won — plus the honours, listed apart from the competitive total.GET/api/v1/tours6 toursTours, festivals and one-off shows, with box-office figures where a source publishes them, plus the highest-grossing-show board.GET/api/v1/afrobeats20 artistsThe Afrobeats Board — 20 artists' certifications and chart records, counted by one stated rule so the totals compare.GET/api/v1/live-charts40 releases · 546 placementsCurrent platform positions across six services, rebuilt several times a day. Add /{artist} for a board artist.

The same data as spreadsheets — CSV, UTF-8, one row per record, same licence:

GET/api/v1/certifications.csv1,340 rows Every certification for Burna Boy and the 19 artists on the Afrobeats Board — body, level, multiplier (and any lower tier awarded on top, as Mexico's AMPROFON prints "Platino & Oro"), certified units with any note the figure leans on, and the register to check it in. kind is the artist's own role on the record: a lead single where the song is on one of their own Spotify releases or they are listed first on it, a featured appearance otherwise. Where Spotify has no track of the song with the artist, the billing decides: “X ft. Artist” is a featured appearance, anything else a lead single. Filed as featured appearances, the way ChartMasters files them, though each is on the artist's own Spotify single: Black Sherif's “Come & Go”, Tyla's “Show Me Love” and Ayra Starr's “Overloading”.GET/api/v1/chart-peaks.csv2,343 rows Every official chart entry for the same 20 artists — country, chart, peak, and weeks at peak and on chart where the body publishes them. Filter across artists on format (single or album): kind splits Burna Boy's singles into lead and featured (the same rule as the certifications file), which the board's chart data does not record.GET/api/v1/awards.csv251 rows Burna Boy's competitive nominations — ceremony, year, category, work, and the result: won, nominated (decided, not won) or pending (no result yet).GET/api/v1/tours.csv85 rows The Highest-grossing shows board — every verified box-office gross by an African artist, his and everyone else's: 82 single shows, ranked by gross, then 3 multi-night runs, each reported only as one combined figure and never ranked. Artist, venue, city, country, tour, year (and a run's dates and nights), tickets and the gross in US dollars. His tours, tour dates and festival sets are in /api/v1/tours.

Try it

curl https://burnaboystats.com/api/v1/charts

Every response uses the same envelope — the data, plus where it came from and when it last changed. The two live-charts snapshots are the exception: they keep releases at the top level, with no data key, because the live page's own panels read it there. updated is the date of the newest entry in the site's news log, not the last deploy; on the two live-charts snapshots it is the day the snapshot was taken. Figures refreshed between entries, such as streaming counts, can change without moving it, so to tell whether a payload has changed, send the ETag from your last fetch back as If-None-Match: an unchanged payload answers 304. The two live-charts snapshots also carry builtAt, the minute the board was rebuilt: use that, not updated, to detect a new snapshot. credit is written from Burna Boy's side: a value that starts with “feat.” or “with” (“feat. Wizkid”, “with Stromae”) names the guests on a release he leads, any other value names the release's own acts with the lead act first, and a release with no guest reads “Burna Boy”.

Before you use it

Peaks, not runs. Chart data records the highest position a release reached in each country, not its week-by-week movement.

Almost no airplay charts. Genre, component and airplay-only charts are excluded by design, so figures here will be lower than aggregators that count them. The exception is a country that publishes no non-airplay national chart at all — there the airplay chart is the only one there is. Where a country runs both, the non-airplay chart is the one recorded.

“No. 1s” counts placements. A song that tops five countries adds five, not one.

Streaming figures are display strings. Values like "747M" are rounded for display; treat them as approximate, and null as “no verified figure” rather than zero.

This is an unofficial fan project. It is not affiliated with Burna Boy or his label.

Licence & attribution

Released under CC BY 4.0. Use it commercially, remix it, redistribute it — just credit the source:

Data from Burna Boy Stats (burnaboystats.com)

How each figure is verified is set out on the methodology page, and every change to Burna Boy's figures is logged on the updates feed.

Free · no key · no rate limit

Open Data API

Every verified chart entry, certification, award, tour, song and live placement on this site, free to use in JSON. No API key, no rate limit, no sign-up.

Afrobeats has no open chart dataset. Every figure here is checked against the body that owns it — Billboard, the Official Charts Company, SNEP, the RIAA, the BPI and their national equivalents — so it is published in machine-readable form for anyone building, writing or researching. Use it in a project, a story or a paper; the only condition is attribution.

384 chart entries251 certifications69 countries chartedCC BY 4.0

Endpoints

All endpoints are GET, return JSON, and send Access-Control-Allow-Origin: * so you can call them straight from the browser.

The same data as spreadsheets — CSV, UTF-8, one row per record, under the same licence — for Excel, Google Sheets or Numbers:

GET/api/v1/certifications.csv1,340 rows Every certification for Burna Boy and the 19 artists on the Afrobeats Board — body, level, multiplier (and any lower tier awarded on top, as Mexico's AMPROFON prints "Platino & Oro"), certified units with any note the figure leans on, and the register to check it in. kind is the artist's own role on the record: a lead single where the song is on one of their own Spotify releases or they are listed first on it, a featured appearance otherwise. Where Spotify has no track of the song with the artist, the billing decides: “X ft. Artist” is a featured appearance, anything else a lead single. Filed as featured appearances, the way ChartMasters files them, though each is on the artist's own Spotify single: Black Sherif's “Come & Go”, Tyla's “Show Me Love” and Ayra Starr's “Overloading”.GET/api/v1/chart-peaks.csv2,343 rows Every official chart entry for the same 20 artists — country, chart, peak, and weeks at peak and on chart where the body publishes them. Filter across artists on format (single or album): kind splits Burna Boy's singles into lead and featured (the same rule as the certifications file), which the board's chart data does not record.GET/api/v1/awards.csv251 rows Burna Boy's competitive nominations — ceremony, year, category, work, and the result: won, nominated (decided, not won) or pending (no result yet).GET/api/v1/tours.csv85 rows The Highest-grossing shows board — every verified box-office gross by an African artist, his and everyone else's: 82 single shows, ranked by gross, then 3 multi-night runs, each reported only as one combined figure and never ranked. Artist, venue, city, country, tour, year (and a run's dates and nights), tickets and the gross in US dollars. His tours, tour dates and festival sets are in /api/v1/tours.

A directory of all 8 endpoints and the 4 CSV files lives at /api/v1.

Try it

curl https://burnaboystats.com/api/v1/charts

Every response uses the same envelope — the data, plus where it came from and when it last changed. The two live-charts snapshots are the exception: they keep releases at the top level, with no data key, because the live page's own panels read it there:

{
  "artist": "Burna Boy",
  "endpoint": "/api/v1/charts",
  "description": "Official chart entries by release. Peaks are read from each chart body's own run. Longevity is too, except where a `note` on the entry says otherwise — read it before treating a `weeks` value as body-published. Genre, component and airplay-only charts are excluded by design.",
  "updated": "2026-10-23",
  "count": 384,
  "countOf": "chart entries",
  "license": {
    "name": "CC BY 4.0",
    "url": "https://creativecommons.org/licenses/by/4.0/",
    "attribution": "Data from Burna Boy Stats (burnaboystats.com)"
  },
  "source": "https://burnaboystats.com",
  "methodology": "https://burnaboystats.com/methodology",
  "docs": "https://burnaboystats.com/api",
  "data": {
    "totals": {
      "chartEntries": 384,
      "numberOnes": 46,
      "countries": 69,
      "territories": 71,
      "chartedReleases": 103
    },
    "releases": [
      {
        "title": "Dai Dai",
        "credit": "Shakira & Burna Boy",
        "year": 2026,
        "entries": [
          {
            "countryCode": "CH",
            "country": "Switzerland",
            "chart": "Schweizer Hitparade",
            "peak": 1,
            "weeksAtPeak": 16,
            "weeks": 19
          },
          {
            "countryCode": "NL",
            "country": "Netherlands",
            "chart": "Dutch Charts",
            "peak": 1,
            "weeksAtPeak": 7,
            "weeks": 17,
            "note": "seven weeks at No.1, not consecutive - two from 20 June, then five from 25 July; No.3 on 29 August and 5 September, No.4 on 12 September, No.6 on 19 September. Single Top 100 figures only - the Dutch Top 40 (12 weeks at No.1 to 12 September) is a separate chart this row does not table"
          },
          {
            "countryCode": "SR",
            "country": "Suriname",
            "chart": "Nationale Top 40",
            "peak": 1,
            "weeksAtPeak": 7,
            "weeks": 10
          }
        ]
      }
    ]
  }
}

updated is the date of the newest entry in the site's news log, not the last deploy; on the two live-charts snapshots it is the day the snapshot was taken. Figures refreshed between entries, such as streaming counts, can change without moving it, so to tell whether a payload has changed, send the ETag from your last fetch back as If-None-Match: an unchanged payload answers 304. The two live-charts snapshots also carry builtAt, the minute the board was rebuilt: use that, not updated, to detect a new snapshot. count is the endpoint's headline size and countOf names its unit — it is not always the length of the array in data, and where the two differ the array's own length is published under data.totals. credit is written from Burna Boy's side: a value that starts with “feat.” or “with” (“feat. Wizkid”, “with Stromae”) names the guests on a release he leads, any other value names the release's own acts with the lead act first, and a release with no guest reads “Burna Boy”.

Licence & attribution

The dataset is released under CC BY 4.0. You can use it commercially, remix it and redistribute it — just credit the source:

Data from Burna Boy Stats (burnaboystats.com)

If you publish something built on it, a link back is genuinely appreciated. How each figure is verified is set out on the methodology page, and every change to Burna Boy's figures is logged on the updates feed.

Stability

The v1 shape won't change in a breaking way — new fields may be added, but existing ones stay put. Anything breaking would ship as v2 at a new path.

Spotted a problem or want a field added? Get in touch.

Data last reviewed

What to know before you use it

  • 01

    Peaks, not runs. Chart data records the highest position a release reached in each country, not its week-by-week movement.

  • 02

    Almost no airplay charts. Genre, component and airplay-only charts are excluded by design, so figures here will be lower than aggregators that count them. The exception is a country that publishes no non-airplay national chart at all — there the airplay chart is the only one there is. Where a country runs both, the non-airplay chart is the one recorded.

  • 03

    “No. 1s” counts placements. A song that tops five countries adds five, not one.

  • 04

    Streaming figures are display strings. Values like "747M" are rounded for display; treat them as approximate, and null as “no verified figure” rather than zero.

  • 05

    This is an unofficial fan project. It is not affiliated with Burna Boy or his label.

← How the numbers are verifiedWhat the numbers say ↗Every chart entry ↗