Felo API PlatformFelo API Platform

Data API / DataForSEO / Business Data

Get Google My Business Updates Results by id

Retrieves queued Google Business Profile updates by id: each post with its text, media and date. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200.

Parameters

path

  • idstringRequired

    DataForSEO task ID.

Example request

curl -X GET "https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/my_business_updates/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) this field will contain the cid parameter if you specified it in the keyword field when setting a task; example: cid:2946633002421908862 learn more about the parameter in this help center article

  • se_domainstringOptional

    search engine domain as specified 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

  • business_updates_idstringOptional

    identifier of the business updates element in SERP

  • cidstringOptional

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

  • feature_idstringOptional

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

  • item_typesstring[]Optional

    item types types of search engine results encountered in the items array; possible item types: google_business_post

  • items_countintegerOptional

    item types the number of items in the items array

  • itemsstring[]Optional

    encountered item types types of search engine results encountered in the items array; possible item types: google_business_post

  • typestringOptional

    type of a link element can take the following values: link_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 updates absolute position among all present elements

  • positionstringOptional

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

  • xpathstringOptional

    the XPath of the element

  • authorstringOptional

    author of the post

  • snippetstringOptional

    additional content of a post

  • post_textstringOptional

    main content of a post

  • urlstringOptional

    url of a page the link is pointing at

  • images_urlstringOptional

    url of an image included in the post

  • post_datestringOptional

    date when a post was published in the following format: "mm/dd/yyyy hh:mm:ss"

  • timestampstringOptional

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

  • linksstring[]Optional

    links included in the post

  • titlestringOptional

    anchor text