Parser API reference

Tripadvisor Place Details Scraper

Collect detailed Tripadvisor place profiles by URL: ratings, review counts, address, coordinates, contacts, opening hours, photos and available category-specific data for hotels, restaurants and attractions.

Run scraper Overview and sample data

Queue a task

Send JSON with this parser’s settings inside input. Use your Extracto API key in the X-API-KEY header. The queue returns a saved task ID so you can retrieve the result when it is ready. Replace the example Idempotency-Key with a new unique key for each intentional task and reuse it only for retries of that task.

Current pricing: $1.5 / 1,000 results
Review the estimate before running. Sending this example starts a real task and can spend credits.

POST · queue endpoint

https://extracto.cloud/api/v1/parsers/tripadvisor-place-details-scraper/queue

cURL · queue a task

curl --request POST 'https://extracto.cloud/api/v1/parsers/tripadvisor-place-details-scraper/queue' \
  --header 'X-API-KEY: ext_your_api_key' \
  --header 'Idempotency-Key: replace_with_a_new_unique_task_key' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data-binary @- <<'JSON'
{
  "input": {
    "detailUrls": [
      "https://www.tripadvisor.com/Restaurant_Review-g60763-d425330-Reviews-Keens_Steakhouse-New_York_City_New_York.html"
    ]
  }
}
JSON

The following response is illustrative. Save the actual run.id returned by your request.

202 Accepted · example response

{
  "success": true,
  "queued": true,
  "run": {
    "id": "7e1e15c2-2db4-4c17-a713-5432f47fb40f",
    "tool": "tripadvisor-place-details-scraper",
    "status": "queued"
  },
  "status_url": "https://extracto.cloud/api/v1/parser-runs/7e1e15c2-2db4-4c17-a713-5432f47fb40f",
  "result_url": "https://extracto.cloud/api/v1/parser-runs/7e1e15c2-2db4-4c17-a713-5432f47fb40f/results"
}

Get your results

Check status about once every five seconds while the task is queued or running. Stop at ok, partial, cancelled or error. Both requests require the API key of the account that created the task.

cURL · check status

curl 'https://extracto.cloud/api/v1/parser-runs/7e1e15c2-2db4-4c17-a713-5432f47fb40f?include_result=0' \
  --header 'X-API-KEY: ext_your_api_key' \
  --header 'Accept: application/json'

cURL · read saved results

curl 'https://extracto.cloud/api/v1/parser-runs/7e1e15c2-2db4-4c17-a713-5432f47fb40f/results?limit=100' \
  --header 'X-API-KEY: ext_your_api_key' \
  --header 'Accept: application/json'

Result pages contain items. Pass next_cursor as the next request’s cursor until it is null. Read run.error in the status response when a task fails.

See the shared guides for result webhooks, safe retries, and errors and limits.

Overview

Collection scope

Provide 1–20 direct tripadvisor.com hotel, restaurant or attraction URLs. One returned place profile counts as one result. This scraper does not search city listings or paginate all reviews. Contacts, hours, prices, photos and other details depend on the place and current source availability. Different place types return different fields.

Using Extracto

Extracto provides a web interface and HTTP API for submitting scraping tasks, tracking their status and retrieving structured results. Some parsers use third-party scraping providers for execution. Your Extracto account, API key and credit balance are managed at extracto.cloud.

Create an account at https://extracto.cloud/register, confirm your email and create an API key at https://extracto.cloud/api-keys. You can also configure and run this parser in the web interface at https://extracto.cloud/marketplace/tripadvisor-place-details-scraper.

Pricing and credits

