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

Google Ads Status

服务器:https://openapi.felo.ai
客户端库

DataForSEO

​

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

Google Ads Status

​

Whether DataForSEO's Google Ads data is current: actual_data, date_update, last_year_in_monthly_searches and last_month_in_monthly_searches. Worth checking before a spend decision - it tells you how stale the monthly_searches arrays on every Google Ads response actually are.

响应
  • 200
    类型: object

    Successful response

    • cost
      类型: number

      total tasks cost, USD

    • 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

    • status_message
      类型: string

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

    • tasks
      类型: array string[]

      array of tasks

    • tasks_count
      类型: integer

      the number of tasks in the tasks array

    • tasks_error
      类型: integer

      the number of tasks in the tasks array returned with an error

    • tasks.cost
      类型: number

      cost of the task, USD

    • tasks.data
      类型: object

      the data specified in the API call

    • tasks.id
      类型: string

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

    • tasks.path
      类型: array string[]

      URL path

    • tasks.result
      类型: array string[]

      array of results

    • tasks.result_count
      类型: integer

      number of elements in the result array

    • tasks.result.actual_data
      类型: boolean

      indicates whether Google updated keyword data for the previous month generally, Google updates keyword data in the middle of the month if the value is true, Google currently provides up-to-date data for the previous month if the value is false, we are not able to provide data for the previous month

    • tasks.result.date_update
      类型: string

      date of the latest update of Google Ads data indicates the latest date when Google updated search volume, CPC, and other keyword metrics example: 2020-05-15

    • tasks.result.last_month_in_monthly_searches
      类型: integer

      the latest month for which search volume data is available

    • tasks.result.last_year_in_monthly_searches
      类型: integer

      the latest year for which search volume data is available

    • 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 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

    • time
      类型: string

      execution time, seconds

    • version
      类型: string

      the current version of the API

    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/keywords_data/google_ads/status
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/status \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "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": {},
  "tasks.result": [
    "string"
  ],
  "tasks.result.actual_data": true,
  "tasks.result.date_update": "string",
  "tasks.result.last_year_in_monthly_searches": 1,
  "tasks.result.last_month_in_monthly_searches": 1
}
Google Ads Status