C# SDK engine

Google Ads Transparency

Поиск рекламных креативов из Google Ads Transparency Center по advertiser_id или тексту/домену с фильтрами по платформе, региону, датам и формату.

engine: google_ads_transparency_center constant: XylopSearchEngines.GoogleAdsTransparencyCenter GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

var client = new XylopSearchClient(new HttpClient(), "YOUR_API_KEY");

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleAdsTransparencyCenter,
    new Dictionary<string, string?>
    {
        ["advertiser_id"] = "AR17828074650563772417",
        ["text"] = "apple.com",
        ["region"] = "2840",
        ["platform"] = "SEARCH",
        ["creative_format"] = "image",
    });

Для типизированного режима используйте `SearchAsync<TResponse>` и response-модель из `Xylop.Logic.SerpApiResponses.*`, которая входит в пакет C# SDK.

Endpoint

HTTP контракт

URL: https://api.xylop.ru/search
Engine: google_ads_transparency_center
API key: Передается SDK автоматически из настроек клиента.

Входные параметры

Параметры запроса

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_ads_transparency_center`	Движок Google Ads Transparency Center.
`advertiser_id`	string	Нет	`AR17828074650563772417`	Google Advertiser ID. Можно передать несколько ID через запятую.
`text`	string	Нет	apple.com	Альтернатива advertiser_id: текст или домен для поиска.
`region`	string	Нет	`2840`	Регион Ads Transparency Center.
`platform`	string	Нет	SEARCH	PLAY, MAPS, SEARCH, SHOPPING или YOUTUBE.
`creative_format`	string	Нет	image	text, image или video.
`political_ads`	string	Нет	`false`	Для true обязательно укажи region.
`num`	number	Нет	`40`	Количество креативов в ответе.
`next_page_token`	string	Нет	CgoA...	Токен следующей страницы.

Выходные параметры

Поля ответа

Поле	Тип	Источник	Описание
`search_metadata`	object	пример ответа	Метаданные запроса: статус, идентификатор, время выполнения и служебная информация провайдера.
`search_parameters`	object	пример ответа	Нормализованные параметры, с которыми upstream-поиск выполнил запрос.
`search_information`	object	пример ответа	Сводка по выдаче: примерное число результатов, время поиска и дополнительные статусы.
`ad_creatives`	array	пример ответа	Типизированное поле ответа для этого engine; структура зависит от upstream-провайдера и параметров запроса.
`pagination`	object	пример ответа	Данные пагинации или токены для перехода к следующей странице.

JSON

Пример ответа

{
  "search_metadata": {
    "status": "Success",
    "google_ads_transparency_center_url": "https://adstransparency.google.com/advertiser/AR17828074650563772417?region=US"
  },
  "search_parameters": {
    "engine": "google_ads_transparency_center",
    "advertiser_id": "AR17828074650563772417",
    "region": "2840"
  },
  "search_information": {
    "total_results": 200
  },
  "ad_creatives": [
    {
      "advertiser_id": "AR17828074650563772417",
      "advertiser": "Tesla Inc.",
      "ad_creative_id": "CR04179139827687489537",
      "format": "text",
      "image": "https://tpc.googlesyndication.com/archive/simgad/11385273875406013460",
      "width": 380,
      "height": 239,
      "first_shown": 1691712612,
      "last_shown": 1696917405,
      "details_link": "https://adstransparency.google.com/advertiser/AR17828074650563772417/creative/CR04179139827687489537?region=US"
    }
  ],
  "pagination": {
    "next_page_token": "CgoAP7zn5UyV..."
  }
}