Business Reviews Google
dataforseo/business_reviews_google_submitSubmit a business reviews google task for later retrieval.
- call
- Price: —
- DataForSEO
- 3 min
Overview
Starts an asynchronous business reviews google request. Save the returned gateway run ID and supplier task ID and use the matching get operation to retrieve the result.
A task identifier and submission status.
Input
These go in the input object of the run request.
| Field | Type | Required | Description |
|---|---|---|---|
| keyword | string | No | Keyword. Required if you don't specify cid or place_id the keyword you specify should indicate the name of the local establishment. |
| cid | string | No | Unique, google-defined id of the business entity. Required if you don't specify keyword or place_id. |
| place_id | string | No | Identifier of the business entity in Google Maps. Required if you don't specify keyword or cid. |
| location_name | string | No | Full name of search engine location. Required if you don't specify location_code or location_coordinate. |
| location_code | integer | No | Search engine location code. Required if you don't specify location_name or location_coordinate. |
| location_coordinate | string | No | GPS coordinates of a location. Required if you don't specify location_name or location_code. |
| language_name | string | No | Full name of search engine language. Required if you don't specify language_code. |
| language_code | string | No | Search engine language code. Required if you don't specify language_name. |
Requests up to 1 MB.
Example
Use your own API key and a saved idempotency key for each new job. Replace image or media placeholders with your own publicly reachable HTTPS URLs. Keep the same key and request body when recovering a timeout.
# Set once per job; reuse this key and the identical body after a timeout.
: "${AGENTSKY_IDEMPOTENCY_KEY:?Set a unique, saved key for this job}"
curl --fail-with-body https://gateway.agentsky.dev/v1/run \
-H "authorization: Bearer $AGENTSKY_API_KEY" \
-H "content-type: application/json" \
-H "Idempotency-Key: $AGENTSKY_IDEMPOTENCY_KEY" \
-d '{"provider":"dataforseo","endpoint":"business_reviews_google_submit","input":{"keyword":"hedonism wines","location_name":"London,England,United Kingdom","language_name":"English"}}'
# If status is READY/RUNNING, poll GET /v1/runs/{runId} with the same API key.Pricing
— per call using your plan when signed in. Read the final customer charge from price.amount.value after the run finishes. A RUNNING response is not the final bill.