> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cattix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Пошук по таблицях

> Серверна фільтрація пошуком для всіх ендпоінтів таблиць Google Ads

<Note>
  This page is also available in [English](/guides/table-search).
</Note>

## Огляд

Усі ендпоінти таблиць даних Google Ads тепер підтримують опціональний query
параметр `search`. Коли він вказаний, API фільтрує результати на сервері,
використовуючи **регістронезалежний пошук по підрядку** по визначених текстових
полях кожної таблиці.

Це розроблено для рядка пошуку в кожній таблиці даних на фронтенді.

***

## Як використовувати

Додайте `?search=<term>` до будь-якого GET ендпоінта таблиці даних:

```
GET /api/v1/google-ads/{customer_id}/campaigns?search=brand
GET /api/v1/google-ads/{customer_id}/ad-groups?search=shoes
GET /api/v1/google-ads/{customer_id}/keywords?search=buy+shoes
```

Той самий параметр працює для CSV ендпоінтів:

```
GET /api/v1/google-ads/{customer_id}/campaigns/csv?search=brand
```

### Правила параметра

| Властивість      | Значення                |
| ---------------- | ----------------------- |
| Назва            | `search`                |
| Тип              | `string` (опціональний) |
| Мін. довжина     | 1                       |
| Макс. довжина    | 200                     |
| За замовчуванням | `None` (без фільтрації) |

Якщо `search` не вказано (або передано порожнє значення), повертається повний
набір даних — повна зворотна сумісність.

***

## Поведінка пошуку

* **Регістронезалежний**: `"brand"` знайде `"Brand Campaign"`, `"BRAND"` тощо
* **Пошук по підрядку**: `"shoe"` знайде `"buy shoes online"`
* **OR логіка між полями**: рядок збігається, якщо **будь-яке** з його полів для
  пошуку містить пошуковий термін
* **Фільтрація після отримання даних**: пошук застосовується після отримання
  даних з Google Ads, тому працює по всіх полях, включаючи розгорнуті назви та
  заголовки RSA

***

## Поля для пошуку по таблицях

| Ендпоінт                  | Поля для пошуку                                                                 |
| ------------------------- | ------------------------------------------------------------------------------- |
| `/campaigns`              | `name`                                                                          |
| `/ad-groups`              | `name`, `campaign_name`                                                         |
| `/ads`                    | тексти заголовків, тексти описів, `final_url`, `campaign_name`, `ad_group_name` |
| `/keywords`               | `text`, назва кампанії, назва групи оголошень                                   |
| `/search-terms`           | `search_term`, `matched_keyword`, `campaign_name`, `ad_group_name`              |
| `/ad-schedule`            | `campaign_name`, `day_of_week`                                                  |
| `/locations`              | `campaign_name`, `location_name`                                                |
| `/user-locations`         | `campaign_name`, `most_specific_location`, `city`, `region`                     |
| `/geographic-performance` | `location_name`, `campaign_name`                                                |

***

## Приклади

### Фільтрувати кампанії за назвою

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.cattix.com/api/v1/google-ads/1234567890/campaigns?search=brand" \
    -H "Authorization: Bearer $TOKEN"
  ```

  ```python Python theme={null}
  import httpx

  resp = httpx.get(
      "https://api.cattix.com/api/v1/google-ads/1234567890/campaigns",
      params={"search": "brand", "start_date": "2025-01-01", "end_date": "2025-01-31"},
      headers={"Authorization": f"Bearer {token}"},
  )
  ```
</CodeGroup>

### Пошук оголошень за текстом заголовка

```
GET /api/v1/google-ads/1234567890/ads?search=free+shipping
```

Повертає лише оголошення, де будь-який заголовок або опис містить "free shipping".

### Пошук ключових слів по кампанії та групі оголошень

```
GET /api/v1/google-ads/1234567890/keywords?search=shoes
```

Повертає ключові слова, де текст ключового слова, назва кампанії **або** назва
групи оголошень містить "shoes".