Billboard API endpoint
Returns the 10 most recent items from one Billboard section. `section` is required and takes a slug such as `chart-beat`, `country`, `rb-hip-hop`, `streaming` or `touring`. Parent sections such as `music` and `business` overlap with their subsections, so one item can appear under several. Items carry title, URL, summary, author and time.
/billboard/headlinesQuery parameter: section is required and must be one of music, music-news, chart-beat, awards, concerts, country, features, latin, lyrics, pop, rb-hip-hop, reviews, rock, business, business-news, legal, management, publishing, radio, record-labels, streaming, tech, touring, culture, events, lifestyle, politics, pride, product-recommendations, tv-film, media, lists, photos-media, podcasts, videos, espanol, cultura-entretenimiento, musica, negocios, noticias, pro. Any other value returns an invalid-parameter error.
Notes: parent sections such as music, business, culture and media overlap with their subsections, so the same item can appear under several sections. Each section feed returns the 10 most recent items.
| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| title | 10 | median 87 characters |
| url | 10 | billboard.com |
| summary | 10 | median 64 characters |
| published_at | 10 | 2026-10-11 to 2026-10-13 |
| author | 10 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | Billboard section slug Allowed values: music, music-news, chart-beat, awards, concerts, country, features, latin, lyrics, pop, rb-hip-hop, reviews, rock, business, business-news, legal, management, publishing, radio, record-labels, streaming, tech, touring, culture, events, lifestyle, politics, pride, product-recommendations, tv-film, media, lists, photos-media, podcasts, videos, espanol, cultura-entretenimiento, musica, negocios, noticias, pro. | music | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/billboard/headlines?section=music" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"data": {
"section": "chart-beat",
"items": [
{
"title": "Example headline",
"url": "https://www.billboard.com/music/chart-beat/example-headline-1234567890"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.headlinesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.HeadlinesResponse | No | ||||
| data.items | array | No | HeadlineItem record, 7 fields: author, image_url, published_at, summary, title, type, url. Described under Billboard top stories API. | |||
| data.section | string | No |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/billboard/headlines?section=music" \
-H "x-api-key: $CRAWLORA_API_KEY"