---
title: "Get Billboard top stories"
method: GET
path: "/billboard/news"
tags: ["Billboard"]
---

# Get Billboard top stories

`GET /billboard/news`

## Request

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

Returns the latest Billboard stories, with no input needed. Each item has a title and canonical URL, plus a publication time, summary and image when Billboard provides them.

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PublicnewsNewsResponseDoc
  - `data` NewsplatformNewsResponse
    - `items` NewsplatformHeadlineItem[]
      - `author` string
      - `image_url` string
      - `published_at` string
      - `summary` string
      - `title` string
      - `type` string
      - `url` string

## Other responses

- `429`: Too Many Requests
- `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/028417aa35bb?raw)
