Litescrape sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.litescrape.com/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

← All documentation

// Amazon documentation

Amazon Search API Alpha

Search Amazon product listings with storefront, delivery, category, sorting and pagination controls.

GET / POST https://ecll-litescrape-v3--site-api-web.modal.run/api/amazon/search

// from request to code

Integrate Amazon Search

Build your request and copy it into your stack. Or let your coding agent set it up.

APIAmazon Search
More options 9
Search query

Choose search terms or a browse category.

Storefront and delivery

Choose a storefront, language and delivery destination.

Sorting and filters

Order results and apply Amazon filters.

Pagination

Choose which result page to retrieve.

Your request updates the code instantly.

Open the Playground →

Set LITESCRAPE_API_KEY on your server, then run this request.

request.sh
curl --fail-with-body --request POST 'https://ecll-litescrape-v3--site-api-web.modal.run/api/amazon/search' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "k": "coffee",
  "dc": false
}'

Read all parameters →

JSON POST request example

POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/amazon/search with Content-Type: application/json and your Authorization: Bearer header.

POST · application/json
{
  "k": "coffee"
}

// request reference

Amazon Search parameters

Send query parameters with GET /api/amazon/search. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.

POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.

Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.

Search query

Choose search terms or a browse category.

k
Search termsOptional

Search words. Supply either k or node.

Type string · GET query or POST JSON

  • Minimum characters: 1
node
CategoryOptional

Browse category ID. Supply either node or k.

Type string · GET query or POST JSON

  • Pattern: ^[0-9]+$

Storefront and delivery

Choose a storefront, language and delivery destination.

amazon_domain
Amazon domainOptional

Amazon storefront hostname.

Type string · GET query or POST JSON · Default amazon.com

language
LanguageOptional

Storefront locale, such as en_US or ja_JP.

Type string · GET query or POST JSON

  • Pattern: ^[a-z]{2}_[A-Z]{2}$
delivery_zip
Delivery postal codeOptional

Postal code used to determine delivery eligibility.

Type string · GET query or POST JSON

  • Minimum characters: 1
  • Maximum characters: 32
shipping_location
Shipping countryOptional

Two-letter destination country code.

Type string · GET query or POST JSON

  • Pattern: ^[A-Z]{2}$

Sorting and filters

Order results and apply Amazon filters.

s
Sort orderOptional

Ordering for the product listings.

Type string · GET query or POST JSON · Default relevanceblender

Accepted valuesrelevanceblenderprice-asc-rankprice-desc-rankreview-rankdate-desc-rankexact-aware-popularity-rank
rh
FiltersOptional

Comma-separated Amazon filter tokens, such as n:16318031,p_72:1248897011.

Type string · GET query or POST JSON

dc
Original spellingOptional

Keep results tied to the original spelling of the query.

Type boolean · GET query or POST JSON · Default false

Accepted valuestruefalse

Pagination

Choose which result page to retrieve.

page
PageOptional

Result page to retrieve, starting at 1.

Type integer · GET query or POST JSON · Default 1

  • Minimum: 1

// response

Work with the complete JSON response

Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.

Response groups include search_metadata, search_parameters, search_information, organic_results, product_ads, pagination, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.

Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.

Illustrative success response. Result groups and optional fields depend on upstream content.

200 · application/json
{
  "search_metadata": {
    "status": "Success"
  },
  "search_parameters": {
    "k": "coffee"
  },
  "organic_results": [
    {
      "asin": "B072MQ5BRX",
      "title": "Ground coffee",
      "position": 1
    }
  ],
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}

More Amazon APIs