DataForSEO

DataForSEO BusinessData API

The BusinessData API from DataForSEO — 55 operation(s) for businessdata.

GitHub OpenAPI

Operations 55

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v3/business_data/id_list List IDs of Business Data tasks in a time period · Business data id list #
Ask an LLM
“Can I get the IDs of every Business Data task I created in a given time window?”
“Which business reviews and listings tasks did I submit last week, including unfinished ones?”
Tell an agent
List the IDs and metadata of all Business Data tasks I created this month.
Pull every Business Data task ID from yesterday, completed or not.
POST /v3/business_data/errors List Business Data tasks that failed recently · Business data errors #
Ask an LLM
“Which of my Business Data tasks returned an error in the past seven days?”
“Why did some of my business reviews requests fail this week?”
Tell an agent
Show the Business Data API tasks that errored in the last 7 days.
Get error details for my failed business data tasks.
GET /v3/business_data/business_listings/locations List locations for the Business Listings search · Business listings locations #
Ask an LLM
“Which locations can I search in the Google Maps business listings database?”
“Is there a downloadable list of locations supported by Business Listings?”
Tell an agent
List the locations supported by the Business Listings search.
Get the location codes I can use to search business listings.
GET /v3/business_data/business_listings/categories List top business categories by business count · Business listings categories #
Ask an LLM
“What are the most common business categories in the listings database?”
“Which categories have the most businesses listed?”
Tell an agent
Get the top business listing categories ranked by business count.
Show which categories I can use when searching business listings.
GET /v3/business_data/business_listings/available_filters List filters usable in Business Listings search · Business listings available filters #
Ask an LLM
“What fields can I filter on when searching business listings?”
“Can I filter Google Maps listings by rating or other attributes?”
Tell an agent
Get the filters supported by the Business Listings endpoints.
Show which business listing fields I can use in filter expressions.
POST /v3/business_data/business_listings/search/live Search Google Maps business listings by category · Business listings search live #
Ask an LLM
“Which businesses are listed on Google Maps in a given category near a location?”
“Can I get addresses, contacts, ratings and opening hours for all plumbers in a city?”
Tell an agent
Search business listings for dentists in Chicago with their ratings and contacts.
Find Google Maps listed coffee shops in this location with working hours.
POST /v3/business_data/business_listings/categories_aggregation/live Count businesses per group of related categories · Business listings categories aggregation live #
Ask an LLM
“How many businesses fall into each group of related categories in an area?”
“Which related category clusters have the most entities in a location?”
Tell an agent
Aggregate business listing counts by related category groups for this city.
Show grouped category totals of listed businesses in my target area.
GET /v3/business_data/google/locations List Google locations for business data tasks · Business data google locations #
Ask an LLM
“Which Google locations can I target for business profile and review tasks?”
“Where do I find location codes for Google business data?”
Tell an agent
List all Google locations supported for business data tasks.
Get every location code available for Google business tasks.
GET /v3/business_data/google/locations/{country} List Google business data locations in one country · Business data google locations country #
Ask an LLM
“Which Google business data locations exist within a single country?”
“Can I narrow Google business location codes to one country?”
Tell an agent
List Google business data locations in country {country}.
Get the Google business location codes for {country}.
GET /v3/business_data/google/languages List Google languages for business data tasks · Business data google languages #
Ask an LLM
“Which languages can I set when pulling Google business data?”
“What language codes are valid for Google reviews and business profile tasks?”
Tell an agent
List the Google languages supported for business data.
Get language codes for Google business profile tasks.
POST /v3/business_data/google/my_business_info/task_post Queue a Google business profile lookup · Google my business info task post #
Ask an LLM
“Can I collect the Google Business Profile details of a specific business in the background?”
“What is the queued way to fetch a company's Google business listing info?”
Tell an agent
Queue a task to collect the Google business profile for this business.
Set a Google My Business info task for my store in English.
GET /v3/business_data/google/my_business_info/tasks_ready List finished Google business profile tasks · Google my business info tasks ready #
Ask an LLM
“Which of my Google business profile info tasks are ready to collect?”
“Have my queued Google My Business info lookups finished?”
Tell an agent
List completed Google My Business info tasks I haven't collected.
Check which Google business profile tasks are ready.
GET /v3/business_data/tasks_ready List all finished Business Data tasks · Business data tasks ready #
Ask an LLM
“Which Business Data tasks across every endpoint are finished and uncollected?”
“Is there one place to see all completed review and business tasks I haven't retrieved?”
Tell an agent
List every completed Business Data task, across all sources, I haven't collected.
Show all ready business data tasks regardless of endpoint.
GET /v3/business_data/google/my_business_info/task_get/{id} Get results of a Google business profile task · Google my business info task get #
Ask an LLM
“What Google business profile details came back from my queued task?”
“Can I retrieve the business info result for a task I already set?”
Tell an agent
Fetch the Google business profile results for task {id}.
Get the My Business info for completed task {id}.
POST /v3/business_data/google/my_business_info/live Look up a Google business profile instantly · Google my business info live #
Ask an LLM
“Can I get a business's Google profile details in real time without queuing a task?”
“What does Google show for a specific business entity right now?”
Tell an agent
Look up the Google business profile for this business live.
Get real-time Google My Business info for my restaurant.
POST /v3/business_data/google/my_business_updates/task_post Queue a task for a business's latest Google updates · Google my business updates task post #
Ask an LLM
“What are the latest posts and updates a business published on its Google profile?”
“Can I monitor the Google business updates of a competitor?”
Tell an agent
Queue a task to collect the latest Google updates for this business.
Set a Google My Business updates task for my competitor's listing.
GET /v3/business_data/google/my_business_updates/tasks_ready List finished Google business updates tasks · Google my business updates tasks ready #
Ask an LLM
“Which Google business updates tasks are done and waiting?”
“Are my queued business post updates ready to collect?”
Tell an agent
List completed Google My Business updates tasks I haven't collected.
Check which business updates tasks are ready.
GET /v3/business_data/google/my_business_updates/task_get/{id} Get results of a Google business updates task · Google my business updates task get #
Ask an LLM
“What updates came back from my Google business updates task?”
“Can I retrieve a business's recent Google posts from a task I already set?”
Tell an agent
Fetch the Google business updates for task {id}.
Get the recent business posts from updates task {id}.
POST /v3/business_data/google/hotel_searches/task_post Queue a Google hotel search task · Google hotel searches task post #
Ask an LLM
“Which hotels does Google list for a keyword in a destination?”
“Can I collect Google hotel search results for a city in the background?”
Tell an agent
Queue a Google hotel search task for hotels in Lisbon.
Set a hotel searches task for this keyword and location.
GET /v3/business_data/google/hotel_searches/tasks_ready List finished Google hotel search tasks · Google hotel searches tasks ready #
Ask an LLM
“Which of my Google hotel search tasks are ready?”
“Have my queued hotel searches finished?”
Tell an agent
List completed Google hotel search tasks I haven't collected.
Check which hotel searches tasks are ready.
GET /v3/business_data/google/hotel_searches/task_get/{id} Get results of a Google hotel search task · Google hotel searches task get #
Ask an LLM
“What hotels came back from my queued Google hotel search?”
“Can I retrieve the hotel list for a search task I already set?”
Tell an agent
Fetch the hotel search results for task {id}.
Get the list of hotels from Google hotel searches task {id}.
POST /v3/business_data/google/hotel_searches/live Search Google Hotels in real time · Google hotel searches live #
Ask an LLM
“Can I see which hotels Google Hotels lists for a location right now?”
“Is there a live hotel search that returns results immediately?”
Tell an agent
Search Google Hotels live for hotels in Barcelona.
Run a real-time Google hotel search for this location and language.
POST /v3/business_data/google/hotel_info/task_post Queue a Google hotel details task · Google hotel info task post #
Ask an LLM
“Can I collect amenities, prices, ratings and reviews for one hotel on Google Hotels?”
“What is the queued way to fetch detailed info about a specific hotel?”
Tell an agent
Queue a task to collect Google Hotels details for this hotel.
Set a hotel info task to get amenities and prices for my property.
GET /v3/business_data/google/hotel_info/tasks_ready List finished Google hotel details tasks · Google hotel info tasks ready #
Ask an LLM
“Which of my hotel details tasks are ready to collect?”
“Have my queued Google hotel info tasks finished?”
Tell an agent
List completed Google hotel info tasks I haven't collected.
Check which hotel details tasks are ready.
GET /v3/business_data/google/hotel_info/task_get/advanced/{id} Get structured hotel details from a task · Google hotel info task get advanced #
Ask an LLM
“What structured amenities, prices and ratings did my hotel info task return?”
“Can I get parsed Google Hotels data for a hotel I queued?”
Tell an agent
Fetch the structured hotel details for task {id}.
Get parsed amenities and prices from hotel info task {id}.
GET /v3/business_data/google/hotel_info/task_get/html/{id} Get raw HTML hotel details from a task · Google hotel info task get html #
Ask an LLM
“Can I get the raw HTML of the Google Hotels page from my hotel info task?”
“Is the unparsed hotel details markup available for a queued task?”
Tell an agent
Get the raw HTML hotel details for task {id}.
Download the unparsed Google Hotels page from hotel info task {id}.
POST /v3/business_data/google/hotel_info/live/advanced Get structured hotel details in real time · Google hotel info live advanced #
Ask an LLM
“Can I get a hotel's amenities, prices and reviews from Google Hotels instantly?”
“Is there a live endpoint for parsed hotel details?”
Tell an agent
Get structured Google Hotels details for this hotel live.
Pull parsed amenities, rating and prices for my hotel in real time.
POST /v3/business_data/google/hotel_info/live/html Get raw HTML hotel details in real time · Google hotel info live html #
Ask an LLM
“Can I fetch the unparsed HTML of a hotel's Google Hotels page instantly?”
“Is there a live way to get raw hotel page markup?”
Tell an agent
Get the raw HTML of this hotel's Google Hotels page live.
Fetch unparsed hotel details HTML in real time.
POST /v3/business_data/google/reviews/task_post Queue a Google reviews task for a business · Google reviews task post #
Ask an LLM
“What are customers saying about a business in its Google reviews?”
“How do I collect Google user reviews for a local business in a specific language?”
Tell an agent
Queue a task to collect Google reviews for this local business.
Set a Google reviews task for my restaurant in English.
GET /v3/business_data/google/reviews/tasks_ready List finished Google reviews tasks · Google reviews tasks ready #
Ask an LLM
“Which Google reviews tasks are ready to collect?”
“Have my queued Google review pulls finished?”
Tell an agent
List completed Google reviews tasks I haven't collected.
Check which Google review tasks are ready.
GET /v3/business_data/google/reviews/task_get/{id} Get Google reviews collected by a task · Google reviews task get #
Ask an LLM
“What Google reviews came back for the business in my task?”
“Can I retrieve the review results for a Google reviews task I already set?”
Tell an agent
Fetch the Google reviews for task {id}.
Get the business reviews collected by Google reviews task {id}.
POST /v3/business_data/google/extended_reviews/task_post Queue a multi-source reviews task for a business · Google extended reviews task post #
Ask an LLM
“Can I get a business's reviews from other review sites shown in Google, not just Google users?”
“Which task collects reviews aggregated from multiple sources in the Google reviews panel?”
Tell an agent
Queue an extended reviews task to collect multi-source reviews for this business.
Set an extended reviews task covering all review sources for my hotel.
GET /v3/business_data/google/extended_reviews/tasks_ready List finished extended reviews tasks · Google extended reviews tasks ready #
Ask an LLM
“Which extended multi-source reviews tasks are ready?”
“Have my queued extended review pulls finished?”
Tell an agent
List completed extended reviews tasks I haven't collected.
Check which multi-source review tasks are ready.
GET /v3/business_data/google/extended_reviews/task_get/{id} Get multi-source reviews collected by a task · Google extended reviews task get #
Ask an LLM
“What reviews from all sources came back in my extended reviews task?”
“Can I retrieve the aggregated multi-source reviews for a business I queued?”
Tell an agent
Fetch the extended reviews for task {id}.
Get the multi-source reviews collected by extended reviews task {id}.
POST /v3/business_data/google/questions_and_answers/task_post Queue a Google Q&A task for a business · Google questions and answers task post #
Ask an LLM
“What questions have people asked about a business on its Google profile?”
“Can I collect a business's Google questions and answers in the background?”
Tell an agent
Queue a task to collect Google questions and answers for this business.
Set a Q&A task for my clinic's Google listing.
GET /v3/business_data/google/questions_and_answers/tasks_ready List finished Google Q&A tasks · Google questions and answers tasks ready #
Ask an LLM
“Which Google questions and answers tasks are ready?”
“Have my queued business Q&A pulls finished?”
Tell an agent
List completed Google Q&A tasks I haven't collected.
Check which questions and answers tasks are ready.
GET /v3/business_data/google/questions_and_answers/task_get/{id} Get Google Q&A collected by a task · Google questions and answers task get #
Ask an LLM
“What questions and answers came back from my Google Q&A task?”
“Can I retrieve a business's Q&A for a task I already set?”
Tell an agent
Fetch the Google questions and answers for task {id}.
Get the Q&A collected by task {id}.
POST /v3/business_data/google/questions_and_answers/live Get a business's Google Q&A in real time · Google questions and answers live #
Ask an LLM
“Can I see the questions and answers on a business's Google profile right now?”
“Is there a live way to pull Google Q&A without waiting for a task?”
Tell an agent
Pull the Google questions and answers for this business live.
Get real-time Q&A from my store's Google listing.
POST /v3/business_data/trustpilot/search/task_post Queue a Trustpilot business search · Trustpilot search task post #
Ask an LLM
“Which Trustpilot business profiles match a keyword?”
“Can I search Trustpilot for companies in my niche?”
Tell an agent
Queue a Trustpilot search task for businesses matching 'web hosting'.
Set a Trustpilot business search for this keyword.
GET /v3/business_data/trustpilot/search/tasks_ready List finished Trustpilot search tasks · Trustpilot search tasks ready #
Ask an LLM
“Which Trustpilot search tasks are ready to collect?”
“Have my queued Trustpilot business searches finished?”
Tell an agent
List completed Trustpilot search tasks I haven't collected.
Check which Trustpilot business search tasks are ready.
GET /v3/business_data/trustpilot/search/task_get/{id} Get Trustpilot business search results · Trustpilot search task get #
Ask an LLM
“What Trustpilot business profiles came back from my search task?”
“Can I retrieve the companies found by a Trustpilot search I queued?”
Tell an agent
Fetch the Trustpilot search results for task {id}.
Get the business profiles found by Trustpilot search task {id}.
POST /v3/business_data/trustpilot/reviews/task_post Queue a Trustpilot reviews task for a domain · Trustpilot reviews task post #
Ask an LLM
“What are customers saying about a company on Trustpilot?”
“Can I collect Trustpilot reviews for a business by its domain?”
Tell an agent
Queue a task to collect Trustpilot reviews for example.com.
Set a Trustpilot reviews task for my company's domain.
GET /v3/business_data/trustpilot/reviews/tasks_ready List finished Trustpilot reviews tasks · Trustpilot reviews tasks ready #
Ask an LLM
“Which Trustpilot reviews tasks are ready?”
“Have my queued Trustpilot review pulls finished?”
Tell an agent
List completed Trustpilot reviews tasks I haven't collected.
Check which Trustpilot review tasks are ready.
GET /v3/business_data/trustpilot/reviews/task_get/{id} Get Trustpilot reviews collected by a task · Trustpilot reviews task get #
Ask an LLM
“What Trustpilot reviews came back for the company in my task?”
“Can I retrieve the Trustpilot review results for a task I already set?”
Tell an agent
Fetch the Trustpilot reviews for task {id}.
Get the reviews collected by Trustpilot reviews task {id}.
GET /v3/business_data/tripadvisor/locations List Tripadvisor locations · Tripadvisor locations #
Ask an LLM
“Which cities and regions can I target in Tripadvisor tasks?”
“Where do I find location codes for Tripadvisor searches?”
Tell an agent
List all locations supported for Tripadvisor tasks.
Get every Tripadvisor city and region location code.
GET /v3/business_data/tripadvisor/locations/{country} List Tripadvisor locations in one country · Tripadvisor locations country #
Ask an LLM
“Which Tripadvisor cities and regions are available in a single country?”
“Can I narrow Tripadvisor location codes to one country?”
Tell an agent
List Tripadvisor locations in country {country}.
Get the Tripadvisor city and region codes for {country}.
GET /v3/business_data/tripadvisor/languages List Tripadvisor languages · Tripadvisor languages #
Ask an LLM
“Which languages can I use in Tripadvisor tasks?”
“What language codes are valid for Tripadvisor reviews?”
Tell an agent
List the languages supported for Tripadvisor tasks.
Get the Tripadvisor language codes.
POST /v3/business_data/tripadvisor/search/task_post Queue a Tripadvisor business search · Tripadvisor search task post #
Ask an LLM
“Which restaurants or attractions does Tripadvisor list for a keyword in a city?”
“Can I search Tripadvisor business profiles by keyword and location?”
Tell an agent
Queue a Tripadvisor search task for Italian restaurants in Rome.
Set a Tripadvisor business search for this keyword and city.
GET /v3/business_data/tripadvisor/search/tasks_ready List finished Tripadvisor search tasks · Tripadvisor search tasks ready #
Ask an LLM
“Which Tripadvisor search tasks are ready to collect?”
“Have my queued Tripadvisor business searches finished?”
Tell an agent
List completed Tripadvisor search tasks I haven't collected.
Check which Tripadvisor business search tasks are ready.
GET /v3/business_data/tripadvisor/search/task_get/{id} Get Tripadvisor business search results · Tripadvisor search task get #
Ask an LLM
“What businesses came back from my Tripadvisor search task?”
“Can I retrieve the Tripadvisor listings found by a search I queued?”
Tell an agent
Fetch the Tripadvisor search results for task {id}.
Get the businesses found by Tripadvisor search task {id}.
POST /v3/business_data/tripadvisor/reviews/task_post Queue a Tripadvisor reviews task · Tripadvisor reviews task post #
Ask an LLM
“What are travelers saying about a hotel or restaurant on Tripadvisor?”
“Can I collect Tripadvisor reviews by URL path or keyword?”
Tell an agent
Queue a task to collect Tripadvisor reviews for this hotel's page.
Set a Tripadvisor reviews task for my restaurant.
GET /v3/business_data/tripadvisor/reviews/tasks_ready List finished Tripadvisor reviews tasks · Tripadvisor reviews tasks ready #
Ask an LLM
“Which Tripadvisor reviews tasks are ready?”
“Have my queued Tripadvisor review pulls finished?”
Tell an agent
List completed Tripadvisor reviews tasks I haven't collected.
Check which Tripadvisor review tasks are ready.
GET /v3/business_data/tripadvisor/reviews/task_get/{id} Get Tripadvisor reviews collected by a task · Tripadvisor reviews task get #
Ask an LLM
“What ratings and review text came back from my Tripadvisor reviews task?”
“Can I retrieve Tripadvisor review results for a task I already set?”
Tell an agent
Fetch the Tripadvisor reviews for task {id}.
Get the ratings and reviews collected by Tripadvisor task {id}.
POST /v3/business_data/social_media/pinterest/live Count Pinterest saves for page URLs · Social media pinterest live #
Ask an LLM
“How many times has my page been saved to Pinterest?”
“Can I check Pinterest pin counts for a list of URLs?”
Tell an agent
Get the Pinterest save counts for these page URLs.
Check how many pins my blog post has on Pinterest.
POST /v3/business_data/social_media/reddit/live Find Reddit shares of a webpage · Social media reddit live #
Ask an LLM
“Where has my webpage been shared on Reddit and by whom?”
“Which subreddits posted a link to a URL and how many members do they have?”
Tell an agent
Find the Reddit shares of this webpage with subreddit and author.
List Reddit posts that shared my article URL.

Documentation

📖
Documentation
https://docs.dataforseo.com/v3/business_data/overview/
📖
APIReference
https://docs.dataforseo.com/v3/business_data/overview/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/openapi/dataforseo-businessdata-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/json-schema/dataforseo-business-data-schema.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/overlays/dataforseo-businessdata-overlay.yaml
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/examples/dataforseo-business-data-examples.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/dataforseo:dataforseo-businessdata-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

dataforseo-businessdata-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: DataForSEO Business Data API
  description: DataForSEO API is the starting point on your journey towards building powerful SEO software. With DataForSEO you can get all the data you need to build an efficient application while also saving your time and budget. DataForSEO API is using the REST technology for interchanging data between your application and our service. The data exchange is made through the widely used HTTP protocol, which allows applying our API to almost all programming languages.
  version: 1.0.0
servers:
- url: https://api.dataforseo.com
- url: https://sandbox.dataforseo.com
tags:


# --- truncated at 32 KB (406 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/openapi/dataforseo-businessdata-api-openapi.yml