n8n-nodes-adlib – ad library node for n8n
An n8n community node for the AdLib API: one API for the public ad libraries of Meta (Facebook, Instagram), Google (incl. YouTube and Google Play), TikTok, LinkedIn, Pinterest, X, Snapchat, Apple, Amazon and Microsoft (Microsoft in beta), with its own ad history. Ads that disappear from a platform's library are still there, with their run time, marked with removed_from_library_at.
Get an API key at adlibapi.com; the free plan includes 5,000 credits a month.
With this package you can:
- find a brand's advertiser IDs on every platform from its domain,
- search ads by keyword, advertiser or domain, including ads the platforms have removed,
- break an ad's creative down into its features (hook, offers, urgency, format, video length, cuts, on-image text),
- turn a link copied from an ad library into an AdLib ID,
- check whether a company is advertising right now (lead enrichment),
- read an advertiser's ads, stats, timeline and changes,
- report a wrong or missing advertiser match, and autocomplete domains,
- inspect, redeliver and test your webhook deliveries,
- watch competitors and start a workflow when they launch, stop, change or remove ads (AdLib Trigger), or get the changes by email.
Not affiliated with Meta, Google, TikTok, LinkedIn, Pinterest, X, Snapchat, Apple, Amazon or Microsoft.
Installation
In n8n:
- Go to Settings > Community Nodes.
- Click Install.
- Enter
n8n-nodes-adlib and confirm.
The AdLib and AdLib Trigger nodes then show up in the nodes panel. See the n8n guide on installing community nodes for manual installation with npm (queue mode, Docker).
Credentials
Create an AdLib API credential:
- API Key: your AdLib API key. It is sent in the
X-API-Key header.
- Base URL: the root URL of the API, without
/v1. Default https://api.adlibapi.com; change it if your account uses a different host.
When you save the credential, n8n tests it with GET /v1/usage?days=1.
Operations
| Resource | Operation | Endpoint |
|---|
| Advertiser | Resolve by Domain | GET /v1/advertisers/resolve?domain= |
| Advertiser | Get | GET /v1/advertisers/{id} |
| Advertiser | Get Ads (Return All) | GET /v1/advertisers/{id}/ads |
| Advertiser | Get Changes (Return All) | GET /v1/advertisers/{id}/changes?since= |
| Advertiser | Get Stats | GET /v1/advertisers/{id}/stats |
| Advertiser | Get Timeline (Return All) | GET /v1/advertisers/{id}/timeline |
| Advertiser | Report Resolve Match | POST /v1/advertisers/resolve/reports |
| Advertiser | List Resolve Reports | GET /v1/advertisers/resolve/reports |
| Ad | Search (Return All) | GET /v1/search |
| Ad | Get | GET /v1/ads/{id} |
| Ad | Get History | GET /v1/ads/{id}/history |
| Ad | Get Ad Features | GET /v1/ads/{id}/features |
| Ad | Parse Library URL | GET /v1/library-url?url= |
| Domain | Check if Advertising | GET /v1/domains/{domain}/check |
| Domain | Get Company Profile | GET /v1/companies/{domain} |
| Domain | Suggest Domains | GET /v1/domains/suggest?q= |
| Watchlist | Create | POST /v1/watchlists |
| Watchlist | Get | GET /v1/watchlists/{id} |
| Watchlist | List | GET /v1/watchlists |
| Watchlist | Add Advertisers | POST /v1/watchlists/{id}/advertisers |
| Watchlist | Remove Advertiser |
Notes:
This is the beginning of the README. Read the rest at the original. Read the full README ↗
