eBay (website)

Public eBay website data for ebay.co.uk and ebay.com: live listing search with filters, full item pages with variations, shipping, returns and the seller's description, seller profiles, a seller's shop listings and seller feedback.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

Site: ebay-web
Version: 1.0.0
Reads from: ebay.co.uk, ebay.com, ebaydesc.com

Action	Description	Listed price
`search`	Search live eBay listings by keyword, category or seller on ebay.co.uk or ebay.com, up to 240 a page: price, condition, delivery, location, auction bids and time left, Best Offer, watchers and units sold. Filter by price, condition, auction or Buy It Now, Best Offer and free delivery, and sort by price, newest or ending soonest. Sold and completed listings are not available: eBay's website shows them only to signed-in members.	Billed per request at your plan's rates
`item`	Read eBay listing pages by item id or URL on ebay.co.uk or ebay.com: title, price or current bid, Best Offer, condition, stock and units sold, start and end, the seller with feedback, type and shop, location, delivery options with costs and estimates, posting area, returns policy, category, images, item specifics and every variation with its price and stock; for an ended listing, whether it sold and at what price; optionally the seller's description as plain text.	Billed per request at your plan's rates
`seller`	Read eBay seller profiles and shops by username or URL on ebay.co.uk or ebay.com: shop name, feedback score and positive percentage, items sold, followers, location, member since, About text, the last 12 months' positive, neutral and negative ratings, detailed seller ratings and the seller's categories.	Billed per request at your plan's rates
`listings`	List a seller's live eBay listings from their profile or shop on ebay.co.uk or ebay.com, up to 72 a page in the shop's own order: price, earlier price, condition, auction bids and end, stock, delivery and location. For keyword or price filters within one seller, use search with seller.	Billed per request at your plan's rates
`feedback`	Read a member's public eBay feedback, newest first, up to 200 entries a page: rating, masked member and their score, when, comment, verified purchase and, for recent orders, the item and price. Filter by role (received as seller or buyer, or left for others) and period.	Billed per request at your plan's rates

`search`

Search live eBay listings by keyword, category or seller on ebay.co.uk or ebay.com, up to 240 a page: price, condition, delivery, location, auction bids and time left, Best Offer, watchers and units sold. Filter by price, condition, auction or Buy It Now, Best Offer and free delivery, and sort by price, newest or ending soonest. Sold and completed listings are not available: eBay's website shows them only to signed-in members.

POST https://request.usestring.ai/v1/integrations/ebay-web/search

Input

Unknown fields are rejected.

