ProvlyDocs

Search docs

Guides and API endpoints

DocsAPI reference

API reference

42 endpoints under https://provly.co/api/v1. JSON in, JSON out, Bearer key auth.

Base URL
https://provly.co/api/v1
Auth
Authorization: Bearer pvly_live_…
OpenAPI
https://provly.co/api/v1/openapi.json

System

Version and health (no key needed), and data freshness (key required).

GET/GET/healthGET/system/freshness

Identity & usage

The key, its workspace and the rate-limit counters.

GET/meGET/usageGET/workspace

Discovery

Resolve names to ids and list every accepted filter value.

GET/lookupGET/facets/{facet}

Ads

Search, read and compare ads across Meta, TikTok and Google.

GET/adsPOST/ads/queryGET/ads/{id}GET/ads/{id}/media-urlGET/ads/{id}/similar

Networks

The ads search locked to one ad network.

GET/tiktok/adsGET/google-adsGET/meta/ads

Advertisers

Brands and Facebook pages with their activity and ads.

GET/advertisersGET/advertisers/{id}GET/advertisers/{id}/ads

Shops

E-commerce stores: tech stack, catalog, traffic, ads, emails and look-alikes.

GET/shopsGET/shops/{domain}GET/shops/{domain}/adsGET/shops/{domain}/productsGET/shops/{domain}/similarGET/shops/{domain}/emails

Products

Products found in ads, with prices and ad counters.

GET/productsGET/products/{id}

Emails

Marketing emails stores send: newsletters, promotions, flows.

GET/emailsGET/emails/{id}

Trackers

Spyder: brands and keywords your workspace follows.

GET/trackersPOST/trackersGET/trackers/{id}DEL/trackers/{id}GET/trackers/{id}/ads

Boards

Your swipe file: boards and the ads saved in them.

GET/boardsPOST/boardsGET/boards/{id}PATCH/boards/{id}DEL/boards/{id}GET/boards/{id}/itemsPOST/boards/{id}/itemsDEL/boards/{id}/items/{ad_id}