Skip to main content

Scenario

You’re opening a new location or launching a competitive product. Before investing, you need to understand the local competitive landscape — who’s already there, how they’re rated, what they offer, and where the gaps are. You use Yelp’s business search to map competitors by category and location, then send the landscape data to Mave for strategic analysis. Flow: Yelp GET /businesses/search (category + location) → Aggregate: ratings, review counts, price ranges, categories → Mavera POST /mave/chat → Competitive landscape report

Architecture

Code

Example Output

Error Handling

Yelp limits search results to 1,000 total (offset + limit ≤ 1000). For dense markets, narrow by neighborhood or category.
The free tier allows only 5,000 total API calls. Business search is the most expensive — each call counts as 1. Cache results aggressively.
Not all businesses have price set. The code groups these as "N/A". Filter or exclude for cleaner tier analysis.