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

// Etsy documentation

Etsy Search API Alpha

Search public products on Etsy. Prices and availability are returned only when present in the retailer response and may depend on location.

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

// from request to code

Integrate Etsy Search

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

APIEtsy Search
More options 1
Request parameters

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/etsy/search' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "ceramic mug"
}'

Read all parameters →

JSON POST request example

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

POST · application/json
{
  "query": "ceramic mug"
}

// request reference

Etsy Search parameters

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

Request parameters

query
QueryRequired

Product keywords to search for.

Type string · GET query or POST JSON

  • Minimum characters: 1
  • Maximum characters: 500
page
PageOptional

One-based result page.

Type integer · GET query or POST JSON · Default 1

  • Minimum: 1
  • Maximum: 100

// 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, products, 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": {
    "retailer": "Etsy",
    "provider_url": "https://www.etsy.com/market/ceramic_mug?page=1",
    "total_time_taken": 1.081
  },
  "search_parameters": {
    "query": "ceramic mug",
    "page": 1
  },
  "products": [
    {
      "product_id": "4554569423",
      "title": "Set of 3 Botanical Artisanal Coffee Mugs 14 Oz Stoneware, Minimalistic Fire Glazed Cups, Handcrafted Style Drinkware By Danica Heirloom",
      "url": "https://www.etsy.com/listing/4554569423/set-of-3-botanical-artisanal-coffee-mugs",
      "image": "https://i.etsystatic.com/36785243/r/il/720d73/8372976524/il_300x300.8372976524_36hl.jpg",
      "price": {
        "amount": 56.99,
        "currency": "USD",
        "text": "$56.99"
      }
    },
    {
      "product_id": "4448501401",
      "title": "Vintage Stoneware Coffee Mug, Handmade Japandi Pottery Cup, Rustic Ceramic Tea Mug, Wabi-Sabi Boho Home Decor",
      "url": "https://www.etsy.com/listing/4448501401/vintage-stoneware-coffee-mug-handmade",
      "image": "https://i.etsystatic.com/63629787/r/il/443478/7843843799/il_300x300.7843843799_te2q.jpg",
      "price": {
        "amount": 13.4,
        "currency": "USD",
        "text": "$13.40"
      }
    },
    {
      "product_id": "4296141840",
      "title": "Coffee Mug - KJ Pottery",
      "url": "https://www.etsy.com/listing/4296141840/coffee-mug-kj-pottery",
      "image": "https://i.etsystatic.com/7825028/r/il/553467/6863380541/il_300x300.6863380541_5poq.jpg",
      "price": {
        "amount": 57,
        "currency": "USD",
        "text": "$57.00"
      }
    }
  ],
  "pagination": {
    "current": 1
  },
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}

More Etsy APIs