EveryData platform API

eBay API

Q: 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.

Q: 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`.

Q: 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 source record, and every other action has its own field list.

eBay separates listing discovery, seller stores, feedback, and sold listings across four actions: `search`, `store`, `reviews`, and `sold`.

Start with `search` for matching eBay results and move to `store` for one seller store; `search` uses `keyword`, whereas `store` uses `seller`, so the two result shapes stay distinct.

Start for free View the public catalog

Endpoint: POST /api/v1/social
Capabilities: 4
Per 1,000: $1.389

Available capabilities

Compare the eBay actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.

Action	Required	Optional	Delivery	Limit	Per 1,000	Response fields
`search` Search Use eBay `search` to discover eBay public results. Call eBay `search` with `keyword`, `min_price`, and `sold_only`; eBay `search` exposes `title`, `price`, `currency`, `seller`, `condition`, `url`, `shipping`, `price_text`, `scraped_at`, `platform`, `image_url`, and `item_id`.	keyword	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
`store` Store Choose `store` when the eBay target is one seller store. EBay `store` treats eBay optional inputs as filters. For eBay `store`, supply `url`, `seller`, `username`, `store`, and `min_price`; results include `item_id`, `price_text`, `url`, `scraped_at`, `condition`, `title`, `image_url`, `shipping`, `seller`, `currency`, `price`, and `platform`.	seller	min_price, 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
`reviews` Reviews The object handled by eBay `reviews` is review records. EBay `reviews` requires its documented eBay selector. eBay `reviews` reads `username`, `seller`, `q`, `url`, `product_id`, `seller_name`, and `item_id`, with `rating`, `username`, `image_count`, `reviewer_feedback_score`, `seller_reply`, `reviewer_feedback_star`, `rating_scale`, `product_name`, `product_price`, `platform`, `text`, `submitted_at`, and `product_id` available in its response.	seller, item_id	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
`sold` Sold listings The `sold` selection separates sold-listing records from other eBay objects. Use eBay `sold` with `keyword` for eBay sold-listing records. Call eBay `sold` with `min_price`, `site`, `keyword`, `sort`, and `days`; eBay `sold` exposes `name`, `sold_price`, `platform`, `shipping_price`, `sold_at`, `best_offer_accepted`, `id`, `category`, `seller_positive_percent`, `seller_feedback_score`, `image_url`, `url`, `currency`, `total_price`, `condition`, `listing_type`, and `seller_username`.	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 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.

What do the eBay `search` parameters mean?

Use eBay search to discover eBay public results. Call eBay search with keyword, min_price, and sold_only; eBay search exposes title, price, currency, seller, condition, url, shipping, price_text, scraped_at, platform, image_url, and item_id.

keywordRequired: 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.
min_priceOptional: Sets a numeric lower bound for item prices. Filters active listing prices in search actions and ended/sold listing prices in sold actions. Currency is determined by the target marketplace site and listing data, not API billing.
sold_onlyOptional: Boolean toggle in search actions to return only completed sales when set to true. Must be passed as a JSON boolean, not a string ("false"). Does not imply independent verification of final settlement amounts.

What do the eBay `store` parameters mean?

Choose store when the eBay target is one seller store. EBay store treats eBay optional inputs as filters. For eBay store, supply url, seller, username, store, and min_price; results include item_id, price_text, url, scraped_at, condition, title, image_url, shipping, seller, currency, price, and platform.

sellerRequired: The exact eBay seller account username, not a store display title or company name. Used in store queries to fetch seller item listings, and in reviews queries paired with item_id to retrieve buyer feedback.
min_priceOptional: Sets a numeric lower bound for item prices. Filters active listing prices in search actions and ended/sold listing prices in sold actions. Currency is determined by the target marketplace site and listing data, not API billing.
storeOptional: Compatibility alias for seller representing the seller account username, not an arbitrary shop title. The store action still requires the primary seller parameter.
urlOptional: Overrides automatic URL construction with a direct eBay store/seller listing page in store actions, or a /fdbk/ feedback page in reviews actions. Providing a URL does not waive the requirement for seller or item_id parameters.
usernameOptional: Compatibility alias for the seller account username in store and reviews actions. The seller parameter takes precedence and remains required; this field does not represent buyer or reviewer handles.

What do the eBay `reviews` parameters mean?

The object handled by eBay reviews is review records. EBay reviews requires its documented eBay selector. eBay reviews reads username, seller, q, url, product_id, seller_name, and item_id, with rating, username, image_count, reviewer_feedback_score, seller_reply, reviewer_feedback_star, rating_scale, product_name, product_price, platform, text, submitted_at, and product_id available in its response.

sellerRequired: The exact eBay seller account username, not a store display title or company name. Used in store queries to fetch seller item listings, and in reviews queries paired with item_id to retrieve buyer feedback.
eBay: Transaction Feedback ProfileseBay 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 2026-09-04
item_idRequired: The numeric eBay item identifier associated with a seller listing (typically extracted from /itm/ URLs), used paired with seller in reviews queries. Represents a specific listing, not a generalized catalog product ID or review entry ID.
product_idOptional: Compatibility alias for item_id accepting the numeric eBay item identifier. reviews actions must still meet the required contract containing item_id.
qOptional: Compatibility alias for item_id accepting the numeric eBay item identifier in reviews actions. Does not serve as a free-text search query; use keyword for product searches.
seller_nameOptional: The eBay seller account username.
urlOptional: Overrides automatic URL construction with a direct eBay store/seller listing page in store actions, or a /fdbk/ feedback page in reviews actions. Providing a URL does not waive the requirement for seller or item_id parameters.
usernameOptional: Compatibility alias for the seller account username in store and reviews actions. The seller parameter takes precedence and remains required; this field does not represent buyer or reviewer handles.

What do the eBay `sold` parameters mean?

The sold selection separates sold-listing records from other eBay objects. Use eBay sold with keyword for eBay sold-listing records. Call eBay sold with min_price, site, keyword, sort, and days; eBay sold exposes name, sold_price, platform, shipping_price, sold_at, best_offer_accepted, id, category, seller_positive_percent, seller_feedback_score, image_url, url, currency, total_price, condition, listing_type, and seller_username.

keywordRequired: 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.
daysOptional: Integer representing the historical lookback window in days for sold queries (defaults to 30). 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 search actions and ended/sold listing prices in sold actions. Currency is determined by the target marketplace site and listing data, not API billing.
siteOptional: Specifies the eBay domain for sold queries (for example, ebay.com or ebay.co.uk), defaulting to ebay.com. Distinct from the domain parameter used in search, store, or reviews actions; price currencies correspond to returned listing records.
sortOptional: Sort order for sold actions; allowed values are newest (most recently ended first) and distance (proximity). Does not sort by original listing creation date. Defaults to recently ended order if omitted; reference location for distance sorting is not explicitly defined.
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 selected action is asynchronous.
04Store the structured response fields needed by your application.

ebay_search.sh

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 source record, and every other action has its own field list.

Does every eBay action return immediately?

No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.

1688 API AliExpress API Amazon API Craigslist API Etsy API Shopee API Taobao API Temu API View the public catalog →