# πŸ”πŸ›’ eBay Scraper (Rental) (`3x1t/ebay-scraper`) Actor Unlock access to millions of product listings on eBay thanks to this unofficial API. Get fast, exhaustive results for valuable e-commerce insights. Fast, cheap & reliable. Rental version. - **URL**: https://apify.com/3x1t/ebay-scraper.md - **Developed by:** [3x1t](https://apify.com/3x1t) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 67 total users, 6 monthly users, 100.0% runs succeeded, 6 bookmarks - **User rating**: 3.01 out of 5 stars ## Pricing $6.99/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## 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 ## πŸ” What does eBay Scraper do? This is a tool for extracting eBay listings. You can then export the data in various forms, including JSON, CSV, table and others that are supported by the Apify platform. This version is configured as rental, meaning you will pay fixed price per month. If you prefer pay-per-result, visit [πŸ”πŸ›’ eBay Scraper (PPR)](https://apify.com/3x1t/ebay-scraper-ppr). ## πŸ“‹ Why scrape eBay? Scraping eBay can be an incredibly valuable tool for anyone looking to gain insights into the online marketplace. By extracting essential product details such as prices, item specifics, and images, you can quickly analyze trends and gauge the popularity of certain items. This data is especially useful for businesses looking to optimize their own listings, adjust prices based on market trends, or even discover gaps in the market where they can introduce new products. With access to real-time data, `πŸ”πŸ›’ eBay Scraper` allows businesses to stay agile and responsive to changes in consumer demand and competitive activity. ## πŸš€ Features 1. 🎯 Search for listings using: - *Search URLs* 2. πŸ”₯ Fast (up to ~5 results per second) 3. πŸ’² Affordable 1. Costs only **$6.99** per month 2. Very low usage cost (~**$0.25** per 1000 results) 4. 🌐 Supports different domains (e.g. *.com*, *.co.uk*, etc.) 5. πŸ—ΊοΈ (Limited) Custom client country emulation (e.g. United States, Great Britain, etc.) - Or set your own proxy 6. πŸ“€ Export data in CSV, JSON, or Excel formats ## πŸ“Š What is being extracted?
πŸ“° Title πŸ’° Price (+Currency) πŸ”— URL
πŸ”’ ID (Item number) πŸ–ΌοΈ Images πŸ”– Item-specific attributes
βœ… Is On Sale ❓ Is Promoted (Sponsored) πŸ‘¨β€βš•οΈ Condition
🏷️ Categories (+Breadcrumbs) πŸ“Š Available amount πŸ“Š Sold amount
❓ Why to buy 🚒 Shipping info (price, delivery countries, etc.) πŸ”’ Rank (Item index)
NEW πŸͺ Seller information NEW ⭐ Product ratings NEW πŸ“„ Item description
And more! For more detailed output, please refer to the output example section of this readme. ## ❓ How to use Configure every detail of your query on eBay search page and then simply insert the search URL to this actor's input. Simple as that. ### Example input URLs Here are some examples of the format: ```` https://www.ebay.com/sch/i.html?\_nkw=arduino&\_sacat=0&\_from=R40&\_ipg=60&\_pgn=1 ``` ``` https://www.ebay.com/sch/i.html?\_nkw=dictionary&\_sacat=0&\_from=R40&\_sop=16 ```` ## πŸ“‘ Example input JSON This example contains 2 start URLs, and there is a result limit equal to 20 for every start URL: ### Without proxy ```json { "resultLimitPerUrl": 20, "startUrls": [ "https://www.ebay.com/sch/i.html?_nkw=arduino&_sacat=0&_from=R40&_ipg=60&_pgn=1" ], "simulateCountryCode": "US" } ```` ### With proxy ```json { "resultLimitPerUrl": 100, "startUrls": [ "https://www.ebay.com/sch/i.html?_nkw=arduino&_sacat=0&_from=R40&_ipg=60&_pgn=1" ], "simulateCountryCode": "US", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` ### Input field info - `resultLimitPerUrl` - Sets the maximum amount of results to be returned for each start URL. - `startUrls` - Array of start URLs. They should be search URLs. - `simulateCountryCode` - Actor will emulate being from a given country. **It is Disabled when Proxy is set.** - `proxyConfiguration` - The proxy configuration object. Use the Apify UI for setting it. ## πŸ–ΌοΈ Example output These samples are in JSON format. Apify enables you by default to choose other formats, such as `JSON`, `CSV`, `XML`, `Excel`, `HTML Table`, `RSS` or `JSONL`. ```json { "itemNumber": 317487039919, "title": "ELEGOO UNO R3 Project Super Starter Kit", "url": "https://www.ebay.com/itm/317487039919", "price": { "current": { "value": 26.99, "currency": "USD" }, "isOnSale": false }, "previewImageUrl": "https://i.ebayimg.com/images/g/SfwAAeSwJJZpBNpv/s-l1600.webp", "imageUrls": [ "https://i.ebayimg.com/images/g/SfwAAeSwJJZpBNpv/s-l1600.webp", "https://i.ebayimg.com/images/g/4R0AAeSwv3FpBNpx/s-l1600.webp", "https://i.ebayimg.com/images/g/-LwAAeSwo-ZpBNpy/s-l1600.webp" ], "itemSpecificAttributes": { "Condition": "New – Open box", "Seller Notes": "β€œThis is a new kit but the 9V battery was removed because it was out of date.”", "Country of Origin": "China", "Brand": "ELEGOO", "Series": "UNO R3", "Type": "General Embedded Development Board", "Kit Name": "Super Starter Kit", "MPN": "Does not apply", "Features": "Flash Memory, USB", "Program Memory Type": "EEPROM", "Supported Device": "Arduino UNO R3", "UPC": "Does not apply" }, "categories": [ "Development Kits & Boards" ], "categoryPaths": [ [ "Business & Industrial", "Electrical Equipment & Supplies", "Electronic Components & Semiconductors", "Semiconductors & Actives", "Development Kits & Boards" ] ], "availableAmount": 10, "availableAmountText": "More than 10 available", "soldAmount": 44, "soldAmountText": "44 sold", "condition": "New – Open box", "whyToBuy": [ { "title": "This one's trending.", "details": "44 have already sold." }, { "title": "People want this.", "details": "51 people are watching this." } ], "shippingPrice": { "value": 0, "currency": "USD" }, "shipsTo": { "countries": "Worldwide", "excludedCountries": [ "Barbados", "French Guiana", "French Polynesia", "Guadeloupe", "Libya", "Martinique", "New Caledonia", "Reunion", "Russian Federation", "Ukraine", "Venezuela" ] }, "itemLocation": "Bonham, Texas, United States", "isPromoted": false, "rank": 2, "descriptionHTML": "--description from the seller in raw HTML form--", "descriptionText": "--description from the seller in clean text form--", "sellerInfo": { "name": "Keystone Enterprises", "bio": "We are a family business located in Bonham Texas. We resell computer and electronic equipment, cellphones and accessories, military surplus including tools and medical supplies, as well as a general assortment of items. Browse our store because chances are we have what you are looking for!", "url": "https://www.ebay.com/str/kesales?_trksid=p4429486.m145687.l149267", "logoUrl": "https://i.ebayimg.com/images/g/aHMAAOSwpsJfsrEO/s-l140.jpg", "registrationDate": { "year": 2000, "month": 1 }, "totalRatingPercent": 99.1, "totalDetailedRatingStars": { "Accurate description": 4.9, "Reasonable shipping cost": 5, "Shipping speed": 5, "Communication": 5 }, "buyerFeedback": { "forThisItem": { "count": 22, "shownFeedbackItems": [ { "id": "2480941042011", "ratingType": "POSITIVE", "buyerNameCensored": "1***d", "buyerFeedbackScore": 2016, "relativeReviewDate": "Past month", "comment": "Nice item as described, carefully packaged, fast shipping. A++ seller. Thanks!", "isVerifiedPurchase": true }, { "id": "2473362180011", "ratingType": "POSITIVE", "buyerNameCensored": "s***5", "buyerFeedbackScore": 2, "relativeReviewDate": "Past month", "comment": "Item was as described. Very satisfied with product. Shipped very fast, too.", "isVerifiedPurchase": true }, { "id": "2468355140011", "ratingType": "POSITIVE", "buyerNameCensored": "t***2", "buyerFeedbackScore": 764, "relativeReviewDate": "Past month", "comment": "Nice kit", "isVerifiedPurchase": true }, { "id": "2457092284011", "ratingType": "POSITIVE", "buyerNameCensored": "t***6", "buyerFeedbackScore": 1479, "relativeReviewDate": "Past month", "comment": "Works fine", "isVerifiedPurchase": true }, { "id": "2477732223011", "ratingType": "POSITIVE", "buyerNameCensored": "c***c", "buyerFeedbackScore": 789, "relativeReviewDate": "Past month", "comment": "A+ thanks!!", "isVerifiedPurchase": true }, { "id": "2448095727011", "ratingType": "POSITIVE", "buyerNameCensored": "a***l", "buyerFeedbackScore": 1074, "relativeReviewDate": "Past month", "comment": "Thanks", "isVerifiedPurchase": true }, { "id": "2480938976011", "ratingType": "POSITIVE", "buyerNameCensored": "eBay automated feedback", "buyerFeedbackScore": null, "relativeReviewDate": "Past month", "comment": "Order delivered on time with no issues", "isVerifiedPurchase": false }, { "id": "2480651906011", "ratingType": "POSITIVE", "buyerNameCensored": "eBay automated feedback", "buyerFeedbackScore": null, "relativeReviewDate": "Past month", "comment": "Order delivered on time with no issues", "isVerifiedPurchase": false } ] }, "forAllItems": { "count": 46328, "shownFeedbackItems": [ { "id": "2357451039011", "ratedItem": "Military Spare Barrel Carrying Case OD Green (#143181349430)", "ratingType": "POSITIVE", "buyerNameCensored": "c***c", "buyerFeedbackScore": 855, "relativeReviewDate": "Past 6 months", "comment": "fast shipping! packed well, best price, exactly as described.\ni can't say enough about how great this seller is. super deal. bags like this were $50 20yrs ago without nice padded slings. the slings cost $15 or more by themselves. my 2nd one from this seller. this one nicer than 1st and the 1st looked new :)", "isVerifiedPurchase": true }, { "id": "2470642701011", "ratedItem": "Lot of 5 Arduino Mega Prototype Shield w/ Bread Board (#146372963606)", "ratingType": "POSITIVE", "buyerNameCensored": "h***t", "buyerFeedbackScore": 3458, "relativeReviewDate": "Past month", "comment": "I am very happy to support this seller from my past experience buying from them. Items were just as shown. Shipped fast and well enough packed. Thanks. A+", "isVerifiedPurchase": true }, { "id": "2369805946011", "ratedItem": "ELEGOO UNO R3 Project Super Starter Kit (#316678279138)", "ratingType": "POSITIVE", "buyerNameCensored": "r***r", "buyerFeedbackScore": 49, "relativeReviewDate": "Past 6 months", "comment": "Ordered an Elegoo Uno R3 Starter Kit (Arduino). The kit shipped quick, was well packed, was exactly as advertised (unused), and at an excellent price. I’d happily buy from Keystone Enterprises again.", "isVerifiedPurchase": true }, { "id": "2370092868011", "ratedItem": "Nice Vintage Apple IIe Computer System Complete (#317110539604)", "ratingType": "POSITIVE", "buyerNameCensored": "s***p", "buyerFeedbackScore": 684, "relativeReviewDate": "Past 6 months", "comment": "Very kind people. The item was listed as PICKUP only and they were so helpful to bring the computer to a local UPS store which did the packing and shipping for me", "isVerifiedPurchase": true }, { "id": "2450619163011", "ratedItem": "Lot of 3 Creative Labs & Formosa Industrial PCI Sound Cards (#317042803659)", "ratingType": "POSITIVE", "buyerNameCensored": "a***p", "buyerFeedbackScore": 452, "relativeReviewDate": "Past month", "comment": "Items as described, good packaging and fast shipping, honest seller.", "isVerifiedPurchase": true }, { "id": "2477990894011", "ratedItem": "Dell Optiplex 7050 SFF i5-7500 16GB 2TB HDD WIN 11 PRO (#316695675067)", "ratingType": "POSITIVE", "buyerNameCensored": "j***o", "buyerFeedbackScore": 2064, "relativeReviewDate": "Past month", "comment": "Item received as described. Shipping was fast, packaging was secure, and at a good price.", "isVerifiedPurchase": true }, { "id": "2469403462011", "ratedItem": "Dell Optiplex 3050 Mini D10U i5-7500T 8GB 128GB SSD WIN 11 PRO (#316559744455)", "ratingType": "NEGATIVE", "buyerNameCensored": "s***l", "buyerFeedbackScore": 394, "relativeReviewDate": "Past month", "comment": "When I plugged it in I got \"No Bootable Device\". I messaged them Saturday. Monday no reply, Tuesday no reply, finally Wednesday they said they made a mistake and sent me one without Windows installed even though the ad specifically stated that Windows 11 Pro was. They told me to download it and install it myself.\n\nIf I wanted one without Windows I would of bought one and it would of been cheaper.\n\nOh well, lesson learned, i'll just avoid this vendor in the future", "isVerifiedPurchase": true }, { "id": "2480941042011", "ratedItem": "ELEGOO UNO R3 Project Super Starter Kit (#317487039919)", "ratingType": "POSITIVE", "buyerNameCensored": "1***d", "buyerFeedbackScore": 2016, "relativeReviewDate": "Past month", "comment": "Nice item as described, carefully packaged, fast shipping. A++ seller. Thanks!", "isVerifiedPurchase": true } ] } } } } ``` ### Extra output field info
Field path Possible values Note
itemSpecificAttributes Dictionary This is a key-value object containing the item attributes (e.g. brand, type, etc.).
Want to see some more fields explained? Contact me through issues or email at . ## πŸ”— Integrating with other platforms **eBay Scraper** supports integrations with external services, enabling automated workflows and data exchange. Through the [Apify platform integrations](https://apify.com/integrations), it connects with tools like Make and Zapier, facilitating interactions with Slack, Airbyte, GitHub, Google Sheets, and Google Drive ([learn about integrations](https://docs.apify.com/platform/integrations)). Additionally, its API and [webhook support](https://docs.apify.com/platform/integrations/webhooks) allow real-time interactions, such as triggering automated workflows or receiving notifications when a scraping task is completed. ## ❌ Limitations Currently, the actor is only able to scrape the first **40000 results** per search URL. To bypass this limitation, one needs to split the search into multiple sub-searches (you can do that by using more **specific** search terms, like price ranges etc.). ## πŸ› οΈ Support This actor is still under development, if there is a feature that you would love to see (more fields, better input, etc.), do not hesitate to **create an issue** or contact me at . ## βš–οΈ Is it legal to scrape eBay? Note that personal data is protected by GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. We also recommend that you read our blog post: [is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/) ## πŸ”πŸŒ Explore all actors by *3x1t* ### πŸ—ΊοΈ Maps & Location Data
Actor Description
πŸ“πŸ“Έ Google Street View Scraper Extracts product data from Google Street View, including panoramas, historical data, points of interest (e.g. places in vicinity) and more.
### πŸš— Automotive
Actor Description
πŸ”πŸšš Leboncoin Vehicle Scraper (PPE) Scrapes vehicle listings from Leboncoin.fr and returns well-structured data (very similar to our other vehicle actors). Pay-per-event version.
πŸ”πŸš— Mobile.de Scraper Scrapes vehicle listings from Mobile.de, Europe's largest car marketplace, with detailed vehicle data like brand, model, price, and images.
πŸ”πŸš— Mobile.de Scraper (PPR) Pay-per-result version of the Mobile.de Scraper, offering a cost-effective option for smaller use cases to extract car data.
πŸš—πŸ“πŸ‘¨β€βš•οΈ Mobile.de Listing Health Checker Checks listing IDs and returns only those that are not valid anymore.
πŸ”πŸš™ AutoScout24 Scraper (Rental) Scrapes vehicle listings from AutoScout24, with detailed vehicle data like brand, model, price, images, dealer info and more. Rental version.
πŸ”πŸš™ AutoScout24 Scraper (PPR) Scrapes vehicle listings from AutoScout24, with detailed vehicle data like brand, model, price, images, dealer info and more. Pay-per-result version.
πŸš™πŸ“πŸ‘¨β€βš•οΈ AutoScout24 Listing Health Checker Scrapes vehicle listings from AutoScout24, with detailed vehicle data like brand, model, price, images, dealer info and more. Rental version.
πŸ”πŸš™πŸ‡¨πŸ‡­ AutoScout24.ch Scraper (Rental) Scraper dedicated for the Swiss website of AutoScout24. Rental version.
πŸ”πŸš™πŸ‡¨πŸ‡­ AutoScout24.ch Scraper (PPE) Scraper dedicated for the Swiss website of AutoScout24. Pay-per-event version.
### πŸ›’ E-commerce
Actor Description
πŸ”πŸ›’ eBay Scraper (Rental) Extracts product data from eBay, including details like price, title, images, and more. Rental version.
πŸ”πŸ›’ Wish Scraper (PPR) Extracts product data from Wish.com, including details like price, name, reviews, and more.
Can't find what you're looking for? No worries, we've got your back! Hit us up at or create an issue. If all else fails, you can always [visit the Apify store](https://apify.com/store) β€” it could have exactly what you need. πŸ˜‰ # Actor input Schema ## `startUrls` (type: `array`): URLs to start with. Should be search URLs. ## `resultLimitPerUrl` (type: `integer`): Maximum amount of results to be returned for each start URL. Check Readme for more info. ## `simulateCountryCode` (type: `string`): This setting simulates your delivery destination on eBay. It affects item availability, regional pricing, and shipping costs. Change this setting, if you want the Actor to emulate being from a specified country (e.g. United Kingdom, etc.). This feature lets you see how your location affects prices, or just simply lets you pinpoint the regional prices more accurately in general. Default is `United States`. If you want more countries to be added, please create an issue. Note: This setting is ignored if you choose residential proxy. ## `proxyConfiguration` (type: `object`): Select proxies to be used by your crawler. If you select anything, it will disable `🌍 Custom client location` setting. ## Actor input object example ```json { "startUrls": [ "https://www.ebay.com/sch/i.html?_nkw=arduino&_sacat=0&_from=R40&_ipg=240&_pgn=1" ], "resultLimitPerUrl": 100, "simulateCountryCode": "US", "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `overview` (type: `string`): The simplified result view of the Actor. Contains the most important data. # 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 = { "startUrls": [ "https://www.ebay.com/sch/i.html?_nkw=arduino&_sacat=0&_from=R40&_ipg=240&_pgn=1" ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("3x1t/ebay-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 = { "startUrls": ["https://www.ebay.com/sch/i.html?_nkw=arduino&_sacat=0&_from=R40&_ipg=240&_pgn=1"], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("3x1t/ebay-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 '{ "startUrls": [ "https://www.ebay.com/sch/i.html?_nkw=arduino&_sacat=0&_from=R40&_ipg=240&_pgn=1" ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call 3x1t/ebay-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=3x1t/ebay-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "πŸ”πŸ›’ eBay Scraper (Rental)", "description": "Unlock access to millions of product listings on eBay thanks to this unofficial API. Get fast, exhaustive results for valuable e-commerce insights. Fast, cheap & reliable. Rental version.", "version": "0.0", "x-build-id": "dGfcJWsmCrk9pJ8Id" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/3x1t~ebay-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-3x1t-ebay-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/3x1t~ebay-scraper/runs": { "post": { "operationId": "runs-sync-3x1t-ebay-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/3x1t~ebay-scraper/run-sync": { "post": { "operationId": "run-sync-3x1t-ebay-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": { "startUrls": { "title": "πŸ” Start URL(s)", "type": "array", "description": "URLs to start with. Should be search URLs.", "items": { "type": "string" } }, "resultLimitPerUrl": { "title": "🎯 Result limit per URL", "type": "integer", "description": "Maximum amount of results to be returned for each start URL. Check Readme for more info.", "default": 100 }, "simulateCountryCode": { "title": "🌍 Custom client location", "enum": [ "GB", "US" ], "type": "string", "description": "This setting simulates your delivery destination on eBay. It affects item availability, regional pricing, and shipping costs.\n\nChange this setting, if you want the Actor to emulate being from a specified country (e.g. United Kingdom, etc.). This feature lets you see how your location affects prices, or just simply lets you pinpoint the regional prices more accurately in general.\n\nDefault is `United States`.\n\nIf you want more countries to be added, please create an issue.\n\nNote: This setting is ignored if you choose residential proxy.", "default": "US" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your crawler. If you select anything, it will disable `🌍 Custom client location` setting." } } }, "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 } } } } } } } } } } ```