# 🛒✨ eBay Search Scraper (`scrapier/ebay-search-scraper`) Actor 🛒✨ eBay Search Scraper extracts live marketplace data from eBay search results — titles, prices, condition, seller, shipping, bids/Buy Now, ratings, images & URLs. ⚡ Ideal for product research, price tracking, dropshipping & competitor analysis. API-ready, fast, scalable. - **URL**: https://apify.com/scrapier/ebay-search-scraper.md - **Developed by:** [Scrapier](https://apify.com/scrapier) (community) - **Categories:** E-commerce, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### 🛒✨ eBay Search Scraper The 🛒✨ eBay Search Scraper is a fast, scalable eBay search results scraper that turns keyword searches into structured product data — titles, prices, sellers, shipping, returns, images, and more. It solves the challenge of gathering live marketplace insights at scale from eBay SERPs by automatically discovering item links and scraping each product page in depth. Built for marketers, developers, analysts, and researchers, this eBay listing scraper tool powers product research, price tracking, and competitor analysis with API-ready JSON you can export or integrate in workflows. At scale, it lets you scrape eBay search results across regions and filters to keep catalogs, pricing, and sold trends up to date. ### What data / output can you get? Below are examples of structured fields the eBay product data scraper returns for each item. Values are illustrative, and field names match the dataset output precisely. | Data type | Description | Example value | | --- | --- | --- | | listing_card.title | Normalized item title (from product page) | “Apple iPhone 14 Pro Max 256GB – Deep Purple” | | listing_card.price | Primary price with currency symbol when resolved | “$899.99” | | listing_card.condition | Short condition label | “Used” | | listing_card.shipping | Shipping summary built from delivery/SPR details | “Standard Shipping • US $12.00 • United States” | | listing_card.returns | Returns summary merged from JSON-LD and DOM | “30-day returns • Free returns accepted” | | listing_card.seller_username | Seller handle | “best_seller_store” | | listing_card.seller_reviews | Seller reviews/ratings count | 15432 | | listing_card.sponsored | Whether the result was a promoted/sponsored listing | false | | images[0].zoom.url | Zoom-sized image URL from JSON-LD | “https://i.ebayimg.com/images/g/abcd/s-l1600.jpg” | | payments_section_module.sections.paymentMethods.dataItems | Accepted payment methods | ["PayPal", "Visa", "Mastercard"] | | title.mainTitle | Canonical page title | “Apple iPhone 14 Pro Max 256GB - Excellent Condition” | | buy_box.binModel.price | Raw price value as parsed | “899.99” | | quantity.maxQuantity | Max available quantity parsed from DOM | “5” | | about_this_item_min_view.sections.itemSpecificsSection.dataItems.brand | Brand from JSON-LD or specifics | “Apple” | | item_desc_seller.sections.itemDescriptionSection.dataItems.preview | Short item description preview | “Open-box device in excellent condition with charger…” | | about_this_seller_section_module.sections[0].username | Seller username in the seller section | “best_seller_store” | | source_url | Canonical item URL | “https://www.ebay.com/itm/123456789012” | Bonus outputs include shipping_section_module and returns_section_module blocks, delivery messages, financing messages, quantity details, and complete item specifics. You can export data from the Apify dataset to JSON, CSV, or Excel for downstream analysis. ### Key features - ⚡ Fast, reliable eBay SERP scraping Extracts item links from search pages and visits each product to return structured details — ideal for eBay marketplace data extraction, price tracking, and catalog snapshots. - 🌍 Regional site support & localization Choose from 17 storefronts (e.g., ebay.com, ebay.co.uk, ebay.de) so prices, currency, and inventory reflect the market you care about. - 🎯 Flexible filters & sorting Configure ship-to location, sort order (Best Match, ending soonest, newly listed, price high/low, distance), “Show only” shortcuts (sold items, free shipping, returns accepted, authenticity guarantee, etc.), and buying format (Auction · Buy It Now · Accepts Offers). - 🧠 Sponsored detection in SERP Flags promoted results in listing_card.sponsored to support clean eBay SERP scraper analysis and paid vs organic comparisons. - 🧾 Rich product detail extraction Captures item specifics, shipping/returns data, payment methods, seller trust signals, images, and description previews. Optionally fetch the full seller description iframe for deeper text. - 🧪 Scalable runs with volume controls Control max_pages and maxItems for quick samples or larger sweeps. Results are pushed live as they’re collected — no need to wait until the end. - 🛡️ Smart proxy escalation (optional) Starts direct; on blocks, escalates to datacenter → residential, then engages “sticky residential” for stable throughput. Configure Apify Proxy in proxyConfiguration when useProxy is on. - 💻 Developer-friendly and API-ready Use it as an eBay product listing extractor in pipelines. Export datasets via API in JSON, CSV, or Excel for BI tools, apps, or price monitoring scrapers. ### How to use 🛒✨ eBay Search Scraper - step by step 1. Sign in to your Apify account and open the 🛒✨ eBay Search Scraper actor. 2. In Input, set query to the keywords you want to target (e.g., “coffee”, “vintage camera”). 3. Choose the domain (eBay site) to localize results (e.g., “ebay.com” or “ebay.co.uk”) and set the ship-to location for accurate delivery context. 4. Refine filters: pick sort, “Show only” shortcuts (e.g., sold_items, free_shipping), and buying_format (Auction, BIN, or BO). 5. Set max_pages and maxItems to control how deep to crawl and how many listings to save. 6. For richer text extraction, enable fetch_description_iframe to pull more seller description content when available. 7. To improve resilience at scale, enable useProxy and configure proxyConfiguration (e.g., useApifyProxy: true). 8. Run the actor. You’ll see live logs and new rows appear in the Output dataset as items are processed. 9. Export results from the Dataset in your preferred format (JSON, CSV, Excel), or connect via the Apify API for automated workflows. Pro Tip: Use proxyConfiguration with useApifyProxy: true for resilient eBay shopping results scraper runs and wire the dataset export to your data pipeline for continuous price monitoring and competitor tracking. ### Use cases | Use case name | Description | | --- | --- | | Market research & price comparison | Analyze pricing trends and competitiveness by running the eBay price comparison scraper across regions and categories. | | Price monitoring & repricing | Track listing prices over time with the eBay price monitoring scraper and feed data to repricing engines. | | Sold listings analysis | Filter “Show only” to sold_items to analyze realized prices and demand using an eBay sold listings scraper workflow. | | Catalog building for dropshipping | Build structured catalogs with images, specifics, and shipping to power product feeds for stores or marketplaces. | | Seller benchmarking | Compare seller ratings, feedback, and returns policies using the eBay seller data scraper fields. | | Category & keyword research | Use the eBay keyword search scraper + sort orders to discover top-performing SKUs in niches. | | Data enrichment via API | Integrate this eBay product listing extractor into analytics stacks via the Apify API for automated reporting. | ### Why choose 🛒✨ eBay Search Scraper? This solution focuses on precision, automation, and resilient marketplace data extraction at scale. - 🎯 Accurate, structured output: Clean JSON with normalized listing_card fields, specifics, images, payments, shipping, and returns. - 🌍 Regional targeting: Choose localized eBay storefronts to reflect real currency and inventory by market. - 📈 Built for scale: Tune max_pages and maxItems; rows stream live into your dataset during the run. - 💻 Developer access: Export as JSON/CSV/Excel or consume via API for pipelines and dashboards. - 🛡️ Reliable operations: Optional proxy escalation ensures higher success rates under load and anti-bot friction. - 💸 Cost-effective & automation-ready: Production-grade eBay marketplace data extraction without browser extensions or fragile scripts. Compared with unstable, browser-based tools, this Apify-powered eBay SERP scraper provides consistent structure, robust proxy handling, and predictable scaling for professional data workflows. ### Is it legal / ethical to use 🛒✨ eBay Search Scraper? Yes — when used responsibly. This actor extracts publicly available marketplace information from product pages and search results. It does not access private or authenticated content. Guidelines for responsible use: - Collect only public data and respect platform terms where applicable. - Comply with data protection laws (e.g., GDPR, CCPA) and your organization’s policies. - Use results for analysis, research, and operational insights — avoid abusive practices. - Consult your legal team for edge cases or jurisdiction-specific requirements. ### Input parameters & output format #### Example JSON input ```json { "query": "coffee grinder", "domain": "ebay.com", "location": "1", "sort": "12", "show_only": ["sold_items", "free_shipping"], "buying_format": "BIN", "max_pages": 2, "maxItems": 25, "useProxy": true, "fetch_description_iframe": false, "proxyConfiguration": { "useApifyProxy": true } } ```` Parameters - query (string, default: "coffee", required: no) — Search keywords for products, brands, or categories. - domain (string, default: "ebay.com", required: no) — eBay site to search (US, UK, DE, AU, etc.). - location (string, default: "1", required: no) — Ship-to location code for delivery context. - sort (string, default: "12", required: no) — Sort order (e.g., Best Match, Ending soonest, Newly listed, Price high/low). - show\_only (array\[string], default: \[], required: no) — Optional shortcuts like sold\_items, free\_shipping, returns\_accepted, authenticity\_guarantee, etc. - buying\_format (string, default: "BIN", required: no) — Auction · BIN · BO. - max\_pages (integer, default: 1, required: no) — How many search result pages to scan. - maxItems (integer, default: 20, required: no) — Hard cap on dataset rows per run (1–5000). - useProxy (boolean, default: true, required: no) — Toggle Apify Proxy usage. - fetch\_description\_iframe (boolean, default: false, required: no) — Pull richer long descriptions when available (slower). - proxyConfiguration (object, default: {"useApifyProxy": true}, required: no) — Configure Apify Proxy groups and sessions (used when useProxy is enabled). #### Example JSON output ```json { "listing_card": { "title": "Apple iPhone 14 Pro Max 256GB – Deep Purple", "sponsored": false, "link": "https://www.ebay.com/itm/123456789012", "condition": "Used", "thumbnail": "https://i.ebayimg.com/images/g/abcd/s-l1600.jpg", "price": "$899.99", "shipping": "Standard Shipping · US $12.00 · United States", "returns": "30-day returns · Free returns accepted", "seller_username": "best_seller_store", "seller_reviews": 15432, "seller_positive_feedback_in_percentage": 99.6 }, "images": [ { "thumbnails": [ { "url": "https://i.ebayimg.com/images/g/abcd/s-l64.jpg", "title": "1 of 3", "type": "thumbnail" } ], "original": { "url": "https://i.ebayimg.com/images/g/abcd/s-l400.jpg", "title": "1 of 3", "type": "original" }, "zoom": { "url": "https://i.ebayimg.com/images/g/abcd/s-l1600.jpg", "title": "1 of 3", "type": "zoom" }, "title": "1 of 3", "uploadedSize": { "height": 1600, "width": 1600 }, "mediaType": "IMAGE" } ], "shipping_section_module": { "title": "Shipping", "sections": { "shipping": { "dataItems": { "shippingRate": { "label": "Shipping Rate", "value": "12.00 USD" }, "shippingDestination": { "label": "Shipping Destination", "value": "United States" } } }, "title": { "title": "Delivery" } } }, "returns_section_module": { "title": "Returns", "sections": { "returns": { "dataItems": [ { "label": "Return Policy Category", "value": "ReturnsAccepted" }, { "label": "Applicable Countries", "value": "US" } ] } } }, "payments_section_module": { "title": "Payments", "sections": { "paymentMethods": { "dataItems": ["PayPal", "Visa", "Mastercard"] } } }, "condition_description": { "sections": [ { "dataItems": [ { "label": "Condition", "value": "Used" } ] } ], "title": "Used" }, "title": { "mainTitle": "Apple iPhone 14 Pro Max 256GB - Excellent Condition" }, "buy_box": { "binModel": { "price": "899.99", "isAddedToCart": false, "priceTransparencyAction": "Price details" }, "financingDetails": { "financingMessages": ["Pay in 4 with PayPal"] }, "repositionCoupon": false, "deliveryInfo": { "deliveryMessage": ["Estimated between Tue, May 14 and Thu, May 16"] }, "sellerInfo": { "profileLogo": { "title": "best_seller_store" }, "dataItems": ["best_seller_store", "99.6% positive feedback"] } }, "quantity": { "displayLabel": "Quantity", "maxQuantityReached": "", "maxQuantity": "5", "outOfStock": false }, "buy_box_cta": { "buttons": [ "Buy It Now", "Add to cart", "View in cart", "Add to Watchlist", "Added to Watchlist" ] }, "about_this_item_min_view": { "title": "About this item", "sections": { "itemSpecificsSection": { "dataItems": { "quantity": [ { "label": "available", "value": "5 available" } ], "itemNumber": "123456789012", "brand": "Apple", "condition": "Used" } } } }, "item_desc_seller": { "title": "Item description from the seller", "sections": { "itemDescriptionSection": { "dataItems": { "iframeUrl": "https://desc.ebay.com/xyz", "preview": "Open-box device in excellent condition with charger…", "plainText": "Open-box device in excellent condition with charger and cable." } } } }, "shipping_returns_payment_section_module": { "title": "Shipping, returns, and payments", "sections": { "spr": { "dataItems": { "shippingRate": { "label": "Shipping Rate", "value": "12.00 USD" }, "shippingDestination": { "label": "Shipping Destination", "value": "United States" } } } } }, "about_this_seller_section_module": { "sections": [ { "profileLogo": { "title": "best_seller_store" }, "username": "best_seller_store", "trustSignals": ["99.6% positive feedback"], "dataItems": ["best_seller_store", "99.6% positive feedback"] } ], "title": "About the seller" }, "source_url": "https://www.ebay.com/itm/123456789012" } ``` Note: Some nested fields may be empty or “Unknown” if not present in the public page markup (e.g., limited shipping details or returns data). The actor pushes each item as soon as it’s scraped, so you can monitor progress in real time. ### FAQ #### Do I need to log in to scrape eBay search results? No. The eBay SERP scraper works on publicly available pages without login. It visits search pages and product pages to collect public listing data. #### Can I target different eBay countries and currencies? Yes. Set the domain input to any of the supported storefronts (e.g., ebay.com, ebay.co.uk, ebay.de) and adjust the ship-to location to align delivery context with your buyers. #### How do I scrape sold listings only? Use the show\_only parameter and include "sold\_items". You can combine it with sorting and buying\_format to build focused datasets for demand and pricing analysis. #### What’s the best way to avoid blocks at scale? Enable useProxy and set proxyConfiguration.useApifyProxy to true. The actor starts direct and escalates routing (datacenter → residential) if needed, switching to sticky residential after a successful request for stability. #### How many listings can I scrape per run? Control volume via max\_pages and maxItems. The actor discovers links from search pages and saves up to maxItems rows to your dataset, streaming results live as they’re collected. #### What data does each item include? Each dataset row contains listing\_card (title, price, condition, seller, shipping/returns summaries, sponsored flag), images, shipping\_section\_module, returns\_section\_module, payments\_section\_module, title, quantity, item specifics, description preview or text (if enabled), seller section, and source\_url. #### Can I export to CSV or integrate via API? Yes. You can export datasets to JSON, CSV, or Excel from the Apify platform and access them via the Apify API to connect with BI tools, databases, or automation platforms. #### Does it detect sponsored listings? Yes. Items found as promoted in search are marked with listing\_card.sponsored, which is useful for eBay price comparison scraper workflows and separating paid from organic placements. ### Closing thoughts The 🛒✨ eBay Search Scraper is built for reliable, structured eBay marketplace data extraction at scale. Configure regional sites, filters, and limits to power product research, price monitoring, and competitor tracking with clean, API-ready JSON. Marketers, developers, analysts, and researchers can export to CSV/JSON/Excel or integrate via API for automated pipelines. Start extracting smarter eBay insights today with a fast, scalable, and production-ready eBay item details scraper. # Actor input Schema ## `query` (type: `string`): Type what you want to find — products, brands, categories. This drives your search together with Country & filters below. ☕ Example: coffee, vintage camera, running shoes. ## `domain` (type: `string`): Which eBay storefront to search — prices, currency, and inventory follow the site you pick. 🌐 ## `location` (type: `string`): Roughly where items should ship — helps align search results with buyer / delivery context. ✈️ ## `sort` (type: `string`): How listings are ranked — best match, ending soon, newest, price high/low, distance, and more. 📊 ## `show_only` (type: `array`): Optional shortcuts: sold ✔️, free shipping 🚚, returns ↩️, deals 🏷️, authenticity ✓, charity ❤️, and more — pick what matters to you. ## `buying_format` (type: `string`): Auction 🔔 · Buy It Now 🛍️ · Accepts offers 💬 — focus on how the listing is sold. ## `max_pages` (type: `integer`): How many search result pages to walk — more pages = more candidate listings (then capped by Max listings). 📚 ## `maxItems` (type: `integer`): Hard cap on rows in your dataset this run — great for samples (small) or big sweeps (up to limit). 📥 ## `useProxy` (type: `boolean`): When on, the Actor can route traffic through Apify Proxy (configure groups below). 🔐 ## `fetch_description_iframe` (type: `boolean`): Slower ⏱️ but richer: pulls more seller description text when eBay exposes it. Great for detail-heavy listings. ## `proxyConfiguration` (type: `object`): Fine-tune Apify Proxy (groups, sessions) for your workspace — used when 🛡️ Use Apify Proxy is enabled. ## Actor input object example ```json { "query": "coffee", "domain": "ebay.com", "location": "1", "sort": "12", "show_only": [], "buying_format": "BIN", "max_pages": 1, "maxItems": 20, "useProxy": true, "fetch_description_iframe": false, "proxyConfiguration": { "useApifyProxy": true } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "query": "coffee", "show_only": [], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapier/ebay-search-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "query": "coffee", "show_only": [], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("scrapier/ebay-search-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "query": "coffee", "show_only": [], "proxyConfiguration": { "useApifyProxy": true } }' | apify call scrapier/ebay-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapier/ebay-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "🛒✨ eBay Search Scraper", "description": "🛒✨ eBay Search Scraper extracts live marketplace data from eBay search results — titles, prices, condition, seller, shipping, bids/Buy Now, ratings, images & URLs. ⚡ Ideal for product research, price tracking, dropshipping & competitor analysis. API-ready, fast, scalable.", "version": "0.1", "x-build-id": "XXowLOschTpoFcsca" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~ebay-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-ebay-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapier~ebay-search-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-ebay-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapier~ebay-search-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-ebay-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "query": { "title": "🔎 Search query", "type": "string", "description": "Type what you want to find — products, brands, categories. This drives your search together with Country & filters below. ☕ Example: coffee, vintage camera, running shoes.", "default": "coffee" }, "domain": { "title": "🌍 Country (eBay site)", "enum": [ "ebay.com.au", "ebay.at", "ebay.ca", "ebay.fr", "ebay.de", "ebay.com.hk", "ebay.ie", "ebay.it", "ebay.com.my", "ebay.nl", "ebay.ph", "ebay.pl", "ebay.com.sg", "ebay.es", "ebay.ch", "ebay.co.uk", "ebay.com" ], "type": "string", "description": "Which eBay storefront to search — prices, currency, and inventory follow the site you pick. 🌐", "default": "ebay.com" }, "location": { "title": "📍 Ship-to location", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "33", "34", "35", "36", "37", "38", "39", "40", "41", "42", "43", "44", "45", "46", "47", "48", "49", "50", "51", "52", "53", "55", "56", "57", "58", "59", "60", "61", "62", "63", "64", "65", "66", "67", "68", "69", "70", "71", "72", "73", "74", "75", "76", "77", "78", "79", "80", "81", "82", "83", "84", "85", "86", "87", "88", "89", "90", "91", "92", "93", "94", "95", "96", "99", "100", "101", "102", "104", "105", "106", "107", "108", "109", "111", "112", "113", "114", "115", "116", "120", "121", "122", "123", "124", "125", "126", "127", "128", "129", "130", "131", "132", "133", "134", "135", "136", "137", "138", "139", "140", "141", "142", "143", "144", "145", "146", "147", "148", "149", "150", "151", "152", "153", "154", "155", "156", "157", "158", "159", "160", "161", "162", "163", "164", "165", "166", "167", "168", "169", "170", "171", "172", "173", "174", "175", "176", "177", "178", "179", "180", "181", "182", "183", "184", "185", "186", "187", "189", "191", "192", "193", "196", "197", "198", "199", "200", "201", "202", "203", "204", "205", "206", "207", "208", "209", "210", "211", "212", "213", "214", "215", "216", "217", "218", "219", "220", "221", "226", "227", "228", "229" ], "type": "string", "description": "Roughly where items should ship — helps align search results with buyer / delivery context. ✈️", "default": "1" }, "sort": { "title": "⬆️ Sort order", "enum": [ "12", "1", "10", "15", "16", "7", "3", "2" ], "type": "string", "description": "How listings are ranked — best match, ending soon, newest, price high/low, distance, and more. 📊", "default": "12" }, "show_only": { "title": "🏷️ Show only", "type": "array", "description": "Optional shortcuts: sold ✔️, free shipping 🚚, returns ↩️, deals 🏷️, authenticity ✓, charity ❤️, and more — pick what matters to you.", "items": { "type": "string", "enum": [ "completed_items", "sold_items", "free_returns", "returns_accepted", "authorized_seller", "deals_and_savings", "sale_items", "listed_as_lots", "benefits_charity", "authenticity_guarantee", "free_shipping", "local_pickup" ], "enumTitles": [ "✅ Completed items", "🏷️ Sold items", "↩️ Free returns", "📋 Returns accepted", "⭐ Authorized seller", "🏷️ Deals & savings", "💸 Sale items", "📦 Listed as lots", "❤️ Benefits charity", "✓ Authenticity Guarantee", "🚚 Free shipping", "📍 Local pickup" ] } }, "buying_format": { "title": "🛒 Buying format", "enum": [ "Auction", "BIN", "BO" ], "type": "string", "description": "Auction 🔔 · Buy It Now 🛍️ · Accepts offers 💬 — focus on how the listing is sold.", "default": "BIN" }, "max_pages": { "title": "📄 Max pages to scrape", "minimum": 1, "type": "integer", "description": "How many search result pages to walk — more pages = more candidate listings (then capped by Max listings). 📚", "default": 1 }, "maxItems": { "title": "🎯 Max listings to scrape", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on rows in your dataset this run — great for samples (small) or big sweeps (up to limit). 📥", "default": 20 }, "useProxy": { "title": "🛡️ Use Apify Proxy", "type": "boolean", "description": "When on, the Actor can route traffic through Apify Proxy (configure groups below). 🔐", "default": true }, "fetch_description_iframe": { "title": "📜 Fetch full item description", "type": "boolean", "description": "Slower ⏱️ but richer: pulls more seller description text when eBay exposes it. Great for detail-heavy listings.", "default": false }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Fine-tune Apify Proxy (groups, sessions) for your workspace — used when 🛡️ Use Apify Proxy is enabled." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```