SearchData and SERP APIs
Commerce and search result endpoints, engines, request fields, and response behavior.
SearchData commerce APIs return structured retailer and marketplace data. SERP APIs return structured search engine results or raw HTML, depending on the selected engine and response mode.
| Endpoint | Base URL | Methods | API type |
|---|---|---|---|
| SearchData commerce | https://ecom.webscrapingapi.com/v1 | GET, POST | Product, search, review, seller, and async commerce engines. |
| SERP | https://serpapi.webscrapingapi.com/v2 | GET | Google, Bing, DuckDuckGo, Yandex, and specialized Google SERP engines. |
SearchData common parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
api_key | string | ✅ | Authentication. |
engine | string | Yes unless polling snapshot_id | Selects the scraper or SERP engine. |
device | string | ❌ | Used by engines that support device selection. |
body | JSON string or body payload | For async batch engines | Batch input. Batch engines accept up to 5000 input items. |
snapshot_id | string | Only when polling | Polls a previously submitted async job. |
If your key is entitled only for the newer SERP API, commerce /v1 requests return This endpoint is deprecated. Please use /v2.
Current SearchData engines
| Engine | Type values | Required input |
|---|---|---|
amazon | product, search, bestsellers, category, new-releases, todays-deals, seller_products, seller_profile, seller_feedback | Depends on type: product_id, q, category_id, parent_alias, or seller_id |
crateandbarrel | product, reviews | url |
ebay | product | epid or url |
freedom | product, reviews | product_id or url |
homedepot | product | product_id |
johnlewis | product, reviews | url |
lowes | product | product_id |
target | product | product_id |
walmart_spreetail | product | product_id or url |
wayfair_spreetail | product | product_id or url |
westelm | product | url |
bestbuy_async | product | POST body array |
booking_async | hotel, hotel_pricing, search | POST body array |
chatgpt_async | prompt | POST body array |
nordstrom_async | product | POST body array |
wayfair_async | product | POST body array |
walmart_spreetail and wayfair_spreetail are the current input engine names. Responses may still normalize search_parameters.engine to walmart or wayfair for compatibility.
Amazon parameters
| Parameter | Applies to | Notes |
|---|---|---|
type | Required | seller is accepted as an alias for seller_products. |
product_id | type=product | Amazon ASIN or product id. |
q | type=search | Search query. |
category_id | category, bestsellers, new-releases, todays-deals | Category identifier. |
parent_alias | bestsellers, new-releases | Sub-category parent alias. |
seller_id | seller_products, seller_profile, seller_feedback | Seller identifier. |
amazon_domain | optional | Defaults to amazon.com; also controls proxy country when known. |
delivery_location | optional | One of au, br, ca, cn, de, es, fr, gb, in, jp, mx, us. Overrides proxy country. |
hl, gl, zip_code | optional | Localization values forwarded to the scraper. |
page, sort_by, filter_by | optional | Search/listing controls. |
lazy_loading, scroll_to_bottom, wait_bottom_carousel, wait_for_offers, wait_for_video | optional booleans | Rendering and page-load controls. |
SERP common behavior
/v2 requires engine. Requests are validated against the selected engine, so unsupported parameters return Parameter '<name>' not allowed.
| Engine | Required input |
|---|---|
bing | q |
duckduckgo | q |
google | q |
google_async | q |
google_flights | q |
google_hotels | type=search with q, or type=place with pid |
google_maps | type=search with q, or type=place with data |
google_maps_reviews | fid |
google_reverse_image | url |
google_trends | q |
yandex | q |
Only engines listed here should be treated as supported SERP API engines. Additional planned or internal engines are not available until they appear in this reference.
SERP output
Some SERP engines support a response option:
| Value | Behavior |
|---|---|
html | Returns raw HTML in result with search_parameters. |
json | Returns parsed JSON when the selected engine supports structured output. |
Use the response field only when the selected engine documents it. Engines that do not expose response return their default format.
Examples
Amazon product:
curl --get "https://ecom.webscrapingapi.com/v1" \
--data-urlencode "api_key=YOUR_API_KEY" \
--data-urlencode "engine=amazon" \
--data-urlencode "type=product" \
--data-urlencode "product_id=B07G9MNF3Q"Walmart product with current engine name:
curl --get "https://ecom.webscrapingapi.com/v1" \
--data-urlencode "api_key=YOUR_API_KEY" \
--data-urlencode "engine=walmart_spreetail" \
--data-urlencode "type=product" \
--data-urlencode "product_id=631259576"Google SERP JSON:
curl --get "https://serpapi.webscrapingapi.com/v2" \
--data-urlencode "api_key=YOUR_API_KEY" \
--data-urlencode "engine=google" \
--data-urlencode "q=coffee" \
--data-urlencode "response=json" \
--data-urlencode "device=desktop"Google async SERP submit and poll:
curl --get "https://serpapi.webscrapingapi.com/v2" \
--data-urlencode "api_key=YOUR_API_KEY" \
--data-urlencode "engine=google_async" \
--data-urlencode "q=events in new york city"curl --get "https://serpapi.webscrapingapi.com/v2" \
--data-urlencode "api_key=YOUR_API_KEY" \
--data-urlencode "snapshot_id=RESPONSE_ID_FROM_SUBMIT" \
--data-urlencode "type=serp"