Platform availability
- 24h health
- Normal
Last 30 days
Available capabilities
Each eBay action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000 | 24-hour health |
|---|---|---|---|
Searchsearch | Find eBay listings for a keyword with asking price, currency, condition, shipping terms and seller, optionally filtered by condition, site domain or price range. | $1.39 per 1,000 requests | Normal |
Storestore | Pull the item listings from one eBay seller's store by their exact seller username, with price, condition, shipping and image for each item. | $1.39 per 1,000 requests | Normal |
Reviewsreviews | Read buyer feedback for one eBay listing, identified by the seller username plus item_id, with rating, seller reply, the reviewer's own feedback score and product details. | $1.39 per 1,000 requests | Normal |
Sold listingssold | Track completed eBay sales for a keyword over a lookback window in days, with sold price, shipping, total price, sale date, listing type and seller feedback. | $1.39 per 1,000 requests | Normal |
Open a capability for its parameters, response fields, code samples and trial.
What does each eBay action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Find eBay listings for a | keyword | condition, country, domain, max_price, min_price, sold_only | Sync delivery | Catalog values: defaultLimit=20, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | item_id · title · url · price · price_text · currency · condition · shipping · seller · image_url · scraped_at · platform |
storeStore Pull the item listings from one eBay seller's store by their exact | seller | country, domain, store, url, username | Sync delivery | Catalog values: defaultLimit=20, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | item_id · title · url · price · price_text · currency · condition · shipping · seller · image_url · scraped_at · platform |
reviewsReviews Read buyer feedback for one eBay listing, identified by the | seller, item_id | country, domain, product_id, q, seller_name, url, username | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | text · rating · rating_scale · username · submitted_at · seller_reply · image_count · reviewer_feedback_score · reviewer_feedback_star · product_name · product_id · product_price · platform · image_url · images |
soldSold listings Track completed eBay sales for a | keyword | days, min_price, site, sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · name · sold_price · shipping_price · total_price · currency · sold_at · condition · listing_type · best_offer_accepted · category · seller_username · seller_feedback_score · seller_positive_percent · image_url · platform |
What do the eBay search parameters mean?
Find eBay listings for a keyword with asking price, currency, condition, shipping terms and seller, optionally filtered by condition, site domain or price range. Setting sold_only keeps listings seen as sold; it does not measure total market volume.
keywordRequired- Search term for active listings in
searchactions, or ended/sold listings insoldactions. Asking prices in active listings should not be assumed to match final transaction amounts. conditionOptional- Filters search results by item condition. Preserve capitalization and spaces: New, Used, Refurbished, or For parts or not working. This is an item-condition filter, not a positive or negative review filter.
countryOptional- A compatibility input for domain that also takes an eBay site domain such as ebay.com, not a country code such as US or DE. When both are present, domain takes precedence.
domainOptional- Selects the eBay site domain, such as ebay.com, ebay.de, or ebay.co.uk, without a scheme or path. It defaults to ebay.com and is used to build pages for search, store, and reviews.
max_priceOptional- Sets a numeric upper bound for item prices in search. Use it with min_price to define a range, and do not assume that shipping or taxes are included.
min_priceOptional- Sets a numeric lower bound for item prices. Filters active listing prices in
searchactions and ended/sold listing prices insoldactions. Currency is determined by the target marketplace site and listing data, not API billing. sold_onlyOptional- Boolean toggle in
searchactions to return only completed sales when set totrue. Must be passed as a JSON boolean, not a string ("false").
What do the eBay store parameters mean?
Pull the item listings from one eBay seller's store by their exact seller username, with price, condition, shipping and image for each item. You get listings only, not the seller's balance, private reputation or internal inventory.
sellerRequired- The exact eBay seller account username, not a store display title or company name. Used in
storequeries to fetch seller item listings, and inreviewsqueries paired withitem_idto retrieve buyer feedback. countryOptional- A compatibility input for domain that also takes an eBay site domain such as ebay.com, not a country code such as US or DE. When both are present, domain takes precedence.
domainOptional- Selects the eBay site domain, such as ebay.com, ebay.de, or ebay.co.uk, without a scheme or path. It defaults to ebay.com and is used to build pages for search, store, and reviews.
storeOptional- Compatibility alias for
sellerrepresenting the seller account username, not an arbitrary shop title. Thestoreaction still requires the primarysellerparameter. urlOptional- Overrides automatic URL construction with a direct eBay store/seller listing page in
storeactions, or a/fdbk/feedback page inreviewsactions. Providing a URL does not waive the requirement forselleroritem_idparameters. usernameOptional- Compatibility alias for the
selleraccount username instoreandreviewsactions. Thesellerparameter takes precedence and remains required; this field does not represent buyer or reviewer handles.
What do the eBay reviews parameters mean?
Read buyer feedback for one eBay listing, identified by the seller username plus item_id, with rating, seller reply, the reviewer's own feedback score and product details. The full feedback history is not guaranteed.
sellerRequired- The exact eBay seller account username, not a store display title or company name. Used in
storequeries to fetch seller item listings, and inreviewsqueries paired withitem_idto retrieve buyer feedback.eBay: Transaction Feedback Profiles — eBay transaction feedback consists of positive, neutral, or negative ratings accompanied by brief comments; a member's feedback profile is a distinct concept from standard 5-star product reviews. · Checked item_idRequired- The numeric eBay item identifier associated with a seller listing (typically extracted from
/itm/URLs), used paired withsellerinreviewsqueries. Represents a specific listing, not a generalized catalog product ID or review entry ID. countryOptional- A compatibility input for domain that also takes an eBay site domain such as ebay.com, not a country code such as US or DE. When both are present, domain takes precedence.
domainOptional- Selects the eBay site domain, such as ebay.com, ebay.de, or ebay.co.uk, without a scheme or path. It defaults to ebay.com and is used to build pages for search, store, and reviews.
product_idOptional- Compatibility alias for
item_idaccepting the numeric eBay item identifier.reviewsactions must still meet the required contract containingitem_id. qOptional- Compatibility alias for
item_idaccepting the numeric eBay item identifier inreviewsactions. Does not serve as a free-text search query; usekeywordfor product searches. seller_nameOptional- The eBay seller account username.
urlOptional- Overrides automatic URL construction with a direct eBay store/seller listing page in
storeactions, or a/fdbk/feedback page inreviewsactions. Providing a URL does not waive the requirement forselleroritem_idparameters. usernameOptional- Compatibility alias for the
selleraccount username instoreandreviewsactions. Thesellerparameter takes precedence and remains required; this field does not represent buyer or reviewer handles.
What do the eBay sold parameters mean?
Track completed eBay sales for a keyword over a lookback window in days, with sold price, shipping, total price, sale date, listing type and seller feedback. These describe each closed listing; they do not estimate net revenue or future demand.
keywordRequired- Search term for active listings in
searchactions, or ended/sold listings insoldactions. Asking prices in active listings should not be assumed to match final transaction amounts. daysOptional- Integer representing the historical lookback window in days for
soldqueries (defaults to30). Indicates time range rather than listing duration or returned item counts; complete records are not guaranteed for arbitrary day spans. min_priceOptional- Sets a numeric lower bound for item prices. Filters active listing prices in
searchactions and ended/sold listing prices insoldactions. Currency is determined by the target marketplace site and listing data, not API billing. siteOptional- Specifies the eBay domain for
soldqueries (for example,ebay.comorebay.co.uk), defaulting toebay.com. Distinct from thedomainparameter used insearch,store, orreviewsactions; price currencies correspond to returned listing records. sortOptional- Sort order for
soldactions; allowed values arenewest(most recently ended first) anddistance(proximity). Does not sort by original listing creation date. Defaults to recently ended order if omitted.Allowed values:distancenewest
How to use the eBay API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result, or poll the returned job ID when the action runs asynchronously.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"ebay","action":"search","params":{"keyword":"<keyword>"}}'
eBay API questions
What can I retrieve with the eBay API?
Set platform to ebay. The current catalog lists search, store, reviews, and sold listings. These action names identify different eBay objects or views; they are not interchangeable search modes.
Which input starts a eBay `search` request?
Search term for active listings in search actions, or ended/sold listings in sold actions. Asking prices in active listings should not be assumed to match final transaction amounts. Send it as keyword inside params.
Which fields can eBay `search` return?
Its declared schema includes item_id, title, price, and price_text. A declared field can still be absent from an individual record, and every other action has its own field list.
Does every eBay action return immediately?
Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.