/sites/{siteId}/trackersRead the tracker inventory
Every tracker our scans and the connected Tag Manager container found, grouped by vendor, with our category for each tag and the cookies each vendor set.
Auth header
Authorization: Bearer tsk_live_…The key needstrackers:read
Parameters
siteIdstringin pathrequiredThe site id, from GET /v1/sites.
Example request
curl "https://app.tagsentry.ai/api/v1/sites/3f6c1b8e-2d4a-4c7e-9a51-0b8f2e6d7c10/trackers" \ -H "Authorization: Bearer tsk_live_…"Response 200
dataarray of objectrequireddata[].vendorNamestringrequireddata[].vendorHoststring | nullrequireddata[].vendorIsRecognisedbooleanrequireddata[].vendorBestGuessobject | nullrequiredTagSentry's classification of an unrecognised host from its address alone; vendorName is then this vendor. No person has reviewed it. Null when the host is recognised or there is no classification.
data[].vendorBestGuess.vendorstringrequireddata[].vendorBestGuess.productstringrequireddata[].vendorBestGuess.categorystringrequiredOne of
analytics,advertising,functional,necessary,unknowndata[].vendorBestGuess.whatItDoesstringrequireddata[].vendorBestGuess.confidencenumberrequireddata[].sourcesarray of stringrequireddata[].unmanagedCountintegerrequiredTags seen on the page that no Tag Manager container we can read fires.
data[].needsReviewCountintegerrequiredNo human has confirmed these. We still decided a category where we could.
data[].lastSeenAtstringrequiredISO-8601 timestamp, UTC.
data[].tagsarray of objectrequireddata[].tags[].idstringrequireddata[].tags[].displayNamestringrequireddata[].tags[].sourcestringrequiredOne of
gtm_container,live_scan,bothdata[].tags[].gtmContainerPublicIdstring | nullrequireddata[].tags[].gtmTagIdstring | nullrequireddata[].tags[].gtmTagTypestring | nullrequireddata[].tags[].isUnmanagedbooleanrequireddata[].tags[].needsReviewbooleanrequireddata[].tags[].categorystring | nullrequiredOur answer, or null when neither source has one.
data[].tags[].categoryBasisstring | nullrequiredOne of
vendor_table,classifierdata[].tags[].firstSeenAtstringrequiredISO-8601 timestamp, UTC.
data[].tags[].lastSeenAtstringrequiredISO-8601 timestamp, UTC.
data[].cookiesarray of objectrequireddata[].cookies[].namestringrequireddata[].cookies[].domainstringrequireddata[].cookies[].partystringrequiredOne of
first,thirddata[].cookies[].expirystring | number | nullrequiredSeconds, 'session', or null when unknown.
data[].cookies[].setByobject | nullrequireddata[].cookies[].setBy.viastringrequiredOne of
http,script,domaindata[].cookies[].setBy.hoststring | nullrequireddata[].cookies[].purposestring | nullrequiredWhat it is for: the vendor's documented purpose, else TagSentry's classification, else null.
data[].cookies[].purposeSourcestring | nullrequiredcurated: our cited vendor table.ai_best_guess: TagSentry's model classified it; no person has reviewed it.One of
curated,ai_best_guessdata[].cookies[].purposeCategorystring | nullrequirednecessary, functional, analytics or marketing, set only when purposeSource is
ai_best_guess.data[].cookies[].typicalLifetimestring | nullrequiredThe lifetime our scans of other sites measured most, e.g. '13 months'.
limitintegerrequiredThe row cap applied to the underlying read.
truncatedbooleanrequiredTrue when the read came back at its cap. When true, this page is NOT the whole answer. Narrow the window. The tracker inventory is read whole;
truncatedis always false here.truncationHintstringoptional
Example response
{ "data": [ { "vendorName": "Google Analytics", "vendorHost": "www.google-analytics.com", "vendorIsRecognised": false, "vendorBestGuess": { "vendor": "…", "product": "…", "category": "analytics", "whatItDoes": "…", "confidence": 0 }, "sources": [ "gtm_container" ], "unmanagedCount": 0, "needsReviewCount": 0, "lastSeenAt": "2026-09-26T14:02:00.000Z", "tags": [ { "id": "3f6c1b8e-2d4a-4c7e-9a51-0b8f2e6d7c10", "displayName": "Silverpine Supply", "source": "gtm_container", "gtmContainerPublicId": "GTM-ABC1234", "gtmTagId": "12", "gtmTagType": "…", "isUnmanaged": false, "needsReview": false, "category": "analytics", "categoryBasis": "vendor_table", "firstSeenAt": "2026-09-26T14:02:00.000Z", "lastSeenAt": "2026-09-26T14:02:00.000Z" } ], "cookies": [ { "name": "_ga", "domain": "silverpine.example", "party": "first", "expiry": "session", "setBy": { "via": "http", "host": "www.google-analytics.com" }, "purpose": "…", "purposeSource": "curated", "purposeCategory": "analytics", "typicalLifetime": "…" } ] } ], "limit": 50, "truncated": false, "truncationHint": "…"}More about this endpoint
category is our answer: from our sourced vendor table where it has one, else from our classifier. needsReview means no human has confirmed it, not that nobody decided.
Errors401 · 403 · 404 · 429 · 500
401Missing, malformed, unknown, revoked or expired API key. These are deliberately indistinguishable in the response: distinguishing them would confirm to a caller that a token was once real.403The key authenticated but does not carry the scope(s) this operation requires, or (`domain_not_verified`) the site's domain is not verified, so its consent records are not released.404No such resource on this account. A site id belonging to a DIFFERENT account answers 404, never 403: a 403 would confirm the id exists somewhere.429A rate limit or quota was exceeded. The body names WHICH one.500Something failed on our side. The requestId in the body is what to quote.
Every error has the same body: { error: { code, message, requestId } }.
From the OpenAPI document, version 2026-08-26. Raw OpenAPI