> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. # SimilarSites > SimilarSites — SimilarWeb **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](https://aisa.one/mcp#connect). [Set this endpoint up in your agent →](https://aisa.one/mcp?from=/api-reference/similarweb/get_similarweb-website-similar-sites) ## OpenAPI ````yaml openapi/similarweb.json GET /similarweb/website/similar-sites openapi: 3.0.3 info: title: SimilarWeb API version: 1.0.0 description: >- SimilarWeb digital-intelligence data routed through the AIsa gateway: website traffic & engagement, ranking, traffic sources, audience, website content, and keyword/search insights. **Billing model**: SimilarWeb uses a two-phase (pre-authorization -> settlement) credit-based model, not a fixed unit price. (1) Before the call, an upper bound is estimated from the request dimensions and pre-authorized (response header `X-AISA-Estimated-Credits`); (2) the upstream call is made; (3) actual consumption is settled (response headers `X-AISA-Accounted-Credits`, `X-AISA-Price-USD`). - Billing dimensions: metrics x countries x time buckets (time-series endpoints); number of returned rows (list endpoints, capped at 20 rows, excess auto-truncated). - Countries: each country multiplies the cost once; world/global is normalized to world. - Settlement rounds up to whole credits; charged only when HTTP 2xx and data is non-empty; 4xx/5xx or empty data is not charged. servers: - url: https://api.aisa.one/apis/v1 security: - BearerAuth: [] paths: /similarweb/website/similar-sites: get: summary: SimilarSites description: >- SimilarSites. Response follows the SimilarWeb v5 envelope (meta + data). Date window (upstream SimilarWeb constraint): start_date and end_date must span EXACTLY 3 consecutive months — a 1- or 2-month span is rejected with upstream error 120 ('must span exactly 3 month(s)'). That span must also be SimilarWeb's most recent supported window, which advances forward each month; an older or out-of-range span is rejected with error 101 ('Dates not in range'). In practice, request the three most recent completed months (e.g. if the latest published month is 2026-07, use start_date=2026-05 and end_date=2026-07). To read the exact currently-supported range, call SimilarWeb's /describe endpoint for this API. Geographic coverage: worldwide (ww, default) and United States (us) only. operationId: get_similarweb_similar_sites parameters: - name: domain in: query required: true description: Target domain, e.g. example.com. schema: type: string - name: start_date in: query required: true description: >- Start month, format YYYY-MM. Must be exactly 2 months before end_date: the window has to span exactly 3 consecutive months within SimilarWeb's latest supported range (see the endpoint description). schema: type: string - name: end_date in: query required: true description: >- End month, format YYYY-MM. Together with start_date must span exactly 3 consecutive months, and must be the most recent supported month (the window rolls forward monthly; see the endpoint description). schema: type: string - name: granularity in: query required: false description: 'Time granularity. Allowed: monthly.' schema: type: string enum: - monthly - name: limit in: query required: true description: Number of rows to return; max 20, billed as 20 if exceeded. schema: type: integer default: 20 maximum: 20 - name: country in: query required: false description: >- Two-letter country code. Allowed: us, ww. Default: ww. Coverage is limited to ww and us on the current plan. schema: type: string enum: - us - ww default: ww - name: web_source in: query required: false description: 'Traffic source device split. Allowed: desktop, mobile_web, total.' schema: type: string enum: - desktop - mobile_web - total - name: main_domain_only in: query required: false description: Restrict to the main domain only (true/false). schema: type: boolean - name: offset in: query required: false description: Row offset for pagination. schema: type: integer - name: traffic_source in: query required: false description: Traffic-source filter. schema: type: string responses: '200': description: SimilarWeb v5 envelope (meta + data). content: application/json: example: meta: query: limit: 5 offset: 0 asc: null sort: null request: format: json domain: cnn.com granularity: monthly start_date: '2026-05-01' end_date: '2026-07-31' metrics: - rank - affinity - has_adsense category: null status: success last_updated: '2026-07-31' data: - domain: bbc.com category: News_and_Media rank: 95 affinity: 1 has_adsense: true schema: type: object properties: meta: $ref: '#/components/schemas/SimilarWebMeta' data: type: array items: type: object properties: domain: type: string category: type: string rank: type: integer affinity: type: number has_adsense: type: boolean components: schemas: SimilarWebMeta: type: object description: SimilarWeb v5 response envelope metadata. properties: status: type: string description: Upstream status; 'success' on a successful call. example: success last_updated: type: string description: Date of the most recent data point available upstream (YYYY-MM-DD). example: '2026-06-30' request: type: object description: >- Full echo of the normalized upstream request (parameters as received). query: type: object description: Pagination/sort echo when applicable (limit, offset, asc, sort). required: - status securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: AISA API Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.