Skip to main content
GET
Reference example
First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. The commands per client, and what each call costs, are on aisa.one/mcp.
Set this endpoint up in your agent →

Cost and request rules

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.45
  • Declared unit rate (USD): 0.075
  • Billing unit: similarweb_credit
  • Cost contract: plan_units
  • Published reference multiplier: 1.0
  • Settlement evidence source: request_snapshot

Request constraints and usage notes

  • country supports ww only; default ww.
  • Monthly granularity only.
  • Total web source and main domain only.
  • Defaults to the latest six complete UTC months; maximum range is 12 months.
  • Provider usage grows with inclusive months multiplied by unique requested metrics.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

country
enum<string>
default:ww

Worldwide data only; values are case-insensitive.

Available options:
ww
domain
string
required

Bare website hostname without scheme, path, port, or credentials.

end_date
string

Inclusive last complete UTC month in YYYY-MM.

metrics
string
default:visits

One to four supported Traffic & Engagement metrics.

start_date
string

Inclusive first month in YYYY-MM; provide together with end_date.

Response

Normalized successful response

data
object
required
meta
object
required