FAQ
Answers to common questions about scanning, geos, devices, results, and integrations.
How long does a scan take?
Most scans finish in seconds to a couple of minutes depending on the redirect chain depth and the target's responsiveness. Bulk batches process in parallel.
Which geos and devices are supported?
A range of countries and device emulators (desktop and mobile) are
available. The exact list shows in the campaign creation screen and via
the GET /api/v1/geos and GET /api/v1/emulators endpoints.
What's the difference between a URL scan and an ad-tag scan?
A URL scan renders a single page. An ad-tag scan submits an ad snippet — or the URL of a page where the creative is already rendered — which Kaminari Ad expands through its phases to reach the real creative and one or more landing pages, so its tags are split into creative vs landing.
How are results represented?
Each scan gets a status (its lifecycle), a classification (brand
- AI category + IAB v3), and a set of tags — the findings, each with
a category and a severity (
high/medium/low). There is no single "verdict" field; you decide what is actionable with policy sets.
Can I scan one URL across several countries at once?
Yes — use POST /api/v1/scans/bulk with a list of country_codes. It
creates one scan per country, times repeat_count if you ask for
repeats. To scan many different URLs, use
a campaign.
How do I get results programmatically?
Poll GET /api/v1/scans/{id}, or subscribe to a
webhook (scanning.scan.completed,
scanning.tags.detected) to have results pushed to you.
Can I share a result with someone without an account?
Yes — open a scan and copy its public report link. It is a read-only view that needs no login.
How do I get notified automatically?
Configure an alert destination (Slack, Telegram, or email) or subscribe a webhook.
Where is the full API reference?
The interactive Swagger reference is at app.kaminari.ad/docs. These pages cover the workflows; Swagger is the exhaustive contract.
What's the difference between Kaminari Ad and Kaminari.Click?
Kaminari Ad verifies creatives going out; Kaminari.Click protects incoming traffic from fraud. Same family, opposite ends of the problem.