Field	Type	Description
`query`	string	Search terms, as typed in eBay's search box. One of query, categoryId or seller is required.
`categoryId`	string	An eBay category id, such as 19006 for LEGO Complete Sets & Packs; with query it narrows the search to that category. Matches `^\d{1,9}$`.
`seller`	string	Only this seller's listings: a username or /usr/ profile URL.
`marketplace`	`uk` `us`	uk for ebay.co.uk (the default) or us for ebay.com: whose prices, delivery and links the rows carry.
`sort`	`best_match` `ending_soonest` `newly_listed` `price_low` `price_high`	best_match (the default), ending_soonest, newly_listed, price_low or price_high; the price sorts include delivery.
`buyingFormat`	`all` `auction` `buy_it_now`	all (the default), auction or buy_it_now; buy_it_now also keeps auctions that offer Buy It Now.
`bestOffer`	boolean	Only listings whose seller accepts offers.
`condition`	`any` `new` `used` `refurbished` `for_parts`	any (the default), new, used, refurbished (every refurbished grade) or for_parts (for parts or not working)
`minPrice`	number \| null	Lowest item price, in the marketplace's currency. At least 0.
`maxPrice`	number \| null	Highest item price, in the marketplace's currency. At least 0.
`freeShipping`	boolean	Only listings with free delivery to the marketplace's country.
`sold`	boolean	Sold and completed listings. Not available: eBay's website shows them only to signed-in members, so true fails with an input error; the item action reads an ended listing by id.
`pages`	integer	How many pages of up to 240 listings to read, from 1 (the default) to 40. From 1 to 40.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`itemId`	string	—
`url`	string	The listing on the marketplace's own site.
`title`	string	—
`subtitle`	string \| null	The line eBay shows under the title besides the condition, such as Apple iPhone 13 · 128 GB · Unlocked or Size M + more.
`condition`	string \| null	As eBay shows it, such as Brand New, Pre-Owned or Refurbished.
`price`	number \| null	The price eBay shows, or the low end of a range across variations, in currency. eBay's displayed UK price can include its buyer protection fee.
`priceMax`	number \| null	The high end of a price range across variations; null for a single price.
`currency`	string \| null	ISO 4217 currency of the prices and shippingCost, such as GBP or USD.
`priceText`	string \| null	The price as eBay shows it, such as £516.70 or £4.99 to £5.99.
`originalPrice`	number \| null	The struck-through earlier price of a discounted listing.
`shippingCost`	number \| null	Delivery to the marketplace's country: 0 when free, null when the card shows no price.
`shippingText`	string \| null	The delivery line as eBay shows it, such as +£2.94 delivery or Free delivery in 2-4 days.
`location`	string \| null	Where the item is, such as Located in China; eBay omits it for most domestic listings on ebay.co.uk.
`buyingFormat`	string	auction or fixed_price.
`buyItNow`	boolean	Whether the card offers Buy It Now.
`bestOffer`	boolean	Whether the seller accepts offers.
`bids`	integer \| null	An auction's bid count.
`timeLeft`	string \| null	An auction's time left as eBay shows it, such as 3d 5h.
`seller`	string \| null	The seller's username, on the cards that show it.
`sellerFeedbackScore`	integer \| null	—
`sellerPositivePercent`	number \| null	From 0 to 100.
`watchers`	integer \| null	Watchers, on the cards that show them; 100+ reads as 100.
`soldCount`	integer \| null	Units sold, on the cards that show it; 1K+ reads as 1000.
`freeReturns`	boolean	—
`imageUrl`	string \| null	—
`marketplace`	string	—
`page`	integer	—
`position`	integer	The listing's position across the pages read, from 1.

Example

curl https://request.usestring.ai/v1/integrations/ebay-web/search \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "lego millennium falcon"
  }'

data starts with these rows:

[
  {
    "itemId": "137888069645",
    "url": "https://www.ebay.co.uk/itm/137888069645",
    "title": "LEGO Star Wars: Millennium Falcon (75375)",
    "subtitle": null,
    "condition": "Brand new",
    "price": 42.3,
    "priceMax": null,
    "currency": "GBP",
    "priceText": "£42.30",
    "originalPrice": null,
    "shippingCost": 2.7,
    "shippingText": "+£2.70 delivery in 2-3 days",
    "location": null,
    "buyingFormat": "fixed_price",
    "buyItNow": true,
    "bestOffer": true,
    "bids": null,
    "timeLeft": null,
    "seller": null,
    "sellerFeedbackScore": null,
    "sellerPositivePercent": null,
    "watchers": null,
    "soldCount": null,
    "freeReturns": false,
    "imageUrl": "https://i.ebayimg.com/images/g/W4gAAeSw8eFq5RNY/s-l500.webp",
    "marketplace": "uk",
    "page": 1,
    "position": 1
  },
  {
    "itemId": "287687417176",
    "url": "https://www.ebay.co.uk/itm/287687417176",
    "title": "LEGO Star Wars UCS Millennium Falcon 75192 7541pcs Set Boxed 16+",
    "subtitle": null,
    "condition": "Brand new",
    "price": 516.7,
    "priceMax": null,
    "currency": "GBP",
    "priceText": "£516.70",
    "originalPrice": null,
    "shippingCost": 0,
    "shippingText": "Free delivery",
    "location": null,
    "buyingFormat": "auction",
    "buyItNow": false,
    "bestOffer": true,
    "bids": 0,
    "timeLeft": "3d 4h",
    "seller": null,
    "sellerFeedbackScore": null,
    "sellerPositivePercent": null,
    "watchers": null,
    "soldCount": null,
    "freeReturns": false,
    "imageUrl": "https://i.ebayimg.com/images/g/lYcAAeSwHQxq4hwT/s-l500.webp",
    "marketplace": "uk",
    "page": 1,
    "position": 2
  }
]

Requests and billing

Requests: 1 Web Access request per result page.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`item`

