Similarweb API

Platform-provided account; validated SEO modules and Team Credits.

Quick start

Worldwide only (country 999). Dates below are examples, not defaults or current verification.

API base https://kieapi.com

curl -X POST "https://kieapi.com/v1/similarweb/overview" \
  -H "Authorization: Bearer $SPIDER_API_KEY" \
  -H "Idempotency-Key: seo-example-01" \
  -H "Content-Type: application/json" \
  -d '{
  "domain": "example.com",
  "country": 999,
  "start_date": "2026-08-21",
  "end_date": "2026-09-17"
}'

Authentication

Use a bearer token.

Team administrators manage API keys in Team Settings. Each key keeps its Team and billing scope when its creator leaves or switches Teams. Keys cannot manage members, billing or other keys.

Validated delivery

Modules

Overview returns site metadata, rankings with Value/Trend and suggested peers. Engagement contains visits and engagement. Search rows retain CPC, volume and positions. Provider Trend dates identify metric timing; limitations flags ranks outside requested dates. Missing metrics stay unavailable; valid empty tables remain successful.

Credits

Operators and admins may execute modules. Complete modules are billable; incomplete modules are released. Keep the same request key after a lost response: replays bypass quota and duplicate charging. Background recovery settles saved proof without repeating upstream work. Valid empty data is successful.

Availability

Managed-account HTTP initialization is automatic. Validated business results establish readiness; local recovery proof does not establish production availability.

Reference

Endpoint reference

Typed inputs, bounded modules, billing, idempotency and sanitized error codes.

OpenAPI endpoint details

Interactive schemas, request bodies, response objects, and public error contracts load here.