# Ebay Search Country Filter Spider\[Client] (`getdataforme/ebay-search-country-filter-spider-client`) Actor The actor runs eBay searches with token-based access, accepts multiple search queries, applies country marketplace selection, and limits returned items. It standardizes listing data output, supporting scalable scraping, filtering, and structured analytics across supported eBay regional sites. - **URL**: https://apify.com/getdataforme/ebay-search-country-filter-spider-client.md - **Developed by:** [GetDataForMe](https://apify.com/getdataforme) (community) - **Categories:** Automation, Lead generation, E-commerce - **Stats:** 1 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $50.00/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 --- ## Ebay Search Country Filter Spider ### Introduction The Ebay Search Country Filter Spider is a powerful Apify Actor designed to search and extract product listings from various eBay regional marketplaces. It collects detailed listing information such as title, price, seller details, shipping costs, ratings, item specifics, and metadata. With configurable search queries, marketplace country selection, and maximum item limits, this actor enables localized marketplace intelligence and automated eBay data collection without manual browsing. ### Features * **Multi-Country Marketplace Support**: Search across supported eBay domains including United States, Italy, Germany, France, Spain, United Kingdom, and Canada. * **Flexible Search Queries**: Accepts multiple keywords to run batch searches in a single execution. * **Structured JSON Output**: Returns clean, standardized listing data ready for databases, dashboards, or analytics workflows. * **Seller & Listing Insights**: Extracts seller ratings, feedback score, shipping details, item specifics, and listing status. * **Token-Based Access Control**: Secure actor execution using authentication token. * **Scalable Scraping**: Supports configurable maximum item limits for small tests or large data collection. * **Reliable Extraction**: Built with robust parsing logic to handle marketplace variations across countries. ### Input Parameters | Parameter | Type | Required | Description | Example | | ----------- | ------- | -------- | ----------------------------------------- | -------------------- | | Token | string | true | Access token required to run the actor. | your_token_here | | SearchQuery | array | false | List of search keywords to query on eBay. | ["iphone", "laptop"] | | Country | string | false | eBay marketplace domain to search. | ebay.co.uk | | MaxItems | integer | false | Maximum number of listings to return. | 100 | ### Example Usage To run the Actor, provide input JSON: ```json { "Token": "your_token_here", "SearchQuery": ["iphone 13 mini"], "Country": "ebay.co.uk", "MaxItems": 50 } ```` ### Example Output ```json [ { "listing_id": "206086046665", "listing_url": "https://www.ebay.co.uk/itm/206086046665", "title": "iPhone 13 Mini 128GB Starlight A-Grade Unlocked Phone", "price": "USย $432.13", "image_url": "https://i.ebayimg.com/images/g/kJ0AAeSwK~NpmpUU/s-l400.jpg", "quantity": 1, "shipping_cost": "+ยฃ29.67 delivery", "listing_condition": "Used", "listing_price_currency": "GBP", "listing_price_value": 320.57, "listing_quantity_available": null, "listing_status": "ACTIVE", "seller_username": "k-stargoods", "seller_name": "k-star goods", "seller_profile_link": "https://www.ebay.co.uk/usr/k-stargoods?_trksid=p4429486.m3561.l49544", "seller_email": "kstargoods@codegurus.co.kr", "seller_phone": "+82 1027558507", "seller_feedback_percentage": "96.6", "seller_feedback_score": "1069", "seller_ratings": { "Accurate description": 4.7, "Reasonable postage cost": 4.3, "Delivery time": 4.8, "Communication": 4.7 }, "seller_is_top_rated": false, "seller_store_name": "k-star goods", "seller_store_url": "https://www.ebay.co.uk/str/kstartgoods?_trksid=p4429486.m3561.l49544", "seller_links": [ "https://www.ebay.co.uk/usr/k-stargoods?_trksid=p4429486.m3561.l49544", "https://www.ebay.co.uk/str/kstartgoods?_trksid=p4429486.m3561.l49544" ], "seller_location": "Saejongdaero 23gil 47, 418HO, Seoul, 03182, South Korea", "seller_member_since": "Jul 2024", "seller_business_name": "Codename Co", "seller_address": "Saejongdaero 23gil 47, 418HO, Seoul, 03182, South Korea", "seller_vat_number": null, "total_number_sold": null, "total_items_sold": null, "seller_followers": null, "item_specifics": { "Condition": "Used. An item that has been previously used. The item may have some signs of cosmetic wear, but is fully operational and functions as intended. This item may be a floor model or an item that has been returned to the seller after a period of use. See the sellerโ€™s listing for full details and description of any imperfections. ", "Quantity": "1 available", "Item number": "206086046665", "Brand": "Apple", "Style": "Vintage", "Department": "Men", "Color": "Starlight", "Type": "Smartphone", "Country of Origin": "Korea", "Model": "iPhone 13 Mini", "Size": "128GB", "Gender": "Unisex", "Storage Capacity": "Does not apply", "Category": "Cell Phones & Accessories > Cell Phones & Smartphones" }, "search_query": "iphone", "domain": "ebay.co.uk", "marketplace": "EBAY-GB" } ] ``` ### Use Cases - **Product Research**: Discover pricing trends across different eBay countries. - **Competitor Monitoring**: Track seller listings, feedback, and inventory. - **Price Intelligence**: Monitor price changes for specific products or categories. - **Lead Generation**: Identify active sellers within niches. - **Marketplace Analytics**: Build dashboards for cross-country eBay insights. - **Dropshipping Research**: Find suppliers and compare regional availability. ### Installation and Usage 1. Search for **Ebay Search Country Filter Spider** in the Apify Store. 2. Click **Try for free** or **Run**. 3. Enter your Token and configuration. 4. Select search queries and marketplace country. 5. Start the run. 6. Export results in JSON, CSV, or Excel. ### Output Format The Actor outputs an array of listing objects. Key fields include: - `listing_id`: Unique eBay listing identifier. - `title`: Product title. - `price` and `currency`: Listing price information. - `listing_condition`: Item condition (new/used). - `seller_username`: Seller identifier. - `seller_feedback_percentage`: Seller reputation metric. - `shipping_cost`: Shipping information. - `item_specifics`: Structured product attributes. - `marketplace`: Marketplace country code. The structure is optimized for downstream automation and analytics. ### Support For custom outputs, integrations, or bug reports: - Email: - Subject line: "Ebay Search Spider Support" - Contact form: Weโ€™re happy to help you scale your marketplace data collection. # Actor input Schema ## `Token` (type: `string`): Access token required to run this actor. Contact the developer to get a valid token. ## `SearchQuery` (type: `array`): The search query for the spider. ## `Country` (type: `string`): eBay marketplace country to search. ## `MaxItems` (type: `integer`): Maximum number of items to return. Leave empty for no limit. ## Actor input object example ```json { "SearchQuery": [ "flower seeds" ], "Country": "ebay.it", "MaxItems": 100 } ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("getdataforme/ebay-search-country-filter-spider-client").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 = {} # Run the Actor and wait for it to finish run = client.actor("getdataforme/ebay-search-country-filter-spider-client").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 '{}' | apify call getdataforme/ebay-search-country-filter-spider-client --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getdataforme/ebay-search-country-filter-spider-client", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Ebay Search Country Filter Spider[Client]", "description": "The actor runs eBay searches with token-based access, accepts multiple search queries, applies country marketplace selection, and limits returned items. It standardizes listing data output, supporting scalable scraping, filtering, and structured analytics across supported eBay regional sites.", "version": "0.0", "x-build-id": "d7vq9nx20X8JFpb81" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getdataforme~ebay-search-country-filter-spider-client/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getdataforme-ebay-search-country-filter-spider-client", "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/getdataforme~ebay-search-country-filter-spider-client/runs": { "post": { "operationId": "runs-sync-getdataforme-ebay-search-country-filter-spider-client", "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/getdataforme~ebay-search-country-filter-spider-client/run-sync": { "post": { "operationId": "run-sync-getdataforme-ebay-search-country-filter-spider-client", "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", "required": [ "Token" ], "properties": { "Token": { "title": "Token", "type": "string", "description": "Access token required to run this actor. Contact the developer to get a valid token." }, "SearchQuery": { "title": "Search Query", "type": "array", "description": "The search query for the spider.", "default": [ "flower seeds" ], "items": { "type": "string" } }, "Country": { "title": "Country", "enum": [ "ebay.com", "ebay.it", "ebay.de", "ebay.fr", "ebay.es", "ebay.co.uk", "ebay.ca" ], "type": "string", "description": "eBay marketplace country to search.", "default": "ebay.it" }, "MaxItems": { "title": "Max Items", "minimum": 1, "type": "integer", "description": "Maximum number of items to return. Leave empty for no limit.", "default": 100 } } }, "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 } } } } } } } } } } ```