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

// eBay documentation

eBay Product API

Read an eBay listing by item ID: title, price, buying options, images, condition, item specifics, shipping, returns and seller details. Fields depend on the listing.

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

// from request to code

Integrate eBay Product

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

APIeBay Product
More options 4
Marketplace

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 --get 'https://ecll-litescrape-v3--site-api-web.modal.run/api/ebay/product' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --data-urlencode 'product_id=305576857892' \
  --data-urlencode 'ebay_domain=ebay.com'

Read all parameters →

JSON POST request example

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

POST · application/json
{
  "product_id": "305576857892"
}

// request reference

eBay Product parameters

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

product_id
Product IDRequired

12-digit eBay listing ID from search results or an /itm/ URL.

Type string · GET query or POST JSON

Example / input hint: 305576857892

  • Pattern: ^[0-9]{12}$

Marketplace

ebay_domain
MarketplaceOptional

eBay marketplace hostname.

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

Accepted valuesebay.comebay.co.ukebay.caebay.com.auebay.deebay.frebay.itebay.esebay.atebay.beebay.chebay.ieebay.nlebay.com.hkebay.com.myebay.plebay.com.sg
locale
Locale countryOptional

Country code for eBay's localized interface, e.g. US, JP, CA.

Type string · GET query or POST JSON

lang
Interface languageOptional

Interface language override; requires locale and ebay.com.

Type string · GET query or POST JSON

  • Maximum characters: 12
  • Pattern: ^[a-z]{2,3}(?:-[A-Za-z]{2,4})?$
shipping_country
Shipping countryOptional

Two-letter destination country code for shipping calculations.

Type string · GET query or POST JSON

// 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_results, seller_results, related_products, 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
{
  "product_results": {
    "product_id": "305576857892",
    "product_link": "https://www.ebay.com/itm/305576857892",
    "title": "PlayStation 5 Slim Console + Extra PS5 DualSense Controller Starlight Blue",
    "price": {
      "amount": 688.73,
      "currency": "USD"
    },
    "availability": "OutOfStock",
    "item_specifics": {
      "Brand": "Sony"
    }
  },
  "seller_results": {
    "name": "Antonline",
    "username": "antonline",
    "positive_feedback": 99.5
  },
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}

More eBay APIs