---
title: "Queue a SimilarWeb traffic analytics batch"
method: POST
path: "/similarweb/batches"
tags: ["SimilarWeb"]
---

# Queue a SimilarWeb traffic analytics batch

`POST /similarweb/batches`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/similarweb/batches`
- Auth: API key in header `X-API-KEY`

Domains and URLs are normalized and deduplicated before the 1,000-domain limit is applied.
Raw input is capped at 2,000 entries to bound request parsing and normalization work.
The response is non-billable. Each successful domain consumes one credit when its result is stored.
Failed domains do not consume credits.
Invalid entries do not fail the batch. They are listed in `rejected` with their index and error and are never charged.
The request returns 422 only when no valid domain is left or a limit is exceeded.

## Request body

- SimilarWebBatchRequest
  - `domains` string[], required

## Response `202`

Batch accepted for asynchronous processing

- object
  - `id` string, required
  - `status` string, required
  - `submitted_total` integer, required
  - `total` integer, required
  - `deduplicated_total` integer, required
  - `rejected_total` integer, required
  - `rejected` object[], required
    - `index` integer, required
    - `input` string, nullable, required
    - `error` string, required
  - `status_url` string, required
  - `expires_at` string, required

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: Validation error

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/1e1aa78ff103?raw)