API Documentation

Complete reference for all Actowiz APIs. Authentication, endpoints, response schemas, error codes, and SDKs. Get started in 5 minutes.

Base URL: https://api.actowiz.com/v1

Getting Started

Authentication, base URL, and your first API call.

Authentication — API Key Header
# Every request requires your API key in the header
curl -X GET "https://api.actowiz.com/v1/amazon/product?asin=B0CX23V2ZK" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

# Response: 200 OK with structured JSON
# Rate limit headers included: X-RateLimit-Remaining, X-RateLimit-Reset

API Endpoints

Click any endpoint for full documentation with request/response examples.

GET

/amazon/product

Product details by ASIN or URL. Returns 50+ fields including price, Buy Box, sellers.

GET

/amazon/search

Search results by keyword. Organic and sponsored positions with pricing.

GET

/amazon/reviews

Product reviews and ratings. Star distribution, sentiment, pagination.

GET

/walmart/product

Walmart product data. Rollback pricing, store inventory, Walmart+ deals.

GET

/shopify/product

Any Shopify store product. Variants, collections, pricing, inventory.

GET

/ebay/product

eBay listings. Auction bids, Buy Now, seller feedback, sold history.

GET

/serp/google

Google search results. Organic, ads, local pack, shopping, 195 countries.

GET

/extract/page

Universal extractor. Send any URL, get structured data back automatically.

GET

/reviews/product

Multi-platform reviews. Any e-commerce, travel, or restaurant site.

POST

/crawler/monitor

Live monitoring. Set up price watches, stock alerts, change detection.

POST

/scheduler/create

Job scheduling. Cron-based, pipelines, parallel execution, retry logic.

POST

/delivery/s3

Data delivery. Auto-push to S3, Snowflake, BigQuery, webhooks.

SDKs & Libraries

Official SDKs for your preferred language. One install, access every endpoint.

pip install actowiz

npm install actowiz

Maven: com.actowiz

Rate Limits & Errors

Understand rate limiting, error codes, and retry strategies.

Rate Limits

Starter: 10 req/sec · Growth: 50 req/sec · Enterprise: 200+ req/sec. Rate limit headers in every response. 429 on exceeded.

Error Codes

200 OK · 400 Bad Request · 401 Unauthorized · 403 Forbidden · 404 Not Found · 429 Rate Limited · 500 Server Error.

Retry Strategy

Exponential backoff recommended. SDKs handle retries automatically. Max 3 retries with jitter. Idempotent requests safe to retry.