---
title: "Get Billboard section headlines"
method: GET
path: "/billboard/headlines"
tags: ["Billboard"]
---

# Get Billboard section headlines

`GET /billboard/headlines`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/billboard/headlines`
- Auth: API key in header `x-api-key`

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.

## Query parameters

- `section` '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', required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PublicnewsHeadlinesResponseDoc
  - `data` NewsplatformHeadlinesResponse
    - `items` NewsplatformHeadlineItem[]
      - `author` string
      - `image_url` string
      - `published_at` string
      - `summary` string
      - `title` string
      - `type` string
      - `url` string
    - `section` string

## Other responses

- `400`: Bad Request
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)