Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Get Google My Business Updates Results by id

Felo API Support
MIT
服务器:https://openapi.felo.ai
客户端库
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO 操作

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.

路径参数
  • id
    类型: string
    必填

    DataForSEO task ID.

响应
  • 200
    类型: object

    Successful response

    • items
      类型: array string[]

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

    • items.author
      类型: string

      author of the post

    • items.images_url
      类型: string

      url of an image included in the post

    • 类型: array string[]

      links included in the post

    • items.position
      类型: string

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

    • items.post_date
      类型: string

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

    • items.post_text
      类型: string

      main content of a post

    • items.rank_absolute
      类型: integer

      absolute rank among all the listed updates absolute position among all present elements

    • items.rank_group
      类型: integer

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

    • items.snippet
      类型: string

      additional content of a post

    • items.timestamp
      类型: string

      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

    • items.title
      类型: string

      anchor text

    • items.type
      类型: string

      type of a link element can take the following values: link_element

    • items.url
      类型: string

      url of a page the link is pointing at

    • items.xpath
      类型: string

      the XPath of the element

    • result
      类型: array string[]

      array of results

    • result.business_updates_id
      类型: string

      identifier of the business updates element in SERP

    • result.check_url
      类型: string

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

    • result.cid
      类型: string

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

    • result.datetime
      类型: string

      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

    • result.feature_id
      类型: string

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

    • result.item_types
      类型: array string[]

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

    • result.items_count
      类型: integer

      item types the number of items in the items array

    • result.keyword
      类型: string

      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

    • result.language_code
      类型: string

      language code in a POST array

    • result.location_code
      类型: integer

      location code in a POST array

    • result.se_domain
      类型: string

      search engine domain as specified in a POST array

    • tasks
      类型: array string[]

      array of tasks

    • tasks.cost
      类型: number

      cost of the task, USD

    • tasks.data
      类型: object

      contains the same parameters that you specified in the POST request

    • tasks.id
      类型: string

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

    • tasks.path
      类型: array string[]

      URL path

    • tasks.result_count
      类型: integer

      number of elements in the result array

    • tasks.status_code
      类型: integer

      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

    • tasks.status_message
      类型: string

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

    • tasks.time
      类型: string

      execution time, seconds

    • version
      类型: string

      the current version of the API

    • version.cost
      类型: number

      total tasks cost, USD

    • version.status_code
      类型: integer

      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

    • version.status_message
      类型: string

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

    • version.tasks_count
      类型: integer

      the number of tasks in the tasks array

    • version.tasks_error
      类型: integer

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

    • version.time
      类型: string

      execution time, seconds

    application/json
  • 400

    Bad request

  • 401

    Unauthorized

  • 402

    The request cannot proceed because a billing requirement is not met.

  • 403

    The account is not permitted to perform this operation.

  • 429

    Rate limit exceeded

  • 500

    Internal server error

  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    The operation failed. Keep the response request ID when contacting Felo support.

Request Example for get/v1/beta/dataforseo/business_data/google/my_business_updates/task_get/{id}
curl 'https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/my_business_updates/task_get/{id}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "version": "string",
  "version.status_code": 1,
  "version.status_message": "string",
  "version.time": "string",
  "version.cost": 1,
  "version.tasks_count": 1,
  "version.tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "result": [
    "string"
  ],
  "result.keyword": "string",
  "result.se_domain": "string",
  "result.location_code": 1,
  "result.language_code": "string",
  "result.check_url": "string",
  "result.datetime": "string",
  "result.business_updates_id": "string",
  "result.cid": "string",
  "result.feature_id": "string",
  "result.item_types": [
    "string"
  ],
  "result.items_count": 1,
  "items": [
    "string"
  ],
  "items.type": "string",
  "items.rank_group": 1,
  "items.rank_absolute": 1,
  "items.position": "string",
  "items.xpath": "string",
  "items.author": "string",
  "items.snippet": "string",
  "items.post_text": "string",
  "items.url": "string",
  "items.images_url": "string",
  "items.post_date": "string",
  "items.timestamp": "string",
  "items.links": [
    "string"
  ],
  "items.title": "string"
}

Successful response

Get Google My Business Updates Results by id