Ads integration
Connect StefanBrain to Atria API
Connect an Atria workspace with an API key. StefanBrain can then search Atria's ad library, read your saved ads and boards, and pull numbers from your connected ad accounts.
What connecting Atria API unlocks
Ad library search with real filters
Search ads from every advertiser by keyword, platform, format, call to action, theme, country, launch date, and run time, sorted the way you need.
Your saved ads and boards
List the ads your workspace saved, with their boards and tags, or read every ad on one board.
Brands you watch
Search brands, read one with its advertisers and web traffic, and follow or unfollow brands after you approve it.
Numbers from your own ad accounts
Read totals for the Meta and TikTok accounts connected in Atria, rank your ads by any metric, and read saved video transcripts.
Tools your chats can call
A sample of the Atria API tools StefanBrain can use once connected. Reads and writes are classified separately, and you control both.
Search Library Ads
Search the ad library by keyword, format, theme, and more.
Get Library Ad
One ad in full. A pasted Atria ad link works too.
List Saved Library Ads
Your swipe file, with boards and tags.
List Board Ads
Every ad saved to one board.
Search Inspo Brands
Search brands, or list the brands you follow.
List Ad Account Ads
Your own ads ranked by any metric over a date range.
Get Ad Account Summary
Account totals such as spend, results, and ROAS.
How to connect
1Create an API key in Atria
In Atria, click your avatar in the top-left corner, open Settings & members, then API Keys, and click Create API key. Copy it right away.
2Open Connectors and choose Atria API
In StefanBrain, open Connectors, search for Atria API, and click Connect.
3Paste the key
Paste the key, which starts with atria-sk_, into the API key field and click Connect. StefanBrain checks it with one small read.
4Ask your first question
Try asking for the ads saved to one of your boards, or for your top ads by spend over the last 7 days.
Good to know
- Atria shows a new key only once, and each workspace can have two active keys. The key decides which workspace StefanBrain reads.
- On Atria's Core plan, each API call past 1,200 a month spends 1 Atria AI credit instead of stopping. Plus and higher plans have no monthly cap.
- Image generation starts switched off, because StefanBrain makes ad images with its own image tools. Transcribing a video spends AI credits and asks first.
- The Atria card, which signs in instead of using a key, covers more: saving ads to boards, creative tags, Radar, notes, and skills.
Your credentials stay yours
- We never store your passwords
- Encrypted at rest and in transit
- Disconnect anytime
Frequently asked questions
Where do I find my Atria API key?
In Atria, click your avatar in the top-left corner, then open Settings & members and API Keys. Create a new key there and copy it before you close the window.
Which Atria plans include API access?
Atria refuses API keys from plans without API access, and StefanBrain tells you when you connect. Core allows 1,200 calls a month, then each call spends 1 AI credit. If the month's allowance is already used up, connecting tells you so; connect again after Atria's monthly reset or an upgrade.
How is this different from the Atria card?
The Atria card signs in with your account and reaches more Atria tools. This card uses a workspace API key and covers Atria's 22 public API actions.
Will StefanBrain change anything in Atria?
Following or unfollowing a brand, tracking an advertiser, and transcribing a video each ask first. Image generation starts switched off. Everything else only reads.
Can I connect more than one Atria workspace?
Yes. Each key belongs to one workspace, so connect a key from each workspace you want StefanBrain to read.
How do I disconnect?
Disconnect the Atria API card in StefanBrain's Connectors. To stop the key everywhere, delete it in Atria under Settings & members > API Keys.
More integrations
Put your Atria API data to work
Connect once and every StefanBrain surface can use it: chat, creative, copy review, and analysis.
Built for brands serious about growth.
