This article covers what the API is, what you can do with it, and how to get started.
What is the API?
An API is a way for software systems to talk to each other. With the Atria API, your own tools can pull ad data, search brands, and access your boards programmatically — without anyone logging into Atria and clicking around.
If you have a developer on your team, or you're comfortable with code, the API unlocks a new layer of power on top of what you already do in Atria.
What can I use it for?
Competitor research
Search for any brand by name and pull their latest active ads automatically. Instead of checking manually, your system can do it for you — and push results wherever your team already works.
Daily new-ad digest
Set up a job that runs every morning, checks all the brands you follow in Atria, and surfaces any ads they launched since yesterday — delivered to Slack, email, or any other tool you use.
Long-form video research
Filter the full ad catalog to find 60s+ video creatives in any category, ranked by how long they've been running — a strong signal for what's actually working.
Keyword and seasonal research
Search ads by keyword across all brands and a specific time window. Useful for studying how competitors handled a seasonal moment — like pulling every Black Friday ad from last November before planning your own campaign.
Analyze a board with Claude
Pull all the ads saved to one of your Atria boards and feed them to Claude (Anthropic's AI) to ask higher-order questions: what creative themes are emerging? What CTAs dominate? Generate five variants in this brand's voice.
How do I get started?
1. Generate an API key
Log into Atria and click your avatar in the top-left corner
Go to Settings & members → API Keys
Click Create API key
Copy the key immediately — it's only shown once
Keep your API key private. Treat it like a password and never share it or include it in public code.
2. Make your first request
All API requests go to https://api.tryatria.com and require your key in the X-API-Key header. The Quick Start guide walks you through your first three calls in under 10 minutes.
3. Explore the use case recipes
The API reference includes ready-to-run recipes for the most common workflows. Each one includes code in Python, Node.js, and cURL — you don't need to build from scratch.
Do I need a developer?
For most of the recipes above, yes — they involve writing or running code. If your team has a developer, they can get up and running quickly using the documented examples.
If you don't have a developer but still want to automate workflows, get in touch with us and we can talk through your options.
Can I connect Claude (or another AI) to Atria?
Yes. The Analyze a Board with Claude recipe shows exactly how to do this — pull your board's ads via the API and send them to Claude for analysis, theme clustering, or variant generation.
More broadly, any AI tool that can make API calls can connect to Atria using your API key. No special integration is needed.
I have more questions
Check the full API reference or reach out to us at support@tryatria.com.