ProvlyDocs

Search docs

Guides and API endpoints

DocsAPI referenceAdsGet an ad

Get an ad

GET/api/v1/ads/{id}

One ad with copy, media, run dates, targeting, reach and the video transcript.

Bearer API keyMCP tool get_ad

Path parameters

idstringrequired

Ad id.

Try it

GET/api/v1/ads/meta_library_1203944578113742
curl "https://provly.co/api/v1/ads/meta_library_1203944578113742" \
  -H "Authorization: Bearer $PROVLY_API_KEY"
200 · Response
{
  "data": {
    "id": "meta_library_1203944578113742",
    "advertiser": {
      "id": "meta_library_104587213",
      "name": "Pawfect Co."
    },
    "platforms": [
      "facebook",
      "instagram"
    ],
    "format": "video",
    "headline": "The self-cleaning litter box cats love",
    "body": "No scooping for 14 days. 30-day money-back guarantee.",
    "cta": "Shop now",
    "landing_url": "https://pawfect.co/products/autobox",
    "is_active": true,
    "started_at": "2026-07-02T00:00:00.000Z",
    "ended_at": null,
    "running_days": 86,
    "countries": [
      "TR",
      "DE"
    ],
    "languages": [
      "tr"
    ],
    "niches": [
      "pet-supplies"
    ],
    "media": {
      "image": null,
      "video": "https://media.provly.co/meta/1203944578113742.mp4",
      "thumbnail": "https://media.provly.co/meta/1203944578113742.jpg",
      "video_duration": 27
    },
    "reach": 184200,
    "engagement": null,
    "duplicates": 6,
    "transcript": "Tired of scooping every day? …",
    "provly_url": "https://provly.co/app?ad=meta_library_1203944578113742"
  }
}