Using the Atria API

If what you want is to ask Claude or ChatGPT questions about your Atria data, you don't need the API. We run an MCP server, which connects Atria to your AI tool directly — no key, no code, about a minute to set up. See Connect Atria to Claude & ChatGPT. Come back here if you're building something on a schedule or pushing data into your own systems.

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 read 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 yourself, the API opens up a layer of automation on top of what you already do in Atria.

This is the question we get most, so let us give you a straight answer rather than a list of features.

Use the MCP connection when a person is asking the questions. "What are our competitors running this month?", "Summarise what's working on this board", "Pull the transcripts for our top five video ads." It's conversational, it needs no code, and you set it up once. For most marketers, this is the right answer and the API is overkill.

Use the API when nothing is watching. Scheduled jobs, digests that fire at 7am whether or not anyone's awake, pushing Atria data into a warehouse or a dashboard your team already lives in, anything that has to run the same way a thousand times. That's what an API is for and MCP isn't a substitute for it.

Plenty of teams end up using both, and that's the sensible outcome — the connection for exploring, the API for the plumbing.

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.

→ Competitor Research recipe

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.

→ Daily New-Ad Digest recipe

Filter the full ad catalogue to find 60s+ video creatives in any category, ranked by how long they've been running — a strong signal for what's actually working.

→ Long-Form Video Research recipe

Search ads by keyword across all brands and a specific time window. Useful for studying how competitors handled a seasonal moment — pulling every Black Friday ad from last November before you plan your own campaign, say.

→ Keyword Ads Search recipe

Pull all the ads saved to one of your Boards and feed them to Claude to ask higher-order questions: what creative themes are emerging, what CTAs dominate, generate five variants in this brand's voice.

→ Analyze a Board with Claude recipe

Worth saying: if this is the only thing you want, use the MCP connection instead — it does the same job without you writing anything. The recipe is here for when you want it running automatically, or wrapped in something bigger.

Keep your API key private. Treat it like a password: never share it, and never commit it to a public repository. If you think one has leaked, generate a new one and tell us.

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 ten minutes.

What it costs. The REST API is metered: each request costs 1 credit / request, counted once per request. API requests are not free or unlimited, so bear the per-request cost in mind when you schedule a job that runs the same call many times over.

The API reference includes ready-to-run recipes for the most common workflows, each with code in Python, Node.js and cURL. You don't need to build from scratch.

→ Full API reference

For the recipes above, yes — they involve writing or running code. If your team has a developer, they'll be up and running quickly from the documented examples.

If you don't have one, don't assume you're stuck. Start with the MCP connection, which needs no code at all and covers a surprising amount of what people come to the API for. If you still need something automated after that, get in touch and we'll talk through the options.

Yes — and properly, through our MCP server rather than by handing an AI tool your API key.

MCP is a standard way for AI tools to connect to external systems, and ours exposes Atria's ad library, your own brand data, your Boards, ad-level performance across Meta and TikTok, video transcripts and image generation as things your AI tool can simply use. It works with Claude and ChatGPT, and with other MCP-capable tools like Cursor. Setup is a one-time browser sign-in.

Connect Atria to Claude & ChatGPT has the steps. We'd start there before writing any code.

Check the full API reference, or email us at support@tryatria.com and tell us what you're trying to build — we can usually tell you within a message whether it's an API job, an MCP job, or something we already do in the product.