Felo API PlatformFelo API Platform
Усі endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Жива розширена реклама Google Ads

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клієнтські бібліотеки
Shell Curl

DataForSEO

​

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

DataForSEO Операції

Жива розширена реклама Google Ads

​

Синхронно повертає оголошення, що показуються за ключовим словом у Google. Повертає keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count і items. advanced — варіант за замовчуванням; беріть regular, коли потрібен лише ранжований список, і html — лише щоб перевірити, що загубив парсер. Відповідь обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200.

Довідкові ціни

  • Тарифікація: вартість відповіді за даними постачальника.
  • Довідкова оцінка запиту: USD 0.02.
  • Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.

Довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.

Тіло
application/json
  • Тип: array object[]
      • advertiser_ids
        Тип: array string[]
        обов'язкове

        Ідентифікатори рекламодавців; обов'язкові, якщо не вказано target

      • location_code
        Тип: integer

        код місцезнаходження пошукової системи

      • location_coordinate
        Тип: string

        GPS-координати місцезнаходження

      • location_name
        Тип: string

        повна назва місцезнаходження пошукової системи

      • target
        Тип: string

        Ім'я домену, пов'язане з акаунтом рекламодавця; обов'язкове, якщо advertiser_ids не вказано

Відповіді
  • 200
    Тип: object

    Успішна відповідь

    • cost
      Тип: number

      загальна вартість завдань, USD

    • status_code
      Тип: integer

      загальний код стану

    • status_message
      Тип: string

      загальне інформаційне повідомлення

    • tasks
      Тип: array string[]

      масив завдань

    • tasks[].result
      Тип: array string[]

      масив результатів SERP у реальному часі

    • time
      Тип: string

      час виконання, секунди

    • version
      Тип: string

      поточна версія API

    application/json
  • 400

    Не вдалося обробити запит. Перевірте параметри запиту.

  • 401

    Потрібен дійсний API-ключ Felo.

  • 402

    Запит неможливо виконати: умови білінгу не виконано.

  • 403

    Обліковий запис не має дозволу на цю операцію.

  • 429

    Досягнуто ліміту запитів або витрат.

  • 502

    Служба не змогла виконати запит.

  • 503

    API або служба білінгу тимчасово недоступні.

  • 504

    Час очікування обробки запиту вичерпано.

  • default

    Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

    application/json
Request Example for post/v1/beta/dataforseo/serp/google/ads_search/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ads_search/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {}
]'

{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks": [
    "string"
  ],
  "tasks[].result": [
    "string"
  ]
}

Успішна відповідь

Live Google Ads Search Advanced