---

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:

{
  "Token": "your_token_here",
  "SearchQuery": ["iphone 13 mini"],
  "Country": "ebay.co.uk",
  "MaxItems": 50
}

Example Output

[
    {
    "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: support@getdataforme.com
• Subject line: "Ebay Search Spider Support"
• Contact form: https://getdataforme.com/contact/

We’re happy to help you scale your marketplace data collection.