Keyword Ads Search

Find English-language ads mentioning “Black Friday” that were active during November 2025.

Before you start

Install requests and set ATRIA_API_KEY.
Choose the keyword, language, and campaign dates to compare.

Workflow

Step	Request	Filter
Search the library	`GET /open/v1/ad-library/search`	`query` and `language`
Select the campaign window	Same request	`active_since` and `launched_before`
Collect results	Repeat the same query	Pass each returned `cursor`.

Python example

The example prints ad IDs, advertiser names, headlines, and CTA labels across all returned pages.

import os

import requests

BASE = "https://api.tryatria.com/open/v1"
HEADERS = {"X-API-Key": os.environ["ATRIA_API_KEY"]}


def call(method, path, **kwargs):
    response = requests.request(
        method,
        BASE + path,
        headers=HEADERS,
        timeout=30,
        **kwargs,
    )
    response.raise_for_status()
    payload = response.json()
    if payload.get("code") != 0:
        raise RuntimeError(
            f"API error {payload.get('code')}: {payload.get('message')}"
        )
    return payload["data"]


params = {
    "query": "black friday",
    "language": "en",
    "active_since": "2025-11-01",
    "launched_before": "2025-11-30",
    "order": "most_active",
    "page_size": 50,
}
while True:
    page = call("GET", "/ad-library/search", params=params)
    for ad in page["items"]:
        print(
            ad["id"],
            ad.get("brand_name") or "",
            ad.get("title") or "",
            ad.get("cta_text") or "",
        )

    cursor = page.get("cursor")
    if not cursor:
        break
    params["cursor"] = cursor

Filter choices

Parameter	Meaning
`query`	Search ad title, body, and advertiser name.
`language`	Filter by detected ad language; accepts repeatable ISO 639-1 codes.
`active_since`	Include ads still running on or after the date, even if they launched earlier.
`launched_before`	Include ads first launched on or before the date.
`order="most_active"`	Prioritize longer-running active ads. Runtime alone does not establish performance.

Notes

For ads launched during November, replace active_since with launched_after="2025-11-01".
Add display_format="video" to study video creatives only.
Use ordinary search text; do not assume exact-phrase or boolean-query syntax.