ProvlyDocs

Search docs

Guides and API endpoints

DocsAPI referenceAdsSimilar ads

Similar ads

GET/api/v1/ads/{id}/similar

Creatives semantically close to this one (copy, visuals, transcript), across all advertisers. Great for finding every seller of the same product.

Bearer API keyMCP tool get_similar_ads

Path parameters

idstringrequired

Ad id.

Query parameters

limitintegerdefault 10

1–30.

Try it

GET/api/v1/ads/meta_library_1203944578113742/similar
curl "https://provly.co/api/v1/ads/meta_library_1203944578113742/similar" \
  -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",
      "similarity": 0.912
    }
  ]
}