eBay Seller 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.

curl --fail-with-body --get 'https://ecll-litescrape-v3--site-api-web.modal.run/api/ebay/seller' \ --header "Authorization: Bearer $LITESCRAPE_API_KEY" \ --data-urlencode 'seller_id=antonline' \ --data-urlencode 'type=store' \ --data-urlencode 'ebay_domain=ebay.com' \ --data-urlencode '_pgn=1' \ --data-urlencode '_ipg=48'

JSON POST request example

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

{
  "seller_id": "antonline",
  "type": "store",
  "_ipg": 24
}

// request reference

eBay Seller parameters

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

seller_id

Seller IDRequired

Seller username for type=user, or the store URL slug for type=store.

Type string · GET query or POST JSON

Pattern: ^[A-Za-z0-9][A-Za-z0-9_.*-]{0,99}$

type

Seller typeRequired

Public seller profile type.

Type string · GET query or POST JSON

Accepted valuesuserstore

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

Listing filters

buying_format

Buying formatOptional

All listings (0), Buy It Now (1), or auctions (2).

Type integer · GET query or POST JSON · Default 0

Accepted values012

LH_ItemCondition

Condition IDsOptional

Condition IDs joined with |: 3 new, 4 used, 10 unspecified.

Type string · GET query or POST JSON

Maximum characters: 20
Pattern: ^(?:3|4|10)(?:\|(?:3|4|10))*$

free_shipping

Free shippingOptional

Only products with free shipping.

Type boolean · GET query or POST JSON · Default false

Accepted valuestruefalse

Pagination and sorting

_pgn

PageOptional

Result page, starting at 1.

Type integer · GET query or POST JSON · Default 1

Minimum: 1
Maximum: 2147483647

_ipg

Products per pageOptional

Products per page.

Type integer · GET query or POST JSON · Default 48

Accepted values244872

_sop

Sort orderOptional

Sort: 12 best match, 1 ending soonest, 7 nearest, 10 newly listed, 15/16 total price ascending/descending.

Type integer · GET query or POST JSON · Default 12

Accepted values1710121516

// 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, seller_results, product_results, featured_categories, about, feedback, pagination, litescrape_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.

{
  "seller_results": {
    "type": "store",
    "name": "Antonline",
    "username": "antonline",
    "ssn": "antonline",
    "bio": "For over 30 years, America’s premier online retailer of cutting edge gaming and computer technology.",
    "follower_count": 71000,
    "positive_feedback_in_percentage": 99.5,
    "sold_count": 2400000,
    "profile_link": "https://www.ebay.com/str/antonline",
    "logo_link": "https://i.ebayimg.com/images/g/HywAAOSwTM5Y56a2/s-l140.webp",
    "banner": {
      "thumbnail": "https://i.ebayimg.com/images/g/YfcAAOSwRX9nt5Ip/s-l1600.webp",
      "thumbnail_height": 290,
      "thumbnail_width": 1280
    }
  },
  "product_results": [
    {
      "position": 1,
      "product_id": "295907273733",
      "product_link": "https://www.ebay.com/itm/295907273733?itmmeta=01M4J0GMS08CG2KVRWFGKZ8ANF&hash=item44e572ac05:g:uNwAAeSwpIVonhgB",
      "title": "HP 17.3\" FHD AMD Ryzen 5 7430U AI Laptop 8GB RAM 256GB SSD Natural Silver",
      "price": {
        "amount": 459.99,
        "currency": "USD"
      },
      "old_price": {
        "amount": 599.99,
        "currency": "USD"
      },
      "thumbnail": "https://i.ebayimg.com/images/g/uNwAAeSwpIVonhgB/s-l300.webp",
      "thumbnail_height": 1360,
      "thumbnail_width": 1600,
      "availability_signal": "250 remaining",
      "shipping": "Free delivery in 2-4 days"
    },
    {
      "position": 2,
      "product_id": "128120058408",
      "product_link": "https://www.ebay.com/itm/128120058408?itmmeta=01M4J0GMS0JWTMC39BPTP2NE5M&hash=item1dd48cf228:g:QfUAAeSw1N1qxcZc",
      "title": "Gears of War E Day Standard Edition Xbox Series X + Xbox Wireless Controller Gea",
      "price": {
        "amount": 159.98,
        "currency": "USD"
      },
      "thumbnail": "https://i.ebayimg.com/images/g/QfUAAeSw1N1qxcZc/s-l300.webp",
      "thumbnail_height": 500,
      "thumbnail_width": 500,
      "availability_signal": "266 remaining",
      "shipping": "Free delivery in 2-4 days"
    }
  ],
  "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"
}

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

eBay Seller API

Integrate eBay Seller

JSON POST request example

eBay Seller parameters

Request

Marketplace

Listing filters

Pagination and sorting

Work with the complete JSON response

More eBay APIs