adlibrary.com Logoadlibrary.com
FEATURE

Programmatic Access to the AdLibrary Database

Provides programmatic access via a REST API for developers and data teams to integrate AdLibrary's ad intelligence data directly into their own applications, dashboards, and automated workflows.

See example

What This Feature Does

  • •Enables programmatic searching and filtering of the AdLibrary ad database using POST requests.
  • •Allows for the extraction of ad data, advertiser information, and performance metrics in a structured JSON format.
  • •Supports integration into custom dashboards, internal tools, and automated reporting systems.
  • •Authenticates users via Basic Authentication using existing AdLibrary account credentials.
  • •Provides access to ad data from multiple platforms including Meta (Facebook, Instagram) and Google.

How It Works

1
A user with a Business subscription sends a POST request to the versioned API endpoint: https://adlibrary.com/api/v1/search.
2
The request includes a Basic Authentication header containing the user's base64 encoded email and password.
3
The request body contains a JSON payload with a search query and optional filters for platforms, ad type, location, and date range.
4
The API processes the request, checks the account's credit balance, and deducts one credit for each ad result returned.
5
The system returns a structured JSON response containing arrays of ad and advertiser data, along with query metadata.

Who This Feature Is For

✓ Best For

  • Automating competitive research and ad monitoring at scale.
  • Integrating real-time ad data into custom business intelligence dashboards.
  • Developers building custom applications on top of ad intelligence data.
  • Data analysts performing large-scale studies on advertising trends.
  • Agencies creating automated reports for clients.

✕ Not Ideal For

  • Users without a Business subscription, as API access is a premium feature.
  • Users without technical resources to implement API integrations.
  • Accounts with low credit balances, as each result returned deducts credits.
  • Authentication via OAuth providers like Google SignIn, which is not yet supported.
  • Accessing real-time data from platforms marked as 'in progress' like TikTok or X.

Practical Use Cases

Building a custom dashboard to track competitor ad spend and creative strategies.
Creating an automated alert system for new ads launched by specific brands.
Enriching internal CRM data with advertising intelligence.
Conducting large-scale academic or market research on ad creative trends.
Feeding ad data into a machine learning model to predict creative performance.

Limits & Boundaries

  • !API access is exclusively available to users with an active Business subscription.
  • !Each ad result returned via the API deducts one credit from the account's balance.
  • !The 'pageSize' parameter is limited to a maximum of 1000 results per request.
  • !The 'limit' parameter is capped at 1000 total results per query.
  • !API requests have a timeout of 120 seconds.
  • !Standard platform rate limits apply to prevent system abuse.
See pricing