---
title: "Search public BBC pages"
method: GET
path: "/bbc/search"
tags: ["BBC"]
---

# Search public BBC pages

`GET /bbc/search`

## Request

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

Returns a bounded page of public BBC search-result metadata: title, URL, standfirst summary, display date, and a type of article, video, audio, live, topic, or page. Topic items are BBC topic hub pages rather than articles and carry no published_at. Media entries link only to their BBC landing pages; streams, downloads, and transcripts are not returned.

## Query parameters

- `q` string, required
- `page` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BbcSearchResponseDoc
  - `code` integer
  - `data` BbcSearchResponse
    - `items` BbcSearchItem[]
      - `published_at` string: PublishedAt is BBC's display date for the result ("7 August", "3 days ago"). It is empty for undated results such as topic hubs.
      - `section` string: Section is BBC's section label when the card shows one (e.g. Topics).
      - `site` string: Site is the BBC product that hosts the result (News, Sport, Sounds, ...).
      - `summary` string
      - `title` string
      - `type` 'article' | 'video' | 'audio' | 'live' | 'topic' | 'page': Type classifies the landing page: article, video, audio, live, topic (an evergreen topic hub index page, not an article), or page.
      - `url` string
    - `page` integer
    - `query` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `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)