---

README.md

Vinted Discovery Extractor

Introduction

The Vinted Discovery Extractor is a powerful tool designed to efficiently scrape and extract data from the Vinted platform. It enables users to gather detailed information about items listed on Vinted, providing valuable insights for market research, competitive analysis, and more.

Features

• Comprehensive Data Extraction: Captures extensive details including item ID, title, brand, condition, pricing, seller information, and images.
• Flexible Query Configuration: Allows users to specify multiple search queries to tailor data extraction needs.
• Scalable Item Limiting: Users can set a maximum number of items to scrape per run or opt for unlimited scraping.
• High-Quality Data Output: Ensures reliable and accurate data with structured JSON output.
• User-Friendly Setup: Simple configuration process with clear input parameters.

Input Parameters Table

Parameter	Type	Required	Description	Example
Queries	array	No	The queries for the spider.	["disney", "mickey"]
item_limit	integer	No	Maximum items to scrape per actor run. Set to 0 for no limit.	10

Example Usage

Input JSON

{
  "Queries": ["disney"],
  "item_limit": 10
}

Output JSON

[
  {
    "id": 9518245529,
    "title": "Pumpkin Mickey Ears Walt Disney World",
    "content_source": "search_promoted_items",
    "favourite_count": 4,
    "is_favourite": false,
    "promoted": true,
    "view_count": 0,
    "url": "https://www.vinted.com//items/9518245529-pumpkin-mickey-ears-walt-disney-world",
    "brand_title": "Disney",
    "condition": "New without tags",
    "accessibility_label": "Pumpkin Mickey Ears Walt Disney World, Brand: Disney, Condition: New without tags, 15.00 $, 16.45 $",
    "price_amount": "15.00",
    "price_currency": "USD",
    "service_fee_amount": "1.45",
    "service_fee_currency": "USD",
    "total_price_amount": "16.45",
    "total_price_currency": "USD",
    "seller_id": 3171893781,
    "seller_login": "froggieberrie",
    "seller_is_business": false,
    "photo_url": "https://images1.vinted.net/t/05_01c59_fimsE7ZJL3merVsbamVXry6K/f800/4d4ecc0c.webp?s=434100a67190914883f0d641df209419cf80bcab",
    "photo_full_size_url": "https://images1.vinted.net/tc/01_016b8_TYhUqpk2tRb4GaekcdGZAEqY/36951b32.webp?s=933fd9f1f82300da00dddef7556203396c725ca8",
    "photos": [
      {
        "id": 1,
        "image_no": 1,
        "url": "https://images1.vinted.net/t/01_016b8_TYhUqpk2tRb4GaekcdGZAEqY/f800/36951b32.webp?s=434100a67190914883f0d641df209419cf80bcab",
        "full_size_url": "https://images1.vinted.net/tc/01_016b8_TYhUqpk2tRb4GaekcdGZAEqY/36951b32.webp?s=933fd9f1f82300da00dddef7556203396c725ca8",
        "is_main": true,
        "width": 600,
        "height": 800,
        "dominant_color": "#A8AFB8"
      }
    ],
    "input_source_key": "start_url:https://api.www.vinted.com/svc-catalogue/items?page=1&per_page=96&search_text=disney&order=relevance&global_search_session_id=9bd293af-7534-4549-8242-14cecf88f9aa&attribute_ids[catalog]&attribute_ids[size]&attribute_ids[brand]&attribute_ids[status]&attribute_ids[color]&attribute_ids[material]",
    "actor_id": "6b1E9B7LoDhOL12FJ",
    "run_id": "tehnhNtgADpHaQIM0"
  }
]

Use Cases

• Market Research and Analysis: Gain insights into market trends and consumer preferences.
• Competitive Intelligence: Monitor competitor listings and pricing strategies.
• Price Monitoring: Track price changes over time for specific items or categories.
• Content Aggregation: Aggregate content for marketing campaigns or product recommendations.
• Academic Research: Collect data for studies on e-commerce behavior and trends.
• Business Automation: Automate data collection processes to enhance business operations.

Installation and Usage

1. Search for "Vinted Discovery Extractor" in the Apify Store.
2. Click "Try for free" or "Run".
3. Configure input parameters as needed.
4. Click "Start" to begin extraction.
5. Monitor progress in the log.
6. Export results in your preferred format (JSON, CSV, Excel).

Output Format

The output is a structured JSON array containing detailed information about each item scraped from Vinted. Key fields include:

• id: Unique identifier for the item.
• title: Name of the item.
• brand_title: Brand associated with the item.
• condition: Condition status (e.g., New, Used).
• price_amount, service_fee_amount, total_price_amount: Pricing details in USD.
• seller_id, seller_login: Information about the seller.
• photo_url, photo_full_size_url: URLs for item images.

Support

For custom/simplified outputs or bug reports, please contact:

• Email: support@getdataforme.com
• Subject line: "custom support"
• Contact form: Contact Us

We're here to help you get the most out of this Actor!