Current Extracto price: $1.5 / 1,000 results. Extracto charges your credit balance for parser usage. Your package or top-up amount determines the purchase price per 1,000 credits. Listed parser prices use the base credit rate; volume discounts reduce the effective cash cost. The displayed rate includes Extracto pricing; additional enabled options are shown in the estimate. Verified accounts receive 2,500 free credits every month. The free balance resets to 2,500 on the first day of each month at 00:00 UTC, without rollover. Free credits are spent first. Purchased credits do not expire. Free credits held for an active task remain reserved until it finishes; unused amounts from an expired month then expire. Review the cost estimate in the web interface or POST your request body to https://extracto.cloud/api/v1/parsers/tripadvisor-place-details-scraper/estimate before launching a task. An estimate does not start scraping. Credit packages are listed at https://extracto.cloud/pricing; billing details are at https://extracto.cloud/docs#billing.

Input

Send JSON with the parser settings inside an input object. The example is a starting point: replace the sources and limits with your own permitted targets. Launching it starts a real task and can spend credits.

JSON · Input

{
    "input": {
        "detailUrls": [
            "https://www.tripadvisor.com/Restaurant_Review-g60763-d425330-Reviews-Keens_Steakhouse-New_York_City_New_York.html"
        ]
    }
}

detailUrls (array, required)

Requests and authentication

Use your Extracto key in the X-API-KEY header. Send Content-Type: application/json and Accept: application/json. Keep the key private on your server.

POST https://extracto.cloud/api/v1/parsers/tripadvisor-place-details-scraper?wait=1 — explicitly request a synchronous result. Successful output is in data, with the result count in count and usage in meta.credits. POST https://extracto.cloud/api/v1/parsers/tripadvisor-place-details-scraper/queue — submit a queued task. Save run.id from the HTTP 202 response. GET https://extracto.cloud/api/v1/parser-runs/{run_id}/results?limit=100 — retrieve saved items in pages. Pass next_cursor as cursor until it is null. Results require the task owner account API key. GET https://extracto.cloud/api/v1/parser-runs?status=ready — list terminal tasks; restart each polling cycle without a cursor to include older tasks that finished later. GET https://extracto.cloud/api/v1/parser-runs/{run_id} — check a saved task using the same account's API key. Poll about once every five seconds while its status is queued or running. Stop at ok, partial, cancelled or error. Saved results are in run.result; failures are described in run.error.

Integration examples, response formats, errors and limits: https://extracto.cloud/docs.

Output

Returned fields depend on the parser, input and source availability. A successful task can return no matching records. Availability and completion time can change when the source website changes. The following sample is illustrative documentation data, not a customer run or a guarantee of results:

JSON · Output

[
    {
        "name": "Keens Steakhouse",
        "category": "restaurant",
        "locationId": 425330,
        "averageRating": 4.5,
        "reviewCount": 7034,
        "address": "72 West 36th Street, New York City, NY 10018",
        "contactPhone": "+1 212-947-3636",
        "website": "http://www.keens.com",
        "inputUrl": "https://www.tripadvisor.com/Restaurant_Review-g60763-d425330-Reviews-Keens_Steakhouse-New_York_City_New_York.html"
    }
]

