PicClick Marketplace Search Scraper: Extract Auction & Listing Data Globally

---

What Is PicClick?

PicClick is a global online marketplace aggregator and search platform that indexes millions of listings from eBay and other auction/fixed-price sites across multiple countries and domains (picclick.fr, picclick.de, picclick.com, etc.). It enables buyers to search, compare, and purchase items across regions in a unified interface. For data professionals, researchers, and resellers, manually extracting item details from search results is tedious and error-prone — the PicClick Marketplace Search Scraper automates bulk data collection from search result pages.

---

Overview

The PicClick Search Scraper extracts product listings from PicClick search results pages, converting auction and fixed-price item data into structured, machine-readable records. It is ideal for:

• Price analysts monitoring competitive pricing across regions and categories
• Resellers sourcing inventory trends and pricing strategies
• Market researchers studying auction dynamics and product availability
• Data aggregators building multi-source product feeds
• E-commerce platforms enriching catalog data with marketplace comparisons

Strengths include multi-domain support (all PicClick country sites), flexible item-per-URL limits, and robust error handling to ensure collection continuity even when certain pages fail.

---

Input Format

The Actor supports two scraping modes — use only one at a time:

1. Scrape by URLs — scrape data directly from a list of PicClick search result page URLs.

{
  "urls": [
    "https://picclick.fr/Image-son/?q=lips"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}

2. Scrape by search filters — scrape data using a keyword and additional filters (region, price range, shipping, etc.) instead of providing URLs.

{
  "region": "us",
  "keyword": "lip",
  "price_min": "10",
  "price_max": "10000",
  "is_free_shipping": true,
  "return_accepted": true,
  "max_items_per_url": 200
}

There is also a General settings group that applies to both modes.

1. Scrape by URLs

Use this mode when you already have specific PicClick search result page URLs. When this mode is used, all options in the "Scrape by search filters" section will be disabled.

Field	Type	Default	Description
urls	array	(required)	One or more PicClick search result page URLs to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. Must be search result pages, not direct item listings — see URL Format & Scope below.
ignore_url_failures	boolean	true	If true, the scraper continues running when a URL fails instead of stopping the entire run. Recommended for bulk jobs.

URL Format & Scope

Valid URLs must be PicClick search result pages, not direct item listings. Examples across domains:

• https://picclick.fr/Image-son/?q=lips (French, audio/image category)
• https://picclick.de/Elektronik/?q=smartphone (German, electronics)
• https://picclick.com/Antiques/?q=vintage (US/English, antiques)
• https://picclick.it/Moda/?q=shoes (Italian, fashion)

The scraper extracts all items displayed on the page up to the max_items_per_url limit. Pagination is not automatic — include multiple page URLs if needed (e.g., page 1, page 2).

Note: URLs should end in ?q=searchterm or a category path without a trailing /. Regional domains (.fr, .de, .it, .es, etc.) are fully supported.

2. Scrape by search filters

Use this mode when you want to search using a keyword and additional filter attributes instead of scraping by URLs. If you use this mode, leave the urls field above empty.

Field	Type	Default	Description
keyword	string	—	The keyword to search for.
region	string (us, au, ca, fr, de, it, es, uk)	—	The regional PicClick domain to search: United States, Australia, Canada, France, Germany, Italy, Spain, United Kingdom.
price_min	number	—	Minimum price to filter items by.
price_max	number	—	Maximum price to filter items by.
is_free_shipping	boolean	false	If true, only items with free shipping will be scraped.
return_accepted	boolean	false	If true, only items with returns accepted will be scraped.

3. General settings

Applies to both scraping modes above.

Field	Type	Default	Description
max_items_per_url	integer	20	The maximum number of items to scrape per URL/search. Typical range: 20–500.

---

Output Format

Sample output

{
  "item_id": "v1|336070702142|0",
  "title": "Ray-Ban Meta Wayfarer reconditionnées (Gen 1), Noir Mat / Transitions®, Gen S G1",
  "leaf_category_ids": [
    "184645"
  ],
  "categories": [
    {
      "category_id": "184645",
      "category_name": "Casques VR autonomes"
    },
    {
      "category_id": "293",
      "category_name": "Image, son"
    },
    {
      "category_id": "183067",
      "category_name": "Réalité virtuelle"
    }
  ],
  "image": {
    "image_url": "https://i.ebayimg.com/images/g/z-AAAeSwDWVodn9A/s-l225.jpg"
  },
  "price": {
    "value": "245.00",
    "currency": "EUR"
  },
  "item_href": "https://api.ebay.com/buy/browse/v1/item/v1%7C336070702142%7C0",
  "seller": {
    "username": "meta_store_eu",
    "feedback_percentage": "96.4",
    "feedback_score": 927,
    "seller_account_type": "BUSINESS"
  },
  "condition": "Reconditionné par la marque",
  "condition_id": "2000",
  "thumbnail_images": [
    {
      "image_url": "https://i.ebayimg.com/images/g/z-AAAeSwDWVodn9A/s-l1600.jpg"
    }
  ],
  "shipping_options": [
    {
      "shipping_cost_type": "FIXED",
      "shipping_cost": {
        "value": "0.00",
        "currency": "EUR"
      }
    }
  ],
  "buying_options": [
    "FIXED_PRICE"
  ],
  "item_affiliate_web_url": "https://www.ebay.fr/itm/336070702142?hash=item4e3f5ff43e%3Ag%3Az-AAAeSwDWVodn9A&amdata=enc%3AAQALAAAA4ACCtXRWQnOEpyOqnQQ8KGZ92sX2VYHOjeIv1GopK1qGDLLCLqVuOmSwh6QgyL3x3LOXz%2BYdRUDJ781CbGuJnMnFhu2LmPTKDIPuDaBSN1%2FOhGAPs600h23tPHthDnWLJfog1XV37Ov9r5AyQHwXJ02fVg8vR%2FnudzoIpb%2FAph8Wh8e%2FdhooXxEnE4AyiCLTl86gmwXY5pY%2FHIyG%2F8tAxguxiPdi9NHO0ReHoYVGezw5312ylqOrUSD9RJBJUOH8B5jQyUCAj69fgu3xLytAG%2FSHsUVlBG9gvRBihrfE6SgL&mkevt=1&mkcid=1&mkrid=709-53476-19255-0&campid=5338722076&customid=&toolid=10049",
  "item_web_url": "https://www.ebay.fr/itm/336070702142?hash=item4e3f5ff43e:g:z-AAAeSwDWVodn9A&amdata=enc%3AAQALAAAA4ACCtXRWQnOEpyOqnQQ8KGZ92sX2VYHOjeIv1GopK1qGDLLCLqVuOmSwh6QgyL3x3LOXz%2BYdRUDJ781CbGuJnMnFhu2LmPTKDIPuDaBSN1%2FOhGAPs600h23tPHthDnWLJfog1XV37Ov9r5AyQHwXJ02fVg8vR%2FnudzoIpb%2FAph8Wh8e%2FdhooXxEnE4AyiCLTl86gmwXY5pY%2FHIyG%2F8tAxguxiPdi9NHO0ReHoYVGezw5312ylqOrUSD9RJBJUOH8B5jQyUCAj69fgu3xLytAG%2FSHsUVlBG9gvRBihrfE6SgL",
  "item_location": {
    "postal_code": "59****",
    "country": "NL"
  },
  "adult_only": false,
  "legacy_item_id": "336070702142",
  "available_coupons": false,
  "item_origin_date": "2025-07-17T01:24:53.000Z",
  "item_creation_date": "2025-07-17T01:24:53.000Z",
  "top_rated_buying_experience": false,
  "priority_listing": true,
  "watch_count": 1,
  "listing_marketplace_id": "EBAY_FR",
  "from_url": "https://picclick.fr/Image-son/"
}

Each item in the scrape results includes 24 comprehensive fields:

Item Identification

Field	Meaning	Example
Item ID	Unique identifier within PicClick/marketplace	"324891234567"
Legacy Item ID	Previous or alternate item ID format	"LG324891234567"
Listing Marketplace ID	Source marketplace code (eBay, etc.)	"ebay"
Title	Product name and primary description	"Vintage Sony Walkman - Condition: Fair"

Categorization

Field	Meaning	Example
Leaf Category IDs	Most specific category identifiers	["6000", "6001"]
Categories	Full category path (human-readable)	"Electronics > Portable Audio > Walkmen"

Pricing & Condition

Field	Meaning	Example
Price	Current item price in listing currency	"€25.99" or "$45.00"
Condition	Item state (New, Used, Refurbished, For Parts)	"Used"
Condition ID	Numeric condition code	"3000" (typically 3000–5000 range)

Visual & Media

Field	Meaning	Example
Image	Primary/main product image URL	"https://cdn.picclick.fr/img/324891.jpg"
Thumbnail Images	Array of additional image URLs	["img1.jpg", "img2.jpg", "img3.jpg"]

Seller & Transaction

Field	Meaning	Example
Seller	Seller/merchant name and rating	"TechDealer2023 (98.5%)"
Buying Options	Available purchase methods	"Buy It Now" or "Auction" or "Fixed Price"
Shipping Options	Available shipping methods and costs	"Standard Shipping: €5.99, Express: €12.99"
Top Rated Buying Experience	Seller has top-rated feedback badge	true or false

Item Details & Location

Field	Meaning	Example
Item Location	Geographic location of the item	"Paris, France" or "Berlin, Germany"
Item Href	Direct link to the source listing	"https://ebay.fr/itm/324891234567"
Item Web URL	PicClick's URL for this item	"https://picclick.fr/item/324891234567"
Item Affiliate Web URL	PicClick affiliate-tracked URL	"https://picclick.fr/aff/?item=324891234567"

Listing Attributes

Field	Meaning	Example
Adult Only	Item is restricted to adult buyers	true or false
Priority Listing	Item has paid priority/featured placement	true or false
Available Coupons	Number of available discount codes	2
Watch Count	Number of users monitoring this item	47

Timeline

Field	Meaning	Example
Item Origin Date	When the item was originally created/minted (if applicable)	"2015-03-20"
Item Creation Date	When the listing was published	"2024-01-15T14:32:00Z"

---

How to Use

1. Identify search URLs — Go to PicClick (any domain) and search for products you want to analyze. Copy the full search result page URL.

2. Prepare your input — Create a JSON config with:

   • One or more search URLs in the urls array
   • Set max_items_per_url based on your data volume needs (20–500 recommended)
   • Enable ignore_url_failures: true for uninterrupted multi-URL runs

3. Configure domain & region — PicClick supports all regional domains (.fr, .de, .com, .it, .es, etc.). Mix URLs from different domains in the same run if needed.

4. Start the scrape — Execute the actor and monitor the progress log.

5. Export & process — Download results as JSON or CSV. Fields are consistently structured across all domains for easy downstream analysis.

Best Practices

• Pagination: If a search has 500+ items, create URLs for multiple pages (sort by newest or lowest price, then paste page 2, 3, etc.)
• Category specificity: Use narrower category searches (e.g., /Electronics/Phones/) for more relevant results
• Error handling: Set ignore_url_failures: true to skip broken or restricted pages without halting the run
• Rate limiting: Space out large runs to respect PicClick's server load; avoid hammering in rapid succession

---

Use Cases & Business Value

• Competitive pricing: Track how competitor items and pricing evolve across regions
• Trend analysis: Identify hot product categories, seasonal demand, and supply shifts
• Reseller optimization: Monitor source costs to optimize arbitrage margins and inventory decisions
• Market research: Benchmark product availability, condition distribution, and seller ratings across PicClick domains
• Multi-channel selling: Aggregate competitor listings to inform own pricing and positioning strategies
• Data enrichment: Feed marketplace comparables into e-commerce platforms for buyer context

The PicClick Search Scraper transforms hours of manual search-and-collect work into minutes of automated data extraction, delivering clean, standardized item records ready for analysis, reporting, and integration.

---

Conclusion

Whether you're a price analyst, reseller, or researcher, the PicClick Marketplace Search Scraper unlocks structured auction and fixed-price item data across global PicClick domains. With 24 detailed fields per item and robust multi-domain support, you gain the insights needed to stay competitive and informed in fast-moving online marketplaces.