Overview
| Command | Description | Method |
|---|---|---|
naive ecommerce google <endpoint> | Google Shopping product data | Standard (async) |
naive ecommerce amazon <endpoint> | Amazon product data | Standard (async) |
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"
Endpoints
| Endpoint | Description | Method |
|---|---|---|
| products | Search product listings | Standard |
| product-info | Detailed product information | Standard |
| sellers | Seller list for a product | Standard |
| sellers-ad-url | Get ad click URL for a seller | GET |
| reviews | Product reviews | Standard |
Options
| Flag | Required | Description |
|---|---|---|
--keyword <text> | Varies | Product search keyword |
--product-id <id> | Varies | Product identifier |
--location-code <code> | No | Location code |
--language-code <code> | No | Language code |
--tag <tag> | No | Tag for the task |
Sellers Ad URL
Get the ad click URL for a Google Shopping seller:naive ecommerce google-sellers-ad-url --aclk "encoded_aclk_string"
| Flag | Required | Description |
|---|---|---|
--aclk <string> | Yes | The 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
| Endpoint | Description | Method |
|---|---|---|
| products | Search product listings | Standard |
| asin | Get product info by ASIN | Standard |
| sellers | Seller list for a product | Standard |
Options
| Flag | Required | Description |
|---|---|---|
--keyword <text> | Varies | Product search keyword |
--asin <id> | Varies | Amazon ASIN |
--location-code <code> | No | Location code |
--language-code <code> | No | Language code |
--tag <tag> | No | Tag for the task |
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
| Flag | Description |
|---|---|
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 |