Yelp

Integrate Mavera with Yelp — business discovery for market research, review excerpt sentiment, category trend analysis, and competitive focus group stimulus

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

   export YELP_API_KEY="your_yelp_api_key"
   export MAVERA_API_KEY="mvra_live_xxxxx"
   

---

Jobs

#	Job	Yelp Data	Mavera Surface	Output
1	Business Discovery → Market Research	Search by category/location	Mave Agent	Competitive landscape analysis
2	Review Excerpt Sentiment	Review excerpts	Chat (quick sentiment)	Rapid sentiment classification
3	Category Trend Analysis	Trending businesses	Mave Agent	Consumer trend report
4	Local Business → Focus Group Stimulus	Competitor profiles	Personas + Focus Groups (Ranking)	Consumer preference ranking

---

Rate Limits & Production Notes

Yelp Endpoint	Limit	Strategy
Business Search	3-15+ QPS (paid); 5,000 trial	Cache search results; narrow with category/location
Business Detail	Counts against total quota	Cache profiles — they change slowly
Reviews	Max 3 excerpts per business	Directional signal only; don’t over-interpret
Autocomplete	Low priority endpoint	Useful for UX, not analysis

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