Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tumban.com/llms.txt

Use this file to discover all available pages before exploring further.

Tumban analyzes a creator profile URL and returns a structured recommendation your reviewers can act on. Each scan produces a risk score (0–100), a confidence level, reason codes, and an evidence index of the URLs and signals behind the decision.

​
How it works

Submit a profile URL. Tumban runs the URL through its scraping, web search, link traversal, and multi-strategy detection pipeline and returns the result either by webhook or by polling.
1

Submit

Send the profile URL to POST /api/v2/scan. You receive a scan_id immediately and the scan begins processing in the background.
2

Wait for the result

Tumban delivers the triage report to your callback_url, or you can poll GET /api/v2/scans/{scan_id} until status is no longer processing.
3

Triage

Use the recommendation (no_flags, review_low, review_medium, review_high) plus the evidence_index to route the profile to your review queue.

​
Where to start

Quickstart

Mint an API key, submit a scan, and read the result in under five minutes.

Authentication

API keys for server-to-server use, or Clerk JWT for dashboard sessions.

API reference

Endpoint-by-endpoint reference, derived from the live handlers.

Webhooks

Payload format, HMAC verification, and retry behaviour.