Skip to main content

​
Overview

CommandDescriptionMethod
naive ecommerce google <endpoint>Google Shopping product dataStandard (async)
naive ecommerce amazon <endpoint>Amazon product dataStandard (async)
All endpoints use the Standard (async) method except Google Shopping Sellers Ad URL.

​
Google Shopping

naive ecommerce google products --keyword "wireless headphones" --location-code 2840
naive ecommerce google product-info --product-id "abc123"
naive ecommerce google sellers --product-id "abc123"
naive ecommerce google reviews --product-id "abc123" --limit 50

​
Endpoints

EndpointDescriptionMethod
productsSearch product listingsStandard
product-infoDetailed product informationStandard
sellersSeller list for a productStandard
sellers-ad-urlGet ad click URL for a sellerGET
reviewsProduct reviewsStandard

​
Options

FlagRequiredDescription
--keyword <text>VariesProduct search keyword
--product-id <id>VariesProduct identifier
--location-code <code>NoLocation code
--language-code <code>NoLanguage code
--depth <n>NoNumber of results (default: 100)
--limit <n>NoMax reviews to retrieve

​
Sellers Ad URL

Get the ad click URL for a Google Shopping seller: 
naive ecommerce google-sellers-ad-url --aclk "encoded_aclk_string"
FlagRequiredDescription
--aclk <string>YesThe encoded ad click parameter

​
Amazon

naive ecommerce amazon products --keyword "bluetooth speaker" --location-code 2840
naive ecommerce amazon asin --asin "B09XYZ1234"
naive ecommerce amazon sellers --asin "B09XYZ1234"

​
Endpoints

EndpointDescriptionMethod
productsSearch product listingsStandard
asinGet product info by ASINStandard
sellersSeller list for a productStandard

​
Options

FlagRequiredDescription
--keyword <text>VariesProduct search keyword
--asin <id>VariesAmazon ASIN
--location-code <code>NoLocation code
--language-code <code>NoLanguage code
--depth <n>NoNumber of results

​
Task Management

All async endpoints return a task ID: 
# Submit task
naive ecommerce google products --keyword "headphones"
# → task_id: abc-123

# Check ready tasks
naive ecommerce tasks-ready --platform google --endpoint products

# Get results
naive ecommerce task-get abc-123 --platform google --endpoint products

# Get HTML format
naive ecommerce task-get abc-123 --platform google --endpoint products --format html

# Get advanced format
naive ecommerce task-get abc-123 --platform google --endpoint products --format advanced
FlagDescription
naive ecommerce tasks-ready --platform <p> --endpoint <e>List tasks with ready results
naive ecommerce task-get <task_id> --platform <p> --endpoint <e>Retrieve results for a task
--format <type>Output format: advanced or html