Billboard API endpoint
Returns public Billboard article metadata and body paragraphs from a canonical article URL. Billboard Pro articles are returned in full when the public page serves the full body; a teaser-only page is flagged paywalled.
/billboard/articleQuery parameter: url is a canonical HTTPS billboard.com article URL. Accepted shapes are /<music|business|culture|media|espanol>/<subcategory>/<slug>-<id>/, /photos/<slug>-<id>/, /lists/<slug>/, /pro/<slug>/ and /video/<slug>/. Chart pages, category pages and author pages are rejected. Returns public metadata and body paragraphs.
Billboard Pro articles were returned in full on every sampled page. paywalled is set to true only when the page itself flags a gated body, in which case paragraphs is a partial body. Photo galleries and video pages return their caption or introduction text.
| Field | In the sample | Value in the sample |
|---|---|---|
| url | Has a value | billboard.com |
| title | Has a value | 103 characters |
| published_at | Has a value | 2026-09-24 |
| updated_at | Has a value | 2026-09-25 |
| section | Has a value | “Latin” |
| authors | Has a value | 1 entry |
| image_url | Has a value | billboard.com |
| paragraphs | Has a value | 10 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| url | string | Yes | Canonical Billboard article URL | https://www.billboard.com/music/latin/stray-kids-like-bts-younger-mexican-president-confirm-visit-1236346530/ | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/billboard/article?url=https%3A%2F%2Fwww.billboard.com%2Fmusic%2Flatin%2Fstray-kids-like-bts-younger-mexican-president-confirm-visit-1236346530%2F" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"data": {
"url": "https://www.billboard.com/music/music-news/example-headline-1234567890",
"title": "Example article",
"authors": [
"Example Author"
],
"paragraphs": [
"Example public paragraph."
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.articleResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.ArticleResponse | No | ||||
| data.authors | array | No | ||||
| data.description | string | No | ||||
| data.image_url | string | No | ||||
| data.paragraphs | array | No | ||||
| data.paywalled | boolean | No | Paywalled is true when the publisher serves only a teaser of this article to anonymous readers, so Paragraphs is a partial body rather than the full text. It is omitted when the full public body was returned. | |||
| data.published_at | string | No | ||||
| data.section | string | No | ||||
| data.title | string | No | ||||
| data.updated_at | string | No | ||||
| data.url | string | No |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/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/article?url=https%3A%2F%2Fwww.billboard.com%2Fmusic%2Flatin%2Fstray-kids-like-bts-younger-mexican-president-confirm-visit-1236346530%2F" \
-H "x-api-key: $CRAWLORA_API_KEY"