ProvlyDocs

Search docs

Guides and API endpoints

DocsAPI referenceDiscoveryResolve a brand, domain or handle

Resolve a brand, domain or handle

GET/api/v1/lookup

Turns a brand name, a domain (gymshark.com) or an Instagram handle (@gymshark) into Provly advertisers and shops. Call it first whenever the user names a brand, then use the returned ids.

Bearer API keyMCP tool lookup

Query parameters

qstringrequired

Brand name, domain or @handle.

Try it

GET/api/v1/lookup?q=pawfect.co
curl "https://provly.co/api/v1/lookup?q=pawfect.co" \
  -H "Authorization: Bearer $PROVLY_API_KEY"
200 · Response
{
  "data": {
    "advertisers": [
      {
        "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"
      }
    ],
    "shops": [
      {
        "domain": "pawfect.co",
        "name": "Pawfect Co.",
        "description": "Smart products for happy pets",
        "platform": "shopify",
        "theme": {
          "name": "Dawn",
          "version": "15.0.0"
        },
        "apps": [
          {
            "name": "Judge.me",
            "category": "reviews"
          },
          {
            "name": "Klaviyo",
            "category": "email"
          }
        ],
        "pixels": [
          "Meta Pixel",
          "TikTok Pixel",
          "Google Analytics 4"
        ],
        "currency": "TRY",
        "language": "tr",
        "catalog": {
          "products": 64,
          "price_min": 199,
          "price_max": 4499,
          "price_avg": 1180
        },
        "active_ads": 42,
        "monthly_visits": 184000,
        "traffic_growth_30d": 0.21,
        "country": "TR",
        "niches": [
          "pet-supplies"
        ],
        "socials": {
          "instagram": "https://instagram.com/pawfect.co"
        },
        "provly_url": "https://provly.co/app/stores/pawfect.co"
      }
    ]
  }
}