ProvlyDocs

Search docs

Guides and API endpoints

DocsAPI referenceShopsA shop's ads

A shop's ads

GET/api/v1/shops/{domain}/ads

Ads whose landing page is on this domain, from every advertiser.

Bearer API keyMCP tool get_shop_ads

Path parameters

domainstringrequired

Store domain.

Query parameters

activeboolean

Only running ads.

sortstring

Order.

newestoldestlongest_runningmost_relevant
limitintegerdefault 20

Results per page, 1–50.

cursorstring

The next_cursor of the previous page.

Try it

GET/api/v1/shops/pawfect.co/ads
curl "https://provly.co/api/v1/shops/pawfect.co/ads" \
  -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"
    }
  ],
  "pagination": {
    "total": 1284,
    "next_cursor": "eyJzIjpbMTcy…"
  }
}