Skip to main content

Scenario

You’re a consumer brand deciding where to place your product, or a franchise evaluating which competitor model to emulate. You pull competitor business profiles from Yelp — their descriptions, photos, ratings, price tiers — and use them as stimulus material for a Mavera Focus Group. Synthetic consumer personas rank the competitors and explain their preferences, revealing which attributes drive consumer choice. Flow: Yelp GET /businesses/search → Top competitors → Mavera POST /personas (local consumer archetypes) → POST /focus-groups (Ranking: “Which would you pick?”) → Consumer preference data

Code

Example Output

Error Handling

Yelp API returns at most 3 review excerpts. For richer stimulus, supplement with Yelp business description and category data. Never scrape additional reviews.
Each GET /businesses/{id} counts against your quota. For 6 competitors with details + reviews, that’s 12 calls. Cache results if running repeatedly.
Yelp’s location param accepts city names, zip codes, or addresses. Use zip codes for precision in dense metro areas with overlapping neighborhood names.
Focus Groups work best with 4-6 ranking options. More than 8 creates decision fatigue. Filter to top competitors by review count before running.