Felo API PlatformFelo API Platform

Data API / DataForSEO / Business Data

Get Business Data Google Extended Reviews Results by id

Retrieves queued the full Google review history for a business, past the first page the standard endpoint returns by id. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. ⚠️ Size scales with the depth set at submit and cannot be narrowed here.

Parameters

path

  • idstringRequired

    DataForSEO task ID.

Example request

curl -X GET "https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/extended_reviews/task_get/{id}" \
  -H "Authorization: Bearer $FELO_API_KEY"

Response

Response fields

  • versionstringOptional

    the current version of the API

  • status_codeintegerOptional

    general status code you can find the full list of the response codes here Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions

  • status_messagestringOptional

    general informational message you can find the full list of general informational messages here

  • timestringOptional

    execution time, seconds

  • costnumberOptional

    *total tasks cost, USD*

  • tasks_countintegerOptional

    *the number of tasks in the tasks array*

  • tasks_errorintegerOptional

    *the number of tasks in the tasks array that were returned an error*

  • tasksstring[]Optional

    array of tasks

  • idstringOptional

    task identifier unique task identifier in our system in the UUID format

  • status_codeintegerOptional

    status code of the task generated by DataForSEO; can be within the following range: 10000-60000 you can find the full list of the response codes here

  • status_messagestringOptional

    informational message of the task you can find the full list of general informational messages here

  • timestringOptional

    execution time, seconds

  • costnumberOptional

    cost of the task, USD

  • result_countintegerOptional

    number of elements in the result array

  • pathstring[]Optional

    URL path

  • dataobjectOptional

    contains the same parameters that you specified in the POST request

  • resultstring[]Optional

    array of results

  • keywordstringOptional

    keyword received in a POST array keyword is returned with decoded %## (plus character ‘+’ will be decoded to a space character)

  • typestringOptional

    search engine type in a POST array

  • se_domainstringOptional

    search engine domain in a POST array

  • location_codeintegerOptional

    location code in a POST array

  • language_codestringOptional

    language code in a POST array

  • check_urlstringOptional

    direct URL to search engine results you can use it to make sure that we provided accurate results

  • datetimestringOptional

    date and time when the result was received in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00

  • titlestringOptional

    title of the ‘reviews’ element in SERP the name of the local establishment for which the reviews are collected

  • sub_titlestringOptional

    subtitle of the ‘reviews’ element in SERP additional information (e.g., address) on the ‘reviews’ element for which the reviews are collected

  • ratingobjectOptional

    rating of the corresponding local establishment popularity rate based on reviews and displayed in SERP

  • rating_typestringOptional

    type of rating here you can find the following elements: Max5, Percents, CustomMax

  • valuenumberOptional

    the average rating based on all reviews

  • votes_countintegerOptional

    the number of votes

  • rating_maxintegerOptional

    the maximum value for a rating_type

  • feature_idstringOptional

    the unique identifier of the ‘reviews’ element in SERP learn more about the identifier in this help center article

  • place_idstringOptional

    unique identifier of a business location assigned by Google learn more about the identifier in this help center article

  • cidstringOptional

    google-defined client id unique id of a local establishment learn more about the identifier in this help center article

  • reviews_countintegerOptional

    the total number of reviews

  • items_countintegerOptional

    the number of reviews items in the results array you can get more results by using the depth parameter when setting a task

  • itemsstring[]Optional

    found reviews you can get more results by using the depth parameter when setting a task

  • typestringOptional

    *type of element = ‘images\_element’*

  • rank_groupintegerOptional

    position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group

  • rank_absoluteintegerOptional

    absolute rank among all the listed reviews absolute position among all reviews on the list

  • positionstringOptional

    the alignment of the review in SERP can take the following values: right

  • xpathstringOptional

    the XPath of the review

  • review_textstringOptional

    the content of the review

  • original_review_textstringOptional

    original content of the review the original content of the review, no auto-translate applied

  • time_agostringOptional

    the time of publication indicates the time (in the ‘time ago’ format) when the review was listed

  • timestampstringOptional

    date and time when a review was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00

  • ratingobjectOptional

    the rating score submitted by the reviewer

  • rating_typestringOptional

    the type of the rating can take the following values: Max5, CustomMax

  • valuenumberOptional

    the value of the rating

  • votes_countintegerOptional

    the amount of feedback indicated the number of votes the review obtained

  • rating_maxintegerOptional

    the maximum value for a rating_type the maximum value for Max5 is 5

  • reviews_countintegerOptional

    total number of reviews submitted by the reviewer

  • photos_countintegerOptional

    total number of photos submitted by the reviewer

  • local_guidebooleanOptional

    indicates whether the reviewer has a ‘local guide’ status

  • profile_namestringOptional

    profile name of the reviewer

  • profile_urlstringOptional

    URL of the reviewer’s profile

  • review_urlstringOptional

    the URL of the review

  • profile_image_urlstringOptional

    URL of the reviewer’s profile image

  • owner_answerstringOptional

    text of the owner’s response the owner’s response to the review

  • original_owner_answerstringOptional

    original text of the owner’s response the original response to the review, no auto-translate applied

  • owner_time_agostringOptional

    publication time indicates the time (in the ‘time ago’ format) when the owner submitted the response to the review

  • owner_timestampstringOptional

    date and time of the owner’s reply to the review in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00

  • review_idstringOptional

    the unique identifier of a review on Google example: ChZDSUhNMG9nS0VJQ0FnSUMxbHFyMFlnEAE

  • imagesstring[]Optional

    images submitted by the reviewer

  • altstringOptional

    alt tag of the image

  • image_urlstringOptional

    URL of the image featured in the review

  • review_highlightsstring[]Optional

    review highlights contains highlighted review criteria and assessments

  • featurestringOptional

    reviewed feature

  • assessmentstringOptional

    feature assessment

  • sourceobjectOptional

    source of the review contains information about the source where the review was posted

  • titlestringOptional

    name of the source where the review was posted

  • imagestringOptional

    featured image of the source

  • domainstringOptional

    domain of the source where the review was posted