Skip to main content

​
Overview

Company-scoped; requires Authorization: Bearer nv_sk_…. Pay-per-use via our data provider. All product/info/seller/review endpoints are Standard (async): POST to …/task to enqueue, poll …/tasks-ready, then fetch …/task/:id (an …/task/:id/html variant returns the raw HTML). MCP equivalents: naive_ecommerce_discover + naive_ecommerce_execute(_async). Common params: keyword (product search), product_id (Google Shopping), asin (Amazon), optional location_code, language_code, depth.

​
Google Shopping

MethodPathDescription
POST/v1/ecommerce/google/products/taskSubmit product search task
GET/v1/ecommerce/google/products/tasks-readyCheck ready search tasks
GET/v1/ecommerce/google/products/task/:idGet product results
GET/v1/ecommerce/google/products/task/:id/htmlGet product results (HTML)
POST/v1/ecommerce/google/product-info/taskSubmit product info task
GET/v1/ecommerce/google/product-info/tasks-readyCheck ready info tasks
GET/v1/ecommerce/google/product-info/task/:idGet product info results
GET/v1/ecommerce/google/product-info/task/:id/htmlGet product info results (HTML)
POST/v1/ecommerce/google/sellers/taskSubmit sellers task
GET/v1/ecommerce/google/sellers/tasks-readyCheck ready seller tasks
GET/v1/ecommerce/google/sellers/task/:idGet seller results
GET/v1/ecommerce/google/sellers/task/:id/htmlGet seller results (HTML)
GET/v1/ecommerce/google/sellers/ad-url/:aclkGet ad click URL for a seller
POST/v1/ecommerce/google/reviews/taskSubmit reviews task
GET/v1/ecommerce/google/reviews/tasks-readyCheck ready review tasks
GET/v1/ecommerce/google/reviews/task/:idGet review results
GET/v1/ecommerce/google/reviews/task/:id/htmlGet review results (HTML)

​
Amazon

MethodPathDescription
POST/v1/ecommerce/amazon/products/taskSubmit product search task
GET/v1/ecommerce/amazon/products/tasks-readyCheck ready search tasks
GET/v1/ecommerce/amazon/products/task/:idGet product results
GET/v1/ecommerce/amazon/products/task/:id/htmlGet product results (HTML)
POST/v1/ecommerce/amazon/asin/taskSubmit ASIN lookup task
GET/v1/ecommerce/amazon/asin/tasks-readyCheck ready ASIN tasks
GET/v1/ecommerce/amazon/asin/task/:idGet ASIN results
GET/v1/ecommerce/amazon/asin/task/:id/htmlGet ASIN results (HTML)
POST/v1/ecommerce/amazon/sellers/taskSubmit sellers task
GET/v1/ecommerce/amazon/sellers/tasks-readyCheck ready seller tasks
GET/v1/ecommerce/amazon/sellers/task/:idGet seller results
GET/v1/ecommerce/amazon/sellers/task/:id/htmlGet seller results (HTML)

​
Utility

MethodPathDescription
GET/v1/ecommerce/google/locationsAvailable Google locations
GET/v1/ecommerce/google/languagesAvailable Google languages
GET/v1/ecommerce/amazon/locationsAvailable Amazon locations
GET/v1/ecommerce/amazon/languagesAvailable Amazon languages
POST/v1/ecommerce/id-listList task IDs

​
Example (async flow)

# 1. Enqueue an Amazon product search
curl -X POST https://api.usenaive.ai/v1/ecommerce/amazon/products/task \
  -H "Authorization: Bearer nv_sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "keyword": "wireless headphones", "location_code": 2840, "language_code": "en" }'

# 2. Poll, then 3. fetch results
curl https://api.usenaive.ai/v1/ecommerce/amazon/products/tasks-ready \
  -H "Authorization: Bearer nv_sk_your_key"
curl https://api.usenaive.ai/v1/ecommerce/amazon/products/task/TASK_ID \
  -H "Authorization: Bearer nv_sk_your_key"