name (string): Place. Optional when not supplied for this place type.
category (string): Type. Optional when not supplied for this place type.
averageRating (number): Overall traveller rating; some source categories return it as text.
reviewCount (number): Reviews. Optional when not supplied for this place type.
ranking (string): Ranking. Optional when not supplied for this place type.
contactPhone (string): Phone. Optional when not supplied for this place type.
email (string): Restaurant or attraction email when publicly returned.
contactEmail (string): Hotel contact email when publicly returned.
website (string): Website. Optional when not supplied for this place type.
address (string): Address. Optional when not supplied for this place type.
coordinates (object): Coordinates. Optional when not supplied for this place type.
cuisines (array): Cuisines. Optional when not supplied for this place type.
priceLevel (string): Price level. Optional when not supplied for this place type.
openHours (object): Opening hours. Optional when not supplied for this place type.
amenities (array): Amenities. Optional when not supplied for this place type.
prices (array): Available hotel-provider quotes for the source request; amounts and taxes depend on dates and availability.
images (array): Photos. Optional when not supplied for this place type.
reviews (array): Reviews embedded in the place page; not a complete paginated review collection.
pageKind (string): Page kind. Optional when not supplied for this place type.
locationId (number): Location id. Optional when not supplied for this place type.
subRatings (object): Sub ratings. Optional when not supplied for this place type.
ratingHistogram (object): Rating histogram. Optional when not supplied for this place type.
description (string): Description. Optional when not supplied for this place type.
mealsServed (array): Meals served. Optional when not supplied for this place type.
dietaryRestrictions (array): Dietary restrictions. Optional when not supplied for this place type.
features (array): Features. Optional when not supplied for this place type.
establishmentTypes (array): Establishment types. Optional when not supplied for this place type.
priceCategory (string): Price category. Optional when not supplied for this place type.
priceRange (object): Price range. Optional when not supplied for this place type.
openStatus (object): Open status. Optional when not supplied for this place type.
isClaimed (boolean): Is claimed. Optional when not supplied for this place type.
isClosed (boolean): Is closed. Optional when not supplied for this place type.
menuUrl (string): Menu url. Optional when not supplied for this place type.
menu (array): Menu. Optional when not supplied for this place type.
popularDishes (array): Popular dishes. Optional when not supplied for this place type.
reviewKeywords (array): Review keywords. Optional when not supplied for this place type.
reviewCountByLanguage (array): Language counts as returned by the source; translated and original review sets may overlap.
travelersChoiceAward (object): Travelers choice award. Optional when not supplied for this place type.
bestNearby (object): Best nearby. Optional when not supplied for this place type.
parentLocation (string): Parent location. Optional when not supplied for this place type.
isoCountryCode (string): Iso country code. Optional when not supplied for this place type.
video (array): Video. Optional when not supplied for this place type.
insiderTips (array): Insider tips. Optional when not supplied for this place type.
insiderTipsCount (number): Insider tips count. Optional when not supplied for this place type.
inputUrl (string): The requested Tripadvisor place URL.
starRating (string): Star rating. Optional when not supplied for this place type.
reviewSubratings (object): Review subratings. Optional when not supplied for this place type.
roomFeatures (array): Room features. Optional when not supplied for this place type.
roomTypes (array): Room types. Optional when not supplied for this place type.
languagesSpoken (array): Languages spoken. Optional when not supplied for this place type.
styleRankings (array): Style rankings. Optional when not supplied for this place type.
photoCount (number): Photo count. Optional when not supplied for this place type.
walkScore (number): Walk score. Optional when not supplied for this place type.
nearbyRestaurantsCount (number): Nearby restaurants count. Optional when not supplied for this place type.
nearbyAttractionsCount (number): Nearby attractions count. Optional when not supplied for this place type.
nearbyAttractions (array): Nearby attractions. Optional when not supplied for this place type.
nearbyRestaurants (array): Nearby restaurants. Optional when not supplied for this place type.
gettingThere (object): Getting there. Optional when not supplied for this place type.
aiReviewSummary (string): Ai review summary. Optional when not supplied for this place type.
suggestedDuration (string): Suggested duration. Optional when not supplied for this place type.
neighborhood (object): Neighborhood. Optional when not supplied for this place type.
qAndA (array): Q and a. Optional when not supplied for this place type.
qAndACount (number): Q and acount. Optional when not supplied for this place type.

Example uses

Build profiles for specific hotels, restaurants and attractions.
Compare ratings, location, contacts and available amenities across selected places.
Export place data as CSV, JSON or XLSX for your own reports and applications.

Responsible use and support

Use this parser only for data you are permitted to access and process. Follow applicable laws, source website terms and Extracto's acceptable-use policy: https://extracto.cloud/acceptable-use. For help, email [email protected] and include the parser name and run ID. Never send your API key. Terms: https://extracto.cloud/terms Privacy: https://extracto.cloud/privacy Refund policy: https://extracto.cloud/refund-policy