SimilarwebAPI

SimilarwebAPI provides 27 read-only data endpoints under /v1/similarweb. Use the same account, API key, balance, and usage history as other RequestBeam APIs. Availability depends on an enabled gateway and your API key permissions; documentation does not confirm production availability.

Authentication

Send your RequestBeam API key, not a third-party credential:

Authorization: Bearer YOUR_API_KEY

Request Example

All public operations use GET with query parameters and no request body. Keep path and parameter capitalization exactly as documented.

Only worldwide data is supported (country=999). Other valid country values are changed to 999 before the upstream request and return worldwide, not country-specific, data.

For endpoints that accept dates, a valid, complete explicit from/to range takes precedence. On endpoints that accept latest, a supplied value must still pass the existing format and endpoint-specific validation, but is ignored for range selection and is not sent to Similarweb; no default latest is added. Without an explicit range, existing latest, default and window behavior is unchanged. History restrictions still apply, and endpoints that do not accept latest still reject it.

curl --get "https://api.apihop.ai/v1/similarweb/websites/incoming-referrals" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "key=example.com" \
  --data-urlencode "country=999" \
  --data-urlencode "page=1"

Incoming referrals use a single lowercase key hostname, not keys. This key is a business query parameter for the target website, not an API credential; it is permitted only on specifically allowlisted Similarweb GET routes. API authentication still uses Authorization and other credential query fields remain prohibited. Its rows are returned in Records, not Data. See the complete endpoint reference for each operation's exact fields.

Coverage

• Search: keyword suggestions, ranking pages, website keywords, organic and paid search, branded keywords.
• Website traffic: engagement, visits, geography, device mix, channels, and social traffic.
• Relationships: backlinks, incoming referrals, outgoing traffic, and similar websites.
• History: separate monthly visits, bounce rate, visit duration, and pages-per-visit series.

Responses

Successful responses preserve the native JSON body, without a new success/data envelope. Field names, unknown fields, empty arrays, and numeric precision remain unchanged. Different endpoints may return Data, Records, or another native shape; do not assume a universal row field.

An empty successful result does not mean the domain has no traffic. Failed requests must not be treated as empty data. Preserve X-Request-Id and the request time for troubleshooting.

Billing and Pagination

The standard price is $0.0005 per successful request, or $0.50 per 1,000 requests, across all 27 endpoints. Billing is per request, not per row; a successful empty result still counts as one request. Each subsequent page is a separate request. Account-specific pricing takes precedence where configured. Requests with invalid parameters, missing authorization, or insufficient balance do not proceed as successful billable calls. Failed upstream requests are not charged.

Your account must have at least $0.10 available before a call, as required by the platform's minimum balance policy. The standard charge remains $0.0005 per successful request.

Use only the pagination fields documented for the selected endpoint. Pagination is generally 1-based; backlinks use Page and PageSize, while other tables may use page, pageSize, or rowsPerPage. Do not send unsupported page-size fields.

Errors

Platform errors use the following shape; code is a platform business code, not an HTTP status:

{"success":false,"error":{"code":10000,"message":"Invalid request parameters"},"requestId":"..."}

Common HTTP statuses include 400 invalid query, 401 invalid API key, 402 insufficient balance, 403 gateway access denied, 429 rate limit, and 5xx temporary upstream or service failure. Do not retry malformed requests unchanged.