If you want to ask Claude or ChatGPT about your Atria data, use MCP instead of the API. It connects Atria to your AI tool in about a minute with no code. See Connect Atria to Claude & ChatGPT through MCP. Use the API for scheduled jobs or to send Atria data into your own systems.
What the API does
The Atria API lets your own software pull ad data, search brands and read your Boards without anyone logging in to Atria. You'll need a developer, or to be comfortable writing code.
API or MCP?
Use MCP when a person is asking the questions, for example "what are our competitors running this month?" or "summarise what's working on this board". No code is needed.
Use the API for automated jobs, such as a daily digest, sending data to a warehouse or dashboard, or anything that runs the same way repeatedly.
Many teams use both.
What you can build
Each of these has a ready-made recipe with code in Python, Node.js and cURL.
Competitor research: search for a brand and pull its latest active ads. Competitor Research recipe
Daily new-ad digest: each morning, check the brands you follow and send any new ads to Slack or email. Daily New-Ad Digest recipe
Long-form video research: find video ads of 60 seconds or more in a category, ranked by how long they've been running. Long-Form Video Research recipe
Keyword and seasonal research: search ads by keyword across all brands in a time window, such as Black Friday. Keyword Ads Search recipe
Analyse a board with Claude: pull the ads on a board and send them to Claude for analysis. If you only need this once, MCP is quicker. Analyze a Board with Claude recipe
Get started
1. Create an API key
Log in to Atria and click your avatar in the top left.
Go to Settings & members → API Keys.
Click Create API key.
Copy the key. It's only shown once.
Keep your key private and don't commit it to a public repository. If a key leaks, create a new one and tell us.
2. Make your first request
Send requests to https://api.tryatria.com with your key in the X-API-Key header. The Quick Start guide takes you through your first three calls.
3. Explore the reference
See the full API reference for every endpoint and recipe.
What it costs
API calls come from your plan's allowance, which belongs to the workspace. Paid allowances reset each month, including on annual plans:
Free: 30 API calls, one-time
Core: 1,200 API calls per month
Plus, Business and Enterprise: unlimited
On a paid plan, each call beyond your allowance costs 1 AI credit. On Free, further calls are declined until you upgrade. API and MCP calls are counted separately. You can see your usage under MCP → Overview, in the Usage & allowances card.
Questions
Email support@tryatria.com with what you're trying to build and we'll tell you whether the API, MCP or an existing Atria feature is the best fit.