API Reference
Use Crawlora's Billboard API endpoints to extract supported public Billboard data as structured JSON. This documentation covers 5 active endpoints including Get Billboard article content, Get a Billboard author profile, Get Billboard section headlines, Get Billboard top stories, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as url, section, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/billboard/headlines?section=music" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/billboard/articleapiKey2 credits/requestReturns 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.
Required params: url:query
/billboard/authorapiKey2 credits/requestReturns a Billboard author's byline metadata, biography, and recent articles (sourced from the author's own public RSS feed) from a canonical author URL.
Required params: url:query
/billboard/headlinesapiKey1 credit/requestReturns fresh headlines from one public Billboard section.
Required params: section:query
/billboard/newsapiKey1 credit/requestReturns fresh Billboard top stories from its public RSS feed.
Required params: None
/billboard/sectionsapiKey1 credit/requestReturns the public Billboard section inventory: every music, business, culture, media and Spanish-language category plus Billboard Pro, each linking to its public RSS feed.
Required params: None
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Get Billboard article content | /billboard/article | GET | 2 credits/request | url:query | View docs | Try endpoint |
| Get a Billboard author profile | /billboard/author | GET | 2 credits/request | url:query | View docs | Try endpoint |
| Get Billboard section headlines | /billboard/headlines | GET | 1 credit/request | section:query | View docs | Try endpoint |
| Get Billboard top stories | /billboard/news | GET | 1 credit/request | None | View docs | Try endpoint |
| Get Billboard sections | /billboard/sections | GET | 1 credit/request | None | View docs | Try endpoint |