---
title: "Browse a Better Business Bureau category"
method: GET
path: "/bbb/category"
tags: ["BBB"]
---

# Browse a Better Business Bureau category

`GET /bbb/category`

## Request

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

Browses bbb.org businesses by category and location directly, without a free-text search query. Returns the same business-result shape as bbb-search. A verified empty first page returns results: [] and total_results: 0; an unavailable or unrecognized page returns an error. A page beyond the exact last page returns 404, and a page beyond BBB's 15-page accessible limit returns 404 naming that limit. Optional sort and filter parameters use the same values as bbb-search; query-scoped category and state/province values come from bbb-search-filters.

## Query parameters

- `url` string, required
- `page` integer
- `sort` 'Relevance' | 'Distance' | 'Rating' | 'AToZ' | 'ZToA'
- `distance` '5' | '10' | '25' | '50' | '100'
- `rating` string[]
- `category_id` string[]
- `state` string[]
- `accredited` boolean
- `get_quote` boolean
- `service_area` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BbbCategoryResponseDoc
  - `code` integer
  - `data` BbbCategoryResponse
    - `has_more` boolean
    - `page` integer
    - `results` BbbBusinessSearchResult[]
      - `accredited` boolean
      - `address` string
      - `categories` string[]
      - `hq_profile_url` string
      - `image_url` string
      - `name` string
      - `phone` string
      - `quote_url` string
      - `rating` string
      - `service_areas` string[]
      - `url` string
    - `results_capped` boolean
    - `source_url` string
    - `total_pages` integer: TotalPages, HasMore and ResultsCapped follow SearchResponse.
    - `total_results` integer
  - `msg` string

## Other responses

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