Atria API · For builders

Plug Atria's ad intelligence into any workflow.

Read brands, boards, and 25M+ ads through one REST API — the same data Raya uses.

Start with the REST APIBook a demo
Trained on $5B+ in real ad spend25M+ ads · Meta, TikTok & moreREST today · MCP soon
Capabilities

Everything Atria does — exposed as endpoints you can build on.

Live

Ad Library

Search and inspect 25M+ ads. Filter by platform, format, language, industry, status, dates. Get hooks, copy, landing pages, asset URLs.

Live

Brand Library

Look up any brand on Atria — running-ads counts, niches, regions, creative velocity. Search by name or browse followed brands.

Live

Boards

Sync the boards you've built in Atria — every saved ad, tag, and note — into your CMS or warehouse.

Live

Ad Accounts

Performance data for your connected Meta / TikTok ad accounts — ad-level metrics, KPI sorting, account summaries.

Live

Image Generations

Brief → static creative, grounded in your brand boards and a reference ad. Submit a job, poll status, fetch results.

Coming soon

MCP

Atria-as-an-MCP for Claude and ChatGPT. Same data, zero glue code — just install and prompt.

Talk to us
Start in 60 seconds

Header. Endpoint.
Done.

  1. 01
    Create your API key

    Auth is a single header — X-API-Key.

  2. 02
    Pick an endpoint

    Read brands, ads, boards — or generate images.

  3. 03
    Run the request

    Plain HTTP — call it from any language or client.

GET /open/v1/ad-library/search · fetch recent active ads
curl -sS -G \
  -H "X-API-Key: $ATRIA_API_KEY" \
  --data-urlencode "platform=facebook" \
  --data-urlencode "status=active" \
  --data-urlencode "order=newest" \
  --data-urlencode "page_size=10" \
  "https://api.tryatria.com/open/v1/ad-library/search"
Examples

Recipes pulled straight from the docs.

Each example is a ready-to-run script using two or three endpoints. Copy, paste, ship.

01 · research

Competitor research

Search a brand by name, then pull its newest active video ads in two calls. A starting point for any competitive workflow.

GET /open/v1/brand-library/searchGET /open/v1/brand-library/{brand_id}/ads
02 · digest

Daily new-ad digest

Cron job that surfaces yesterday's new ads from every brand your workspace follows — then posts them to Slack, email, or anywhere else.

GET /open/v1/brand-library/followedGET /open/v1/brand-library/{brand_id}/ads
03 · discovery

Long-form video research

Find every 60s+ video ad in a category, ranked by how long it's been running — a proxy for what's actually working.

GET /open/v1/ad-library/searchGET /open/v1/ad-library/{ad_id}
Browse all examples in the docs
Why builders pick Atria

Platform APIs only see your ads. Atria sees the whole market.

Meta and TikTok's native APIs are great for managing your own campaigns — but they can't tell you what the competition is shipping today. Atria's API is built around creative intelligence: every ad you'd want to see, ready for any agent to reason over.

Comparison reflects publicly available scopes as of writing.

Capability
Meta / TikTok native API
Atria API
Read your own ads & campaigns
✓
✓
Search 25M+ competitor creatives
—
✓
Boards, tagging, team workspace
—
✓
Brand-aware image generation
—
✓
Your video ads, auto-transcribed
—
✓
Works with Claude & ChatGPT
Via custom code
REST today · MCP soon

Ship your first agent on Atria today.

Workspace key in two clicks. Three lines of cURL to your first 200.

Create an API key