ProvlyDocs

Search docs

Guides and API endpoints

DocsAPI referenceTrackersTrack a brand or keyword

Track a brand or keyword

POST/api/v1/trackers

Follow an advertiser (id from /lookup) or a keyword. Provly rescans it on the interval and new ads show up in /trackers/{id}/ads. Counts against the plan's tracked-brand limit (402 quota_exhausted when full); tracking an advertiser twice returns the existing tracker with created: false.

Bearer API keyMCP tool track_brand

Body

advertiser_idstring

Advertiser to follow.

querystring

Or: keyword to follow.

countriesstring[]

ISO codes to scan.

interval_minutesintegerdefault 720

Rescan interval, min 60.

Try it

POST/api/v1/trackers
curl -X POST "https://provly.co/api/v1/trackers" \
  -H "Authorization: Bearer $PROVLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countries":["TR"]}'
200 · Response
{
  "data": {
    "id": "3f8aa146-6f96-46e8-9781-64db5166f9a8",
    "kind": "brand",
    "label": "Pawfect Co.",
    "query": null,
    "advertiser_id": "meta_library_104587213",
    "countries": [
      "TR"
    ],
    "enabled": true,
    "interval_minutes": 720,
    "total_ads": 318,
    "last_run_at": "2026-09-26T06:00:00.000Z",
    "last_status": "ok",
    "created_at": "2026-08-01T10:20:00.000Z",
    "provly_url": "https://provly.co/app/spyder"
  },
  "created": true
}