What it returns
Search live eBay listings by keyword or category and get clean, structured item data you can export to CSV, Excel or JSON or pull through the API. Built on eBay's official Browse API, so results are fast and reliable, with no blocking.
Item ID, legacy item ID, title and listing URL. Price and currency, current bid and bid count for auctions. Buying format (Buy It Now, auction, Best Offer), condition. Shipping cost and type. Seller username, feedback score and percentage, top-rated flag. Category, item location (country, postcode), EPID. Main and additional images, listing date and end date.
Common uses
Price research and competitor tracking. Find underpriced items to resell. Monitor a seller's catalogue. Feed listing data into pricing tools and dashboards.
Request
POST https://api.pushbuild.com/ebay-listings/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
queries | list of strings | Keywords to search, e.g. iphone 15 128gb. Each query runs separately. Leave empty to list a category instead. |
categoryIds | list of strings | Optional eBay category IDs, e.g. 9355 (Cell Phones & Smartphones). Required if you give no queries. |
marketplace | string: EBAY_US, EBAY_GB, EBAY_DE, EBAY_FR, EBAY_IT, EBAY_ES, EBAY_CA, EBAY_AU, EBAY_AT, EBAY_BE, EBAY_CH, EBAY_IE, EBAY_NL, EBAY_PL, EBAY_HK, EBAY_SG, EBAY_MOTORS_US | Which eBay site to search. Default: "EBAY_US". |
sort | string: bestMatch, price, -price, newlyListed, endingSoonest | Best match (default), lowest price, highest price, newly listed or ending soonest. Default: "bestMatch". |
minPrice | integer | Lowest item price, in the currency below. |
maxPrice | integer | Highest item price, in the currency below. |
currency | string | Currency for the price filter, e.g. USD, GBP, EUR. Default: "USD". |
condition | list of strings | Only these conditions. |
buyingOptions | list of strings | Auction, Buy It Now (FIXED_PRICE) or Best Offer. |
itemLocationCountry | string | Only items located in this country (2-letter code, e.g. US). |
sellers | list of strings | Only listings from these seller usernames. |
freeShippingOnly | boolean | Only items with free delivery. Default: false. |
returnsAcceptedOnly | boolean | Only items that accept returns. Default: false. |
maxResults | integer | Up to 10,000 listings per query. Default: 200. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/ebay-listings/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"queries": ["iphone 15"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.40 per 1,000 listings. No charge for errors or empty searches.
Related APIs
App Store Reviews & App Details Scraper API
Get Apple App Store reviews (rating, title, text, version, votes) and full app details (rating, rating count, price, version history, genre, screenshots) for any app, in any country.
Google Play Reviews & App Details Scraper API
Scrape Google Play Store reviews (rating, text, date, thumbs-up, app version, developer reply) and app details (rating, rating count, installs, price, category) for any app and country.
Shopify Store Products Scraper API
Get the full product catalogue of any Shopify store: titles, prices, compare-at prices, variants, SKUs, stock availability, images, tags, vendor and description.
Steam Store API
Search Steam games or look them up by app ID: price and discount, developer, publisher, genres, release date, review score and counts, Metacritic score and live player count.
WooCommerce Store Products Scraper API
Extract the full product catalog of any WooCommerce store: name, SKU, price, regular and sale price, currency, stock, rating, categories, tags, attributes, variations, descriptions and images.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com