ProvlyDocs

Search docs

Guides and API endpoints

DocsAPI referenceAdvertisersSearch advertisers

Search advertisers

GET/api/v1/advertisers

Advertisers (brands / Facebook pages) running ads, by name, sorted by active ads, new ads in 30 days or EU reach.

Bearer API keyMCP tool search_advertisers

Query parameters

querystring

Brand name.

sortstringdefault active

Order.

activelaunchedreach
limitintegerdefault 20

Results per page, 1–50.

Try it

GET/api/v1/advertisers
curl "https://provly.co/api/v1/advertisers" \
  -H "Authorization: Bearer $PROVLY_API_KEY"
200 · Response
{
  "data": [
    {
      "id": "meta_library_104587213",
      "name": "Pawfect Co.",
      "description": "Smart products for happy pets",
      "avatar": "https://media.provly.co/avatars/104587213.jpg",
      "websites": [
        "pawfect.co"
      ],
      "niches": [
        "pet-supplies"
      ],
      "verified": false,
      "active_ads": 42,
      "total_ads": 318,
      "new_ads_30d": 17,
      "eu_reach_30d": 1250000,
      "facebook_likes": 58000,
      "instagram_followers": 91000,
      "main_country": "TR",
      "countries": [
        "TR",
        "DE",
        "NL"
      ],
      "provly_url": "https://provly.co/app/brands/meta_library_104587213"
    }
  ],
  "pagination": {
    "total": 1284,
    "next_cursor": null
  }
}