Skip to main content
POST
Start a review refresh job

POST /api/v1/reviews/refresh

Trigger a review scraping job for an Amazon product.

Request

Headers: Body:

Response (202 Accepted)

Errors

Examples

cURL:
Python:
JavaScript:

Notes

  • Cooldown: Each ASIN can only be refreshed once per 24 hours (Free tier). Paid plans have shorter cooldowns.
  • Caching: Results are cached after job completion. Use GET /reviews to fetch without triggering a new job.
  • Concurrent jobs: The number of jobs you can run simultaneously depends on your plan.

Authorizations

Authorization
string
header
required

API key passed in Authorization header as Bearer token.

Body

application/json
asin
string
required
Pattern: ^[A-Z0-9]{10}$
Example:

"B08N5WRWNW"

marketplace
string

Optional. Defaults to amazon.de if omitted.

Example:

"amazon.de"

Response

Job queued

jobId
integer
required
Example:

2877

asin
string
required
Example:

"B08N5WRWNW"

status
enum<string>
required
Available options:
queued
Example:

"queued"

message
string
required
Example:

"Review refresh job created successfully"

estimatedCompletionSeconds
integer
required
Example:

60