Operator REST API
Query local business data at scale.
The Operator REST API gives you programmatic access to 35,178,492 business profiles, trust scores, reviews, and competitive intelligence. JSON responses, standard auth, rate-limited free tier.
Base URLhttps://operator.fyi
Endpoints
GET/api/v2/businesses
Search and list businesses with filters.
| Param | Type | Description |
|---|
niche | string | Business category slug (e.g. plumbing, hvac) |
city | string | City name or slug |
limit | number | Results per page (max 50) |
page | number | Page number (starts at 1) |
GET /api/v2/businesses?niche=plumbing&city=honolulu-hi&limit=10
GET/api/v1/business/:slug
Get full profile for a single business.
| Param | Type | Description |
|---|
slug | string | Business slug from search results |
GET /api/v1/business/sunrise-plumbing-honolulu-hi
GET/api/v1/health-score/:slug
Get the Operator health score (0-100) for a business.
| Param | Type | Description |
|---|
slug | string | Business slug |
GET /api/v1/health-score/sunrise-plumbing-honolulu-hi
GET/api/v2/market
Get competitive market data for a niche and city.
| Param | Type | Description |
|---|
niche | string | Business category slug |
city | string | City slug |
GET /api/v2/market?niche=plumbing&city=honolulu-hi
GET/api/v1/review-intelligence/:slug
Get review sentiment, topics, and response data.
| Param | Type | Description |
|---|
slug | string | Business slug |
GET /api/v1/review-intelligence/sunrise-plumbing-honolulu-hi
GET/api/v1/competitors/:slug
Get top competitors for a business.
| Param | Type | Description |
|---|
slug | string | Business slug |
limit | number | Max competitors (default 5) |
GET /api/v1/competitors/sunrise-plumbing-honolulu-hi
GET/api/peer-set
The canonical peer set for any U.S. local business. Returns segment benchmarks (rating, review volume, top-5 share, new entrants) for the business's (niche, city) market. Authenticated via x-api-key.
| Param | Type | Description |
|---|
business_id | uuid | Business UUID from /api/v2/businesses |
GET /api/peer-set?business_id=11111111-2222-3333-4444-555555555555
x-api-key: op_live_...
Authentication
All endpoints are available without authentication, rate-limited to 100 requests per day. Authenticated requests allow up to 10,000 requests per day.
curl https://operator.fyi/api/v2/businesses \
-H "Authorization: Bearer op_your_api_key"
Rate limits
Free (no key)100 req/day10 req/min
Free (authed)1,000 req/day30 req/min
Autopilot ($499/mo)10,000 req/day100 req/min
EnterpriseCustomCustom