Batch API - Elastic Queries
Query your way. Elastic is the premium query mode of the Batch API — the same report you already know, sent to a parallel set of /elastic/... endpoints that unlock ad-hoc boolean filters, derived metrics, cross-table joins, and optional filters. In short: standard = fixed, catalog-shaped queries; Elastic = flexible, expression-driven queries over the same data.
Elastic is a premium capability.
Elastic is a premium query mode and is not enabled by default. Validating and pricing a report does not require it; running a report does. Contact your Similarweb account manager to enable Elastic for your account.
Quickstart
1
Validate & price
POST your report to /elastic/request-validate. You get back estimated_credits and any warnings, at no charge and with no Elastic enablement required.
2
Run the report
POST the same body to /elastic/request-report (requires Elastic enabled on your account). You get back a report_id and a status.
3
Retrieve results
Results are delivered by your chosen delivery method — download link, S3, GCS, or Snowflake — exactly like a standard Batch API report.
What Elastic adds
Advanced query (DSL)
A boolean filter expression, type-checked against the columns in your report. See Advanced Query Language.
Joins, sort and pagination
Join across tables, sort, and apply top-N — including top-N per group. See Joins, Sort and Pagination.
Optional filters and wildcards
Filters can be omitted, and wildcard matching is supported (up to 2 wildcard characters per value).
Standard vs. Elastic
Advanced query (DSL) | No | Yes |
Cross-table joins | No | Yes |
Optional filters | No — required filters apply | Yes — filters may be omitted |
Cost multiplier | 1x | 2x |
Service fee | None | 10,000 credits per report |
Cost
An Elastic report costs twice the base data credits plus a flat 10,000-credit service fee. Always price a query first with Validate Elastic Report — it returns estimated_credits with no charge.
estimated_credits = (base_data_credits x 2) + 10,000
Authentication
Authenticate with your Batch API key in the api-key header.
https://api.similarweb.com/batch/v5/elastic
Need help?
To enable Elastic or design an advanced query, reach out to your Similarweb account manager.
Endpoints
batch/v5/elastic/request-validate
batch/v5/elastic/request-report