Read eBay listing pages by item id or URL on ebay.co.uk or ebay.com: title, price or current bid, Best Offer, condition, stock and units sold, start and end, the seller with feedback, type and shop, location, delivery options with costs and estimates, posting area, returns policy, category, images, item specifics and every variation with its price and stock; for an ended listing, whether it sold and at what price; optionally the seller's description as plain text.

POST https://request.usestring.ai/v1/integrations/ebay-web/item

Input

Unknown fields are rejected.

Field	Type	Description
`items`	string[]	Required. eBay item ids, such as 287687417176, or /itm/ URLs on ebay.co.uk or ebay.com. 1 to 20 entries.
`marketplace`	`uk` `us`	uk for ebay.co.uk (the default) or us for ebay.com: whose prices, delivery and links each record carries, whichever site a URL names.
`description`	boolean	Also read the seller's own description of each listing, as plain text; one more request per item.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`itemId`	string	—
`url`	string	The listing on the marketplace's own site.
`marketplace`	string	—
`title`	string	—
`listedOn`	string \| null	The eBay site the seller listed on, such as EBAY_GB or EBAY_US.
`status`	string \| null	Such as ACTIVE or ENDED.
`buyingFormat`	string	auction or fixed_price.
`price`	number \| null	The fixed price, or an auction's current bid, in currency, as the page shows it to a visitor in the marketplace's country. For a listing with variations, the price before one is chosen.
`currency`	string \| null	ISO 4217, such as GBP or USD.
`priceText`	string \| null	The price as eBay shows it, such as £12.99 or US $50.00.
`buyItNowPrice`	number \| null	An auction's Buy It Now price, when it offers one.
`bestOffer`	boolean	Whether the seller accepts offers.
`bids`	integer \| null	An auction's bid count.
`condition`	string \| null	Such as New, Used or New with box.
`availability`	string \| null	The stock line as eBay shows it, such as More than 10 available or Last one.
`quantitySold`	integer \| null	Units sold, across variations.
`startTime`	string \| null	RFC 3339.
`endTime`	string \| null	RFC 3339; a fixed-price listing that renews each month carries its next renewal.
`seller`	string \| null	The seller's username.
`sellerName`	string \| null	The name on the seller card: the shop name for a seller with a shop, else the username.
`sellerFeedbackScore`	integer \| null	—
`sellerPositivePercent`	number \| null	Positive feedback over the last 12 months, from 0 to 100.
`sellerType`	string \| null	business or private, as the seller registered.
`sellerItemsSold`	integer \| null	Items the seller has sold, as eBay rounds it (103K reads as 103000)
`sellerJoined`	string \| null	When the seller joined, as eBay shows it, such as Oct 2012.
`storeUrl`	string \| null	The seller's eBay shop, when they have one.
`location`	string \| null	Where the item is, such as Rochdale, United Kingdom.
`shipping`	object[] \| null	The delivery options eBay offers to the marketplace's country, in the page's order; empty when the seller does not post there.
`shipping[].cost`	number \| null	In currency; 0 when free.
`shipping[].currency`	string \| null	—
`shipping[].costText`	string	As eBay shows it, such as Free delivery in 1-2 days or £9.99 delivery in 1–2 days.
`shipping[].service`	string \| null	Such as Royal Mail 24.
`shipping[].estimate`	string \| null	eBay's delivery estimate to the visitor's location, such as Estimated between Tue, 3 Nov and Wed, 4 Nov.
`shipping[].eachAdditional`	number \| null	The cost for each further unit in one order, when the seller sets one.
`shippingNote`	string \| null	The postage line when eBay shows no options, such as May not post to United States.
`shipsTo`	string \| null	Where the seller posts, as eBay lists it.
`shippingExcludes`	string \| null	Places the seller does not post to.
`dispatchTime`	string \| null	The seller's handling time, as eBay shows it.
`returnsAccepted`	boolean \| null	—
`returnPeriodDays`	integer \| null	—
`returns`	object[] \| null	The returns policy lines, such as Returns: Accepted within 30 days and Returns postage: Buyer pays return postage.
`returns[].label`	string	—
`returns[].value`	string	—
`categoryPath`	string[] \| null	The listing's category names from the top.
`imageUrls`	string[] \| null	—
`specifics`	object[] \| null	Item specifics in the page's order, such as Brand: LEGO; Condition carries eBay's condition definition.
`specifics[].name`	string	—
`specifics[].values`	string[] \| null	—
`variations`	object[] \| null	Each variation of a multi-variation listing, such as one per size and colour; empty otherwise.
`variations[].variationId`	string	—
`variations[].specifics`	object[] \| null	What sets the variation apart, such as Size: MEDIUM and Colour: Navy.
`variations[].specifics[].name`	string	—
`variations[].specifics[].values`	string[] \| null	—
`variations[].price`	number \| null	—
`variations[].currency`	string \| null	—
`variations[].outOfStock`	boolean	—
`variations[].availability`	string \| null	The variation's stock line, such as More than 10 available or Out of stock.
`variations[].quantitySold`	integer \| null	Units sold, as eBay shows it on the variation (often the listing's total)
`statusMessage`	string \| null	The notice eBay shows on an ended listing, such as Item sold on Sun, 1 Nov at 12:50 PM. or Bidding ended on Sun, 1 Nov at 12:46 PM.
`sold`	boolean \| null	For an ended listing, whether eBay says it sold; then price is the winning bid or sale price and bids the final count. Null while the listing is live.
`description`	string \| null	The seller's description as plain text, one line per paragraph or list entry, when the input asks for it; null when it does not or the seller wrote none.

Example

curl https://request.usestring.ai/v1/integrations/ebay-web/item \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": ["287687417176", "https://www.ebay.co.uk/itm/115805287483"]
  }'

data starts with these rows:

[
  {
    "itemId": "287687417176",
    "url": "https://www.ebay.co.uk/itm/287687417176",
    "marketplace": "uk",
    "title": "LEGO Star Wars UCS Millennium Falcon 75192 7541pcs Set Boxed 16+",
    "listedOn": "EBAY_GB",
    "status": "ACTIVE",
    "buyingFormat": "auction",
    "price": 516.7,
    "currency": "GBP",
    "priceText": "£516.70",
    "buyItNowPrice": null,
    "bestOffer": true,
    "bids": 0,
    "condition": "New",
    "availability": null,
    "quantitySold": null,
    "startTime": "2026-10-28T16:05:04.000Z",
    "endTime": "2026-11-04T16:05:04.000Z",
    "seller": "joer6405",
    "sellerName": "joer6405",
    "sellerFeedbackScore": 733,
    "sellerPositivePercent": 100,
    "sellerType": "private",
    "sellerItemsSold": 450,
    "sellerJoined": "Jan 2006",
    "storeUrl": null,
    "location": "York, United Kingdom",
    "shipping": [
      {
        "cost": 0,
        "currency": "GBP",
        "costText": "Free postage",
        "service": "Parcelforce 48",
        "estimate": "Estimated between Fri, 6 Nov and Mon, 9 Nov",
        "eachAdditional": null
      }
    ],
    "shippingNote": null,
    "shipsTo": "United Kingdom",
    "shippingExcludes": "Afghanistan, Iran, Libya, Nauru, Russian Federation, Somalia, Ukraine, Yemen",
    "dispatchTime": null,
    "returnsAccepted": false,
    "returnPeriodDays": null,
    "returns": [
      {
        "label": "Returns",
        "value": "No returns, but backed by the eBay Money Back Guarantee"
      }
    ],
    "categoryPath": [],
    "imageUrls": ["https://i.ebayimg.com/images/g/lYcAAeSwHQxq4hwT/s-l1600.webp", "https://i.ebayimg.com/images/g/lWIAAeSw3hlq4hve/s-l1600.webp", "https://i.ebayimg.com/images/g/loMAAeSwRRpq4hve/s-l1600.webp"],
    "specifics": [
      {
        "name": "Condition",
        "values": ["New: A brand-new, unused, unopened and undamaged item in original retail packaging (where packaging is applicable). If t…"]
      },
      {
        "name": "LEGO Theme",
        "values": ["Star Wars"]
      },
      {
        "name": "LEGO Set Number",
        "values": ["75192"]
      },
      {
        "name": "Number of Pieces",
        "values": ["7541"]
      },
      {
        "name": "Retired",
        "values": ["Yes"]
      },
      {
        "name": "Year Manufactured",
        "values": ["2018"]
      }
    ],
    "variations": [],
    "statusMessage": null,
    "sold": null,
    "description": null
  },
  {
    "itemId": "115805287483",
    "url": "https://www.ebay.co.uk/itm/115805287483",
    "marketplace": "uk",
    "title": "Mens High Visibility Hi Vis Viz Polo T Shirt Safety Security Work Top Two 2 Tone",
    "listedOn": "EBAY_GB",
    "status": "ACTIVE",
    "buyingFormat": "fixed_price",
    "price": 12.99,
    "currency": "GBP",
    "priceText": "£12.99",
    "buyItNowPrice": null,
    "bestOffer": false,
    "bids": null,
    "condition": "New with box",
    "availability": "More than 10 available",
    "quantitySold": 435,
    "startTime": "2023-05-15T13:52:02.000Z",
    "endTime": "2026-11-15T14:52:02.000Z",
    "seller": "trendingbabs",
    "sellerName": "4everclothing",
    "sellerFeedbackScore": 29589,
    "sellerPositivePercent": 99.7,
    "sellerType": "business",
    "sellerItemsSold": 103000,
    "sellerJoined": "Oct 2012",
    "storeUrl": "https://www.ebay.co.uk/str/firstchoicetraders",
    "location": "Rochdale, United Kingdom",
    "shipping": [
      {
        "cost": 0,
        "currency": "GBP",
        "costText": "Free delivery in 1-2 days",
        "service": "Other Courier 3 days",
        "estimate": "Estimated between Tue, 3 Nov and Wed, 4 Nov",
        "eachAdditional": null
      },
      {
        "cost": 9.99,
        "currency": "GBP",
        "costText": "£9.99 delivery in 1–2 days",
        "service": "Royal Mail 24",
        "estimate": "Estimated between Tue, 3 Nov and Wed, 4 Nov",
        "eachAdditional": 9.99
      }
    ],
    "shippingNote": null,
    "shipsTo": "APO/FPO, Alaska/Hawaii, Albania, Algeria, American Samoa, Andorra, Angola, Anguilla, Antigua and Barbuda, Argentina, Arm…",
    "shippingExcludes": "Afghanistan, British Virgin Islands, Channel Islands, Comoros, Cook Islands, Dominica, Falkland Islands (Islas Malvinas)…",
    "dispatchTime": "Will usually dispatch within 1 working day of receiving cleared payment.",
    "returnsAccepted": true,
    "returnPeriodDays": 30,
    "returns": [
      {
        "label": "Returns",
        "value": "Accepted within 30 days"
      },
      {
        "label": "Returns postage",
        "value": "Buyer pays return postage. If you use an eBay delivery label, it will be deducted from your refund amount"
      },
      {
        "label": "Return policy",
        "value": "Refer to eBay return policy for more details. You're covered by the eBay Money Back Guarantee if you receive an item tha…"
      }
    ],
    "categoryPath": ["Business, Office & Industrial", "Facility Maintenance & Safety", "Personal Protective Equipment (PPE)", "Other Personal Protective Equipment"],
    "imageUrls": ["https://i.ebayimg.com/images/g/qwMAAOSwUxNkwQ8G/s-l1600.webp", "https://i.ebayimg.com/images/g/LNUAAeSw~gJqlFLX/s-l1600.webp", "https://i.ebayimg.com/images/g/GkoAAeSwEjtqlFJX/s-l1600.webp"],
    "specifics": [
      {
        "name": "Condition",
        "values": ["New with box: A brand-new, unused, unworn and undamaged item in its original packaging (such as the original box or bag)…"]
      },
      {
        "name": "Brand",
        "values": ["Unbranded"]
      },
      {
        "name": "Type",
        "values": ["Safety/ Protective Clothing"]
      },
      {
        "name": "Safety & Protective Clothing",
        "values": ["T Shirt"]
      },
      {
        "name": "Main Colour",
        "values": ["Neon Yellow Orange"]
      },
      {
        "name": "Style",
        "values": ["Safety / Work"]
      }
    ],
    "variations": [
      {
        "variationId": "415879050844",
        "specifics": [
          {
            "name": "Size",
            "values": ["SMALL"]
          },
          {
            "name": "Colour",
            "values": ["Orange Black 103"]
          }
        ],
        "price": 12.99,
        "currency": "GBP",
        "outOfStock": false,
        "availability": "More than 10 available",
        "quantitySold": 435
      },
      {
        "variationId": "415879050845",
        "specifics": [
          {
            "name": "Size",
            "values": ["SMALL"]
          },
          {
            "name": "Colour",
            "values": ["Orange Black 104"]
          }
        ],
        "price": 12.99,
        "currency": "GBP",
        "outOfStock": false,
        "availability": "More than 10 available",
        "quantitySold": 435
      },
      {
        "variationId": "415879050846",
        "specifics": [
          {
            "name": "Size",
            "values": ["SMALL"]
          },
          {
            "name": "Colour",
            "values": ["Yellow Black 103"]
          }
        ],
        "price": 12.99,
        "currency": "GBP",
        "outOfStock": false,
        "availability": "More than 10 available",
        "quantitySold": 435
      }
    ],
    "statusMessage": null,
    "sold": null,
    "description": null
  }
]

Requests and billing

Requests: 1–2 Web Access requests per entry in items.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`seller`

Read eBay seller profiles and shops by username or URL on ebay.co.uk or ebay.com: shop name, feedback score and positive percentage, items sold, followers, location, member since, About text, the last 12 months' positive, neutral and negative ratings, detailed seller ratings and the seller's categories.

POST https://request.usestring.ai/v1/integrations/ebay-web/seller

Input

Unknown fields are rejected.

Field	Type	Description
`sellers`	string[] \| null	Required. eBay usernames, or /usr/ profile, /str/ shop or feedback profile URLs on ebay.co.uk or ebay.com. 1 to 20 entries.
`marketplace`	`uk` `us`	uk for ebay.co.uk (the default) or us for ebay.com: whose site the profile is read from.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`username`	string	—
`profileUrl`	string	—
`marketplace`	string	—
`displayName`	string \| null	The name the profile shows: the shop name for a seller with a shop.
`storeUrl`	string \| null	The seller's eBay shop, when they have one.
`feedbackScore`	integer \| null	The member's feedback score, when the profile or their listings show it.
`positivePercent`	number \| null	Positive feedback over the last 12 months, from 0 to 100.
`itemsSold`	integer \| null	Items sold, as eBay rounds it (103K reads as 103000)
`followers`	integer \| null	As eBay rounds it (208K reads as 208000)
`location`	string \| null	The member's country, such as United Kingdom.
`memberSince`	string \| null	As eBay shows it, such as 02 Jan, 2006.
`description`	string \| null	The profile's or shop's About text.
`logoUrl`	string \| null	—
`ratingsPositive`	integer \| null	Positive ratings in the last 12 months.
`ratingsNeutral`	integer \| null	Neutral ratings in the last 12 months.
`ratingsNegative`	integer \| null	Negative ratings in the last 12 months.
`detailedRatings`	object[] \| null	Detailed seller ratings, averages over the last 12 months; empty until a seller has enough of them.
`detailedRatings[].label`	string	Such as Accurate description or Delivery time.
`detailedRatings[].average`	number \| null	From 1 to 5.
`categories`	string[] \| null	The top-level categories the seller's live listings are in.

Example

curl https://request.usestring.ai/v1/integrations/ebay-web/seller \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sellers": ["joer6405", "https://www.ebay.co.uk/str/firstchoicetraders"]
  }'

data starts with these rows:

[
  {
    "username": "joer6405",
    "profileUrl": "https://www.ebay.co.uk/usr/joer6405",
    "marketplace": "uk",
    "displayName": "joer6405",
    "storeUrl": null,
    "feedbackScore": 733,
    "positivePercent": 100,
    "itemsSold": 450,
    "followers": 3,
    "location": "United Kingdom",
    "memberSince": "02 Jan, 2006",
    "description": null,
    "logoUrl": "https://i.ebayimg.com/images/g/1CwAAOSwHzZkSqkK/s-l140.webp",
    "ratingsPositive": 11,
    "ratingsNeutral": 0,
    "ratingsNegative": 0,
    "detailedRatings": [],
    "categories": ["Toys & Games"]
  },
  {
    "username": "trendingbabs",
    "profileUrl": "https://www.ebay.co.uk/usr/trendingbabs",
    "marketplace": "uk",
    "displayName": "4everclothing",
    "storeUrl": "https://www.ebay.co.uk/str/firstchoicetraders",
    "feedbackScore": 29589,
    "positivePercent": 99.7,
    "itemsSold": 103000,
    "followers": 709,
    "location": "United Kingdom",
    "memberSince": "13 Oct, 2012",
    "description": "http://imageshack.com/a/img835/9504/2lgo.jpg",
    "logoUrl": "https://i.ebayimg.com/images/g/1tIAAOSweM5kSqsu/s-l140.webp",
    "ratingsPositive": 1877,
    "ratingsNeutral": 5,
    "ratingsNegative": 5,
    "detailedRatings": [
      {
        "label": "Accurate description",
        "average": 4.9
      },
      {
        "label": "Reasonable postage cost",
        "average": 5
      },
      {
        "label": "Delivery time",
        "average": 5
      },
      {
        "label": "Communication",
        "average": 5
      }
    ],
    "categories": ["Business, Office & Industrial", "Clothes, Shoes & Accessories", "Sporting Goods"]
  }
]

Requests and billing

Requests: 1–3 Web Access requests per entry in items.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`listings`

List a seller's live eBay listings from their profile or shop on ebay.co.uk or ebay.com, up to 72 a page in the shop's own order: price, earlier price, condition, auction bids and end, stock, delivery and location. For keyword or price filters within one seller, use search with seller.

POST https://request.usestring.ai/v1/integrations/ebay-web/listings

Input

Unknown fields are rejected.

Field	Type	Description
`seller`	string	Required. An eBay username, or a /usr/ profile or /str/ shop URL on ebay.co.uk or ebay.com. At least 1 character.
`marketplace`	`uk` `us`	uk for ebay.co.uk (the default) or us for ebay.com: whose prices, delivery and links the rows carry.
`pages`	integer	How many pages of up to 72 listings to read, from 1 (the default) to 50. From 1 to 50.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`itemId`	string	—
`url`	string	The listing on the marketplace's own site.
`title`	string	—
`condition`	string \| null	Such as Brand new, Pre-owned or Open Box.
`price`	number \| null	The price eBay shows, or an auction's current bid, in currency.
`currency`	string \| null	—
`priceText`	string \| null	—
`originalPrice`	number \| null	The struck-through earlier price of a discounted listing.
`buyingFormat`	string	auction or fixed_price.
`bids`	integer \| null	An auction's bid count.
`endTime`	string \| null	When an auction ends, RFC 3339.
`quantity`	string \| null	The stock line, such as 55 remaining.
`shippingText`	string \| null	The delivery line, such as Free delivery in 2 days or Postage not specified.
`location`	string \| null	Such as Located in United States.
`freeReturns`	boolean	—
`seller`	string \| null	—
`sellerFeedbackScore`	integer \| null	—
`sellerPositivePercent`	number \| null	From 0 to 100.
`imageUrl`	string \| null	—
`marketplace`	string	—
`page`	integer	—
`position`	integer	The listing's position across the pages read, from 1.

Example

curl https://request.usestring.ai/v1/integrations/ebay-web/listings \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "seller": "vipoutlet",
    "marketplace": "us",
    "pages": 2
  }'

data starts with these rows:

[
  {
    "itemId": "127367427399",
    "url": "https://www.ebay.com/itm/127367427399",
    "title": "Apple iPhone 16 Pro Max 256GB Desert Titanium LTE Cellular 3N526LL/A",
    "condition": "Open Box",
    "price": 737,
    "currency": "USD",
    "priceText": "$737.00",
    "originalPrice": 899,
    "buyingFormat": "fixed_price",
    "bids": null,
    "endTime": null,
    "quantity": "10 remaining",
    "shippingText": "Free delivery in 2-4 days",
    "location": "Located in United States",
    "freeReturns": true,
    "seller": "vipoutlet",
    "sellerFeedbackScore": 1034439,
    "sellerPositivePercent": 97.2,
    "imageUrl": "https://i.ebayimg.com/images/g/iuQAAeSwR8Jqis6A/s-l300.webp",
    "marketplace": "us",
    "page": 1,
    "position": 1
  },
  {
    "itemId": "127424049013",
    "url": "https://www.ebay.com/itm/127424049013",
    "title": "WORKPRO 32 Metal Rolling Utility Cart - Durable Steel Frame Spacious Top Surface",
    "condition": "Brand New",
    "price": 39,
    "currency": "USD",
    "priceText": "$39.00",
    "originalPrice": 69.99,
    "buyingFormat": "fixed_price",
    "bids": null,
    "endTime": null,
    "quantity": "5 remaining",
    "shippingText": "Free delivery in 2-4 days",
    "location": "Located in United States",
    "freeReturns": true,
    "seller": "vipoutlet",
    "sellerFeedbackScore": 1034439,
    "sellerPositivePercent": 97.2,
    "imageUrl": "https://i.ebayimg.com/images/g/bIcAAeSw~7pqhZsa/s-l300.webp",
    "marketplace": "us",
    "page": 1,
    "position": 2
  }
]

Requests and billing

Requests: 1 Web Access request per result page.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`feedback`

Read a member's public eBay feedback, newest first, up to 200 entries a page: rating, masked member and their score, when, comment, verified purchase and, for recent orders, the item and price. Filter by role (received as seller or buyer, or left for others) and period.

POST https://request.usestring.ai/v1/integrations/ebay-web/feedback

Input

Unknown fields are rejected.

Field	Type	Description
`seller`	string	Required. An eBay username, or a /usr/ or feedback profile URL on ebay.co.uk or ebay.com. At least 1 character.
`marketplace`	`uk` `us`	uk for ebay.co.uk (the default) or us for ebay.com: whose site the feedback is read from.
`role`	`received_as_seller` `received_as_buyer` `all` `left_for_others`	received_as_seller (the default), received_as_buyer, all for everything received, or left_for_others.
`period`	`all` `1m` `6m` `12m`	all (the default), 1m, 6m or 12m.
`sort`	`recent` `relevant`	recent (the default) or relevant.
`pages`	integer	How many pages of up to 200 entries to read, from 1 (the default) to 50. From 1 to 50.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`feedbackId`	string	—
`seller`	string	The member whose profile this is.
`rating`	string	positive, neutral or negative.
`from`	string \| null	The other member, masked by eBay, such as 9***j.
`fromRole`	string \| null	buyer or seller: the other member's role in the order.
`fromFeedbackScore`	integer \| null	The other member's feedback score.
`period`	string \| null	When it was left, as eBay buckets it, such as Past month or More than a year ago.
`comment`	string \| null	—
`itemTitle`	string \| null	The item the order was for; eBay shows it for feedback up to about 90 days old.
`itemId`	string \| null	—
`itemPrice`	number \| null	—
`itemPriceText`	string \| null	As eBay shows it, such as US $50.00.
`verifiedPurchase`	boolean	—
`imageCount`	integer	Photos attached to the entry.
`marketplace`	string	—
`page`	integer	—
`position`	integer	The entry's position across the pages read, from 1.

Example

curl https://request.usestring.ai/v1/integrations/ebay-web/feedback \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "seller": "vipoutlet",
    "marketplace": "us"
  }'

data starts with these rows:

[
  {
    "feedbackId": "2848692533020",
    "seller": "vipoutlet",
    "rating": "positive",
    "from": "eBay automated feedback",
    "fromRole": "buyer",
    "fromFeedbackScore": null,
    "period": "Past month",
    "comment": "Order delivered on time with no issues",
    "itemTitle": "Universal Studios Five Nights at Freddy's 2-Movie Collection DVD, PG-13 Horror",
    "itemId": "117080341289",
    "itemPrice": 14,
    "itemPriceText": "US $14.00",
    "verifiedPurchase": false,
    "imageCount": 0,
    "marketplace": "us",
    "page": 1,
    "position": 1
  },
  {
    "feedbackId": "2848692069020",
    "seller": "vipoutlet",
    "rating": "negative",
    "from": "t***i",
    "fromRole": "buyer",
    "fromFeedbackScore": 1011,
    "period": "Past month",
    "comment": "Came broken in piece still haven’t received my refund",
    "itemTitle": "Presto 05489 Black Stainless Steel Deep Fryer",
    "itemId": "125781618084",
    "itemPrice": 46,
    "itemPriceText": "US $46.00",
    "verifiedPurchase": true,
    "imageCount": 0,
    "marketplace": "us",
    "page": 1,
    "position": 2
  }
]

Requests and billing

Requests: 1 Web Access request per result page.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

On this page