The Businesses API from Bezal — 2 operation(s) for businesses.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/bezal-ai:bezal-ai-businesses-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Bezal Public Businesses API
description: 'Search Bezal''s local business directory, view public business profiles, and send
service requests to businesses.
## Authentication
Pass your API key in the Authorization header (or in X-API-Key):
```
Authorization: Bearer bzl_your_key_here
```
Read endpoints (search, business details, categories, health, this spec) work without a key
and are limited per IP. Write endpoints (requests) require a valid API key.
Get a key at https://bezal.ai/developers/keys.
## What a business record contains
Every business record has the same public shape. Contact details depend on the provider''s
Bezal plan:
- Always: id, name, category, city, state, avg_rating, review_count, tier, quote_request_url
- Pro, Business and Premium plans: phone, website, address, zip, hours, photos, lat, lng
- Business and Premium plans: description
- Free and unclaimed listings: upgrade_note
quote_request_url is the business''s public Bezal profile, where a person can send a request.
## Rate limiting
Each key has a daily request limit, and anonymous callers have a daily limit per IP.
When a limit is exceeded, the API returns 429.'
version: 1.1.0
contact:
name: Bezal API Support
url: https://bezal.ai/developers
servers:
- url: https://bezal.ai/api/v1
description: Production
tags:
- name: Businesses
paths:
/businesses/search:
get:
operationId: searchBusinesses
summary: Search businesses
description: 'Search the directory with filters for category, location, text and rating.
Leaving out state searches every state. Results are sorted by average rating.'
parameters:
- name: category
in: query
description: Category name (partial match, case-insensitive)
schema:
type: string
maxLength: 60
- name: city
in: query
description: City name (whole-name match, case-insensitive)
schema:
type: string
maxLength: 60
- name: state
in: query
description: Two-letter state code (like CT) or full state name. No default.
schema:
type: string
- name: q
in: query
description: Free-text search across name and description
schema:
type: string
maxLength: 100
- name: min_rating
in: query
description: Minimum average rating (0-5)
schema:
type: number
minimum: 0
maximum: 5
- name: limit
in: query
description: Results per page (1-20)
schema:
type: integer
default: 10
minimum: 1
maximum: 20
- name: page
in: query
description: Page number
schema:
type: integer
default: 1
minimum: 1
maximum: 500
responses:
'200':
description: Search results
content:
application/json:
schema:
type: object
required:
- results
- total
- page
- pageSize
properties:
results:
type: array
items:
$ref: '#/components/schemas/Business'
total:
type: integer
page:
type: integer
pageSize:
type: integer
'400':
description: Invalid state
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
$ref: '#/components/responses/InvalidKey'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/ServerError'
tags:
- Businesses
/businesses/{id}:
get:
operationId: getBusinessById
summary: Get business details
description: Retrieve the public profile for a single business by its UUID.
parameters:
- name: id
in: path
required: true
description: Business UUID
schema:
type: string
format: uuid
responses:
'200':
description: Business details
content:
application/json:
schema:
type: object
required:
- business
properties:
business:
$ref: '#/components/schemas/Business'
'400':
description: Invalid ID format
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
$ref: '#/components/responses/InvalidKey'
'404':
description: Business not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/ServerError'
tags:
- Businesses
components:
responses:
ServerError:
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: Internal server error
InvalidKey:
description: The API key is missing, malformed or inactive
content:
application/json:
schema:
$ref: '#/components/schemas/RateLimitError'
example:
error: Invalid API key
RateLimited:
description: Rate limit exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/RateLimitError'
example:
error: Rate limit exceeded
schemas:
RateLimitError:
type: object
required:
- error
properties:
error:
type: string
tier:
type: string
requests_today:
type: integer
limit:
type: integer
Business:
type: object
description: 'Public business record. Fields beyond the always-present ones appear only when the
provider''s plan includes them (see the API description).
'
required:
- id
- name
- category
- city
- state
- avg_rating
- review_count
- tier
- quote_request_url
properties:
id:
type: string
format: uuid
name:
type: string
category:
type:
- string
- 'null'
city:
type:
- string
- 'null'
state:
type:
- string
- 'null'
avg_rating:
type: number
description: Average rating, 0 when unknown
review_count:
type: integer
description: Review count, 0 when unknown
tier:
type: string
description: The provider's Bezal plan, for example free, unclaimed, pro, business or premium
quote_request_url:
type: string
format: uri
description: Public Bezal profile for the business, for example https://bezal.ai/joes-plumbing
phone:
type:
- string
- 'null'
description: Pro, Business and Premium only
website:
type:
- string
- 'null'
description: Pro, Business and Premium only
address:
type:
- string
- 'null'
description: Pro, Business and Premium only
zip:
type:
- string
- 'null'
description: Pro, Business and Premium only
hours:
description: Opening hours as stored for the business. Pro, Business and Premium only
photos:
description: Photo list as stored for the business. Pro, Business and Premium only
lat:
type:
- number
- 'null'
description: Latitude. Pro, Business and Premium only
lng:
type:
- number
- 'null'
description: Longitude. Pro, Business and Premium only
description:
type:
- string
- 'null'
description: Business and Premium only
upgrade_note:
type: string
description: Present on free and unclaimed listings
Error:
type: object
required:
- error
properties:
error:
type: string
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: bzl_...
apiKeyHeader:
type: apiKey
in: header
name: X-API-Key