Etsy Product API documentation

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.

Etsy Product API Alpha

Retrieve a public product on Etsy. Prices and availability are returned only when present in the retailer response and may depend on location. Some listings provide only the title, image and price; other detail fields may be unavailable.

GET / POST https://ecll-litescrape-v3--site-api-web.modal.run/api/etsy/product

curl --fail-with-body --request POST 'https://ecll-litescrape-v3--site-api-web.modal.run/api/etsy/product' \ --header "Authorization: Bearer $LITESCRAPE_API_KEY" \ --header 'Content-Type: application/json' \ --data '{ "url": "https://www.etsy.com/listing/1510223855/the-libby-travel-mug-hand-thrown-ceramic" }'

JSON POST request example

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

{
  "url": "https://www.etsy.com/listing/1510223855/the-libby-travel-mug-hand-thrown-ceramic"
}

// request reference

Etsy Product parameters

Send query parameters with GET /api/etsy/product. 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.

Request parameters

url

UrlRequired

Public HTTPS product URL on this retailer's site.

Type string · GET query or POST JSON

Minimum characters: 1
Maximum characters: 4096

// 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, product, 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.

{
  "search_metadata": {
    "retailer": "Etsy",
    "provider_url": "https://www.etsy.com/market/the_libby_travel_mug_hand_thrown_ceramic?page=1",
    "total_time_taken": 1.038
  },
  "search_parameters": {
    "url": "https://www.etsy.com/listing/1510223855/the-libby-travel-mug-hand-thrown-ceramic"
  },
  "product": {
    "product_id": "1510223855",
    "title": "The Libby Travel Mug hand thrown ceramic mug cup Pottery Travel Mug Cup with attached lid fits in cup holder",
    "url": "https://www.etsy.com/listing/1510223855/the-libby-travel-mug-hand-thrown-ceramic",
    "image": "https://i.etsystatic.com/8740835/r/il/d4f720/7239142492/il_300x300.7239142492_oym6.jpg",
    "price": {
      "amount": 34.99,
      "currency": "USD",
      "text": "$34.99"
    }
  },
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}