ProvlyDocs

Search docs

Guides and API endpoints

DocsAPI referenceAdvertisersGet an advertiser

Get an advertiser

GET/api/v1/advertisers/{id}

Profile, counters and ad analytics: average run time, platform and format breakdown.

Bearer API keyMCP tool get_advertiser

Path parameters

idstringrequired

Advertiser id.

Try it

GET/api/v1/advertisers/meta_library_104587213
curl "https://provly.co/api/v1/advertisers/meta_library_104587213" \
  -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",
    "analytics": {
      "total_ads": 318,
      "active_ads": 42,
      "avg_running_days": 23,
      "by_platform": [
        {
          "key": "facebook",
          "count": 301
        }
      ],
      "by_format": [
        {
          "key": "video",
          "count": 188
        }
      ]
    }
  }
}