Business Reviews Tripadvisor
dataforseo/business_reviews_tripadvisor_submitSubmit a business reviews tripadvisor task for later retrieval.
- call
- Price: —
- DataForSEO
- 3 min
Overview
Starts an asynchronous business reviews tripadvisor 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 |
|---|---|---|---|
| url_path | string | No | URL path of the business entity. Required if you do not specify keyword URL path to the Tripadvisor page of the business entity; examples: Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html https://www.tripadvisor.com/Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html. |
| keyword | string | No | Keyword. Required if you do not specify url_path the keyword you specify should indicate a name of an existing business or prominent place on Tripadvisor. |
| location_name | string | No | Full name of search engine location. Required if you don't specify location_code or url_path. |
| location_code | integer | No | Search engine location code. Required if you don't specify location_name or url_path. |
| language_code | string | No | Search engine language code. Optional. |
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_tripadvisor_submit","input":{"url_path":"Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html"}}'
# 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.