Operator REST API

Query local business data at scale.

The Operator REST API gives you programmatic access to 3.4M 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.

ParamTypeDescription
nichestringBusiness category slug (e.g. plumbing, hvac)
citystringCity name or slug
limitnumberResults per page (max 50)
pagenumberPage 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.

ParamTypeDescription
slugstringBusiness 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.

ParamTypeDescription
slugstringBusiness slug
GET /api/v1/health-score/sunrise-plumbing-honolulu-hi
GET/api/v2/market

Get competitive market data for a niche and city.

ParamTypeDescription
nichestringBusiness category slug
citystringCity slug
GET /api/v2/market?niche=plumbing&city=honolulu-hi
GET/api/v1/review-intelligence/:slug

Get review sentiment, topics, and response data.

ParamTypeDescription
slugstringBusiness slug
GET /api/v1/review-intelligence/sunrise-plumbing-honolulu-hi
GET/api/v1/competitors/:slug

Get top competitors for a business.

ParamTypeDescription
slugstringBusiness slug
limitnumberMax competitors (default 5)
GET /api/v1/competitors/sunrise-plumbing-honolulu-hi

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
Monitor ($49/mo)1,000 req/day30 req/min
Autopilot ($499/mo)10,000 req/day100 req/min
EnterpriseCustomCustom
Back to DevelopersMCP Server docsGet API key