Tools Overview - Birdeye Developer Portal

Tool Categories

Reviews

Review trends, rating overviews, and individual review data

Business

Business profile and child location discovery

Surveys

Survey catalog and paginated response data

Listings

Listing profiles, status reports, insights, and product listings

Search AI

AI engine citations, business visibility, accuracy, and SWOT reports

Social

Social performance reports across multiple channels like Instagram, Facebook, LinkedIn etc.

Ticketing

Ticket retrieval with filtering and pagination

Aggregation

Review source monitoring

Competitor AI

Individual competitor reviews and aggregated rating metrics

Insight AI

Experience score benchmarks and location-level performance with period-over-period deltas

All Tools

Tool	Module	Description
`review_and_rating_overview`	Reviews	Review and rating trends over a time period
`get_reviews`	Reviews	Individual reviews with full details
`get_review_summary`	Reviews	Review counts and averages grouped by source
`get_business_info`	Business	Business profile of the authenticated user
`get_child_locations`	Business	All child locations of the enterprise account
`get_all_surveys`	Surveys	All surveys for the business
`get_survey_responses`	Surveys	Paginated responses for a specific survey
`get_listing`	Listings	Full listing profile for a single location
`get_listing_location_status_report`	Listings	Listing sync status across sites for a location
`get_listing_insights`	Listings	Google and other listing analytics
`get_listing_category_list`	Listings	Available listing categories by source and country
`get_product_listing_list`	Listings	Google Merchant product listings
`get_search_ai_configuration`	Search AI	Search AI themes and prompt configuration
`get_search_ai_available_runs`	Search AI	Past Search AI run dates and themes
`get_search_ai_citations`	Search AI	URLs cited by AI engines (ChatGPT, Gemini, Perplexity)
`get_search_ai_businesses`	Search AI	Businesses surfaced by AI engines for your prompts
`get_search_ai_accuracy_report`	Search AI	NAP accuracy as reported by AI engines
`get_search_ai_sentiment_report`	Search AI	SWOT analysis from AI engine sentiment
`get_social_open_url_performance_report`	Social	Channel-level social performance with comparison
`get_all_ticket_data`	Ticketing	Tickets with full filtering and pagination
`get_all_aggregation_sources`	Aggregation	Review monitoring URLs configured for the business
`retrieve_competitor_reviews`	Competitor AI	Paginated individual reviews for competitor locations
`retrieve_competitor_review_metrics`	Competitor AI	Aggregated average rating and review count per competitor
`get_insight_experience_score_benchmark`	Insight AI	Experience scores vs industry benchmarks
`get_insight_experience_location_info`	Insight AI	Location-level scores with period-over-period deltas

Common Patterns

Enterprise Accounts with Multiple Locations

Most tools operate at the account level automatically. For tools that require a specific location (marked as location-level), first call get_child_locations to retrieve valid locationId values.

1. get_child_locations          → get list of {id, name} for each location
2. get_listing(locationId=...)  → use a location id from step 1

​Tool Categories