Skip to main content

​
Overview

Pull data from the Yelp Fusion API (Business Search, Business Details, Reviews, Categories) → analyze with Mavera (Mave Agent, Chat, Focus Groups, Personas) → turn Yelp’s local business data into competitive intelligence, consumer trend analysis, and persona-validated market research.
Yelp Fusion API — Base URL: https://api.yelp.com/v3/. Auth: API Key as Bearer token. Rate limits: 3-15+ QPS (paid tiers); 5,000 total calls on free trial. Pagination via offset param (max 1,000 results per search).

​
Prerequisites

1

Yelp API key

Create an app at Yelp Fusion. Free tier includes 5,000 API calls. Paid tiers offer 3-15+ QPS.
2

Mavera API key

Get your key from Mavera dashboard.
3

Environment variables

​
Jobs

​
Rate Limits & Production Notes

Yelp’s free tier has a hard cap of 5,000 API calls total (not per month — total). Use the trial for prototyping, then upgrade to a paid plan for production. Cache aggressively — business profiles rarely change day-to-day.
Checklist:
  • Auth: API key as Bearer token (not Basic auth)
  • Business search returns max 1,000 results (offset + limit ≤ 1000)
  • Reviews endpoint returns max 3 excerpts — this is a Yelp ToS limitation
  • Never scrape Yelp pages — it violates their ToS and will get you blocked
  • Category aliases must be exact — reference the full category list
  • Monitor Mavera credits at Dashboard

All Integrations

Yelp Fusion API

Personas

Focus Groups

Mave Agent

Chat