Get BBB newsroom stories API

Endpoint facts

Method

GET

API path

/bbb/news

Auth

apiKey

Credits

2 credits/request

Charged on

Successful 2xx responses only

Platform

BBB

How this endpoint behaves

Query parameters:

• url (required): URL-encoded canonical BBB newsroom or topic URL. Use the page query inside the encoded URL for pagination, such as https://www.bbb.org/us/news/scams?page=2.

Accepted newsroom URLs, each with an optional topic segment from bbb_news_topics:

<state> is the two-letter code and <city> the city slug BBB uses in its own URLs, the same values as in a business profile URL. A chapter newsroom URL is the news_url returned by bbb_local_bbbs and bbb_local_bbb, which is how to go from an office to its newsroom.

Which stories a regional or chapter URL returns is decided by BBB, and the endpoint returns that page as it is. Where the local BBB publishes its own stories, a city or chapter URL returns them (on 2026-10-12, San Francisco returned 226 stories and its chapter's own newsroom 79). Where it does not, BBB shows the country newsroom's list instead: on the same day /us/ca/news, /us/tx/news, /us/ca/los-angeles/news and two California chapter newsrooms all returned the same 943 stories, in the same order, as /us/news. To tell the two apart, compare total and the first item ids with the country newsroom. A topic URL under a chapter can still be local when the unfiltered list is not. The response echoes the scope: state and city for a regional URL, local_bbb_id and local_bbb_name for a chapter URL.

Response fields:

• source_url: the newsroom URL that was read, page query included.
• country: us or ca.
• state, city: the state or province code and the city slug; present for a state or city URL.
• local_bbb_id, local_bbb_name: the local BBB chapter; present for a chapter URL.
• topic: the topic name; present for a topic URL.
• page, page_size: the page returned and BBB's page size. A page can hold fewer than page_size items with more pages after it.
• total: BBB's count of stories in the list. It can be slightly higher than the number of stories the pages hold (a list reporting 30 held 27 on 2026-10-13), so do not use it to decide where the list ends.
• total_pages: the number of pages BBB serves for the list, read from BBB's own pager; at least 1.
• has_more: true while a later page exists. Request page + 1 next and stop when it is false; that way a page past the end is never requested.
• items: BBB's newsroom cards on the page, in source order. type is Article for a story; an event record carries an event type, event_start_date and event_url; a related local-service card has type Near Me and a BBB /near-me/<slug> URL.

The endpoint returns BBB's current result count, page metadata, topic, and newsroom cards. Each item includes its upstream type and title, plus its canonical URL, summary, modification time, and image when present. Article links may use either www.bbb.org or bbb.org; both hosts are accepted by bbb-article. Near Me cards link to BBB's related local-service pages; they are preserved as BBB lists them and do not carry event fields. Event records retain event_start_date and event_url; the currently captured US Events page is explicitly empty (numFound=0). A malformed card or an upstream challenge is returned as a typed upstream error rather than an empty result.

A chapter URL whose chapter BBB does not know returns 404. A page beyond total_pages returns 404 with BBB newsroom page not found in the data field (a newsroom that does not exist reads BBB newsroom resource not found). An upstream page request beyond the page count returns 404 when BBB reports the requested page number, a positive total, and no items. An empty result on an in-range page with a positive total is treated as an upstream error.

Sampled response

Request, 14 Oct 2026

GET /bbb/news?url=https%3A%2F%2Fwww.bbb.org%2Fus%2Fnews%2Fscams

Items in items

10

Fields filled in every checked item

7

Shared guides

Related