---
title: "Every directory and data-supplier listing found for one business (?domain=), searched from its truth record: YellowPages and DexKnows by phone, Bing Places and BBB by name and city, OpenStreetMap by phone tag or name, Data Axle by phone. Each listing is matched to the business (phone, website, or name inside its city or service area) and keeps what it prints. A directory that refuses us is not reached, never not listed. Signed (crawlcheck-business-listings)."
method: GET
path: "/api/v1/business/listings"
---

# Every directory and data-supplier listing found for one business (?domain=), searched from its truth record: YellowPages and DexKnows by phone, Bing Places and BBB by name and city, OpenStreetMap by phone tag or name, Data Axle by phone. Each listing is matched to the business (phone, website, or name inside its city or service area) and keeps what it prints. A directory that refuses us is not reached, never not listed. Signed (crawlcheck-business-listings).

`GET /api/v1/business/listings`

## Request

- Base URL: `https://crawlcheck.io`
- URL: `https://crawlcheck.io/api/v1/business/listings`
- Auth: none required

## Query parameters

- `domain` string, required
- `fresh` '1'

## Response `200`

crawlcheck-business-listings

- object, nullable
  - `kind` string, nullable
  - `v` number, nullable
  - `domain` string, nullable
  - `searched_with` object, nullable
    - `phones` string[], nullable
    - `names` string[], nullable
    - `city` string, nullable
    - `region` string, nullable
  - `sources` object[], nullable
    - `source` string, nullable
    - `by` string, nullable
    - `status` number, nullable
    - `found` number, nullable
    - `seen` number, nullable
    - `state` string, nullable
  - `listings` object[], nullable
    - `source` string, nullable
    - `matched_by` string[], nullable
    - `url` string, nullable
    - `id` string, nullable
    - `name` string, nullable
    - `phone` string, nullable
    - `address` string, nullable
    - `website` string, nullable
    - `category` string, nullable
  - `counts` object, nullable
    - `listed_on` number, nullable
    - `no_listing` number, nullable
    - `not_reached` number, nullable
    - `listings` number, nullable
  - `sha256` unknown
  - `signature` object, nullable
    - `v` number, nullable
    - `alg` string, nullable
    - `kid` unknown

## Other responses

- `400`: no or bad domain
- `404`: opted out
- `429`: too many new lookups from this address this hour

---

[API](https://skmtc.dev/crawlcheck/apis/crawlcheck-api.md) · [All operations](https://skmtc.dev/crawlcheck/apis/crawlcheck-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlcheck/apis/crawlcheck-api/revisions/57acbd6d4489?raw)