---
title: "List BBB newsroom topics"
method: GET
path: "/bbb/news/topics"
tags: ["BBB"]
---

# List BBB newsroom topics

`GET /bbb/news/topics`

## Request

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

Returns the complete topic navigation shown by a BBB newsroom page, including its active topic. The page can be the US or Canada newsroom, a state, province or city newsroom, or one local BBB chapter's newsroom; the returned topic URLs stay in that scope, and a chapter has its own topic set.

## Query parameters

- `url` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- object: The Response struct is used for wrapping the API response with a code, message, and data.
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` object: Data is the response data (can be any object or null) @example {"id": 1, "name": "John Doe"}
    - `city` string: City slug; present for a city URL.
    - `country` 'us' | 'ca': Country of the newsroom: us or ca.
    - `local_bbb_id` string: Id of the local BBB chapter; present for a chapter URL.
    - `local_bbb_name` string: Name of the local BBB chapter; present for a chapter URL.
    - `source_url` string: The newsroom URL that was read.
    - `state` string: Two-letter state or province code; present for a state or city URL.
    - `topics` BbbnewsTopic[]: Every topic the page lists, in name order, the active one included.
      - `name` string: Topic name as BBB shows it.
      - `slug` string: Topic path segment.
      - `url` string: Newsroom URL of the topic in the requested scope; pass it to bbb-news.
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `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/0497899e2016?raw)