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

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/serp/google/ads_search/live/advanced`

**Tags:** DataForSEO

Синхронно повертає оголошення, що показуються за ключовим словом у 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.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "advertiser_ids": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Ідентифікатори рекламодавців; обов'язкові, якщо не вказано target"
      },
      "target": {
        "type": "string",
        "description": "Ім'я домену, пов'язане з акаунтом рекламодавця; обов'язкове, якщо advertiser_ids не вказано"
      },
      "location_name": {
        "type": "string",
        "description": "повна назва місцезнаходження пошукової системи"
      },
      "location_code": {
        "type": "integer",
        "description": "код місцезнаходження пошукової системи"
      },
      "location_coordinate": {
        "type": "string",
        "description": "GPS-координати місцезнаходження"
      }
    },
    "anyOf": [
      {
        "required": [
          "advertiser_ids"
        ]
      },
      {
        "required": [
          "target"
        ]
      }
    ]
  }
}
```

## Responses

### 200 — Успішна відповідь

Headers:
- `X-Request-Id` (string) — Ідентифікатор запиту, який потрібно вказати під час звернення до підтримки Felo.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "version": {
      "type": "string",
      "description": "поточна версія API"
    },
    "status_code": {
      "type": "integer",
      "description": "загальний код стану"
    },
    "status_message": {
      "type": "string",
      "description": "загальне інформаційне повідомлення"
    },
    "time": {
      "type": "string",
      "description": "час виконання, секунди"
    },
    "cost": {
      "type": "number",
      "description": "загальна вартість завдань, USD"
    },
    "tasks": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "масив завдань"
    },
    "tasks[].result": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "масив результатів SERP у реальному часі"
    }
  }
}
```

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

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

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

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

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

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

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

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

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

**application/json**

Schema:

```json
{}
```
