Mercari scrapen in 2026 (API & Python)

Mercari betreibt kein öffentliches Developer-Portal zum Lesen seines Katalogs, deshalb ist der schnellste zuverlässige Weg 2026 eine strukturierte Scraping-API, die normalisiertes JSON für Suchergebnisse, Item-Detail und Taxonomie liefert — statt Mercaris Listing-Seiten selbst zu parsen. Mercari gehört zum selben Resale-Genre wie StockX und Poshmark, hat aber eine Besonderheit, die diese beiden nicht haben: Mercari US und Mercari Japan sind zwei verschiedene Marktplätze unter einer Marke, mit getrennten Apps, getrennten Item-Katalogen und getrennten Währungen — dieser Guide deckt die US-Seite ab.

Warum Mercari-Daten scrapen?

• Resale-Preisrecherche — verfolgen, was ein Artikel, eine Marke oder eine Kategorie auf einem großen Peer-to-Peer-Marktplatz tatsächlich erzielt, als Vergleich zu Retail oder anderen Resale-Seiten.
• Cross-Market-Arbitrage-Recherche — US-Listing-Preise mit den Angebotspreisen eines anderen Marktplatzes für dieselbe Marke oder denselben Artikeltyp vergleichen (Hinweis: Mercari Japan ist ein separater Katalog, nicht dasselbe Inventar).
• Marken- und Kategorie-Trend-Tracking — Listing-Anzahl und Preise für eine Marke oder Kategorie abrufen, um zu sehen, was gerade im Umlauf ist und in welcher Preisspanne.
• Marktrecherche — die Kategorie-/Marken-/Größen-Taxonomie nutzen, um zu ermitteln, wie viele aktive Listings in einer bestimmten Nische existieren, ohne Schreibweisen raten zu müssen.
• KI-Pipelines und Agenten — normalisierte Listing- und Item-Daten in einen Pricing- oder Sourcing-Agenten einspeisen, statt HTML abzugrasen.

Ist es legal, Mercari zu scrapen?

Option 1: DIY in Python (und warum das scheitert)

Ein naiver Scraper lädt eine Suchergebnisseite und versucht, Listing-Karten aus dem gerenderten Markup zu ziehen:

import requests
from bs4 import BeautifulSoup

resp = requests.get(
    "https://www.mercari.com/search/?keyword=nike+jacket",
    headers={"User-Agent": "Mozilla/5.0 (compatible; research-bot/1.0)"},
)
soup = BeautifulSoup(resp.text, "html.parser")
# Listing cards render from client-side state (React/Next.js), so a plain
# HTML parse mostly returns an empty shell — you end up reverse-engineering
# the app's internal JSON endpoints instead

Es funktioniert einmal in der Demo, dann bricht es:

• Die Prohibited Conduct Policy ist eindeutig. Sie nennt Roboter, Spider, Crawler und Scraper direkt als Verstoß, unabhängig von jeder technischen Sperre.
• Anti-Bot-Abwehr. Mercari fronted seine Seite mit Bot-Erkennung; Rechenzentrums-IPs und Headless-Requests werden schnell gedrosselt oder blockiert, besonders bei der Suche.
• Clientseitig gerendertes Markup. Suchergebnisse und Item-Seiten rendern aus JavaScript-State, nicht aus stabilem Server-HTML — eine Layout-Änderung bricht CSS-Selektor-Scraping lautlos.
• Keine sanktionierte Alternative. Anders als eBay betreibt Mercari überhaupt kein Developer-Portal, es gibt also keine offizielle, aber freigegebene API als Rückfalloption für Katalog-Reads.

Option 2: No-Code- und Fertiglösungen

Browser-Erweiterungen und Point-and-Click-Scraper können eine einzelne Suchseite oder einen Item-Schnappschuss exportieren, aber das Tracking von Resale-Preisen einer Marke oder dem Listing-Volumen einer Kategorie über die Zeit bedeutet, dieselben Seiten nach Zeitplan erneut abzugreifen — ein Job für einen stabilen Endpoint mit gespeichertem Verlauf, kein Einmal-Export.

Option 3: Eine strukturierte Mercari-API

Für einen wiederholbaren Workflow liefert eine Mercari scraping API normalisiertes JSON für Suche, Item-Detail, den Home-Feed, Autocomplete und Taxonomie — ohne Seiten-Parsing, ohne Wartezeit auf eine App, die es nicht gibt. Suche nach Stichwort:

curl "https://api.crawlora.net/api/v1/mercari/search?query=nike+jacket" \
  -H "x-api-key: $CRAWLORA_API_KEY"

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "nike jacket",
    "total_results": 21523,
    "items": [
      {
        "id": "m31455228584",
        "url": "https://www.mercari.com/us/item/m31455228584",
        "title": "Nike varsity jacket.   New with tags!",
        "thumbnail_url": "https://u-mercari-images.mercdn.net/photos/m31455228584_1.jpg?1784911712",
        "price_cents": 4873,
        "original_price_cents": 5400,
        "num_likes": 1931,
        "seller_id": "794269920",
        "created_at_unix": 1774057908,
        "updated_at_unix": 1784911712
      }
    ]
  }
}

query ist erforderlich. Hol dir volles Item-Detail, Autocomplete-Vorschläge oder die Taxonomie:

import requests

h = {"x-api-key": "YOUR_API_KEY"}
base = "https://api.crawlora.net/api/v1/mercari"

hits = requests.get(f"{base}/search", headers=h, params={"query": "nike jacket"}).json()["data"]["items"]
item_id = hits[0]["id"]

item = requests.get(f"{base}/item/{item_id}", headers=h).json()["data"]
suggestions = requests.get(f"{base}/autocomplete", headers=h, params={"query": "nik"}).json()["data"]
taxonomy = requests.get(f"{base}/master", headers=h).json()["data"]

Ein Item-Detail-Aufruf führt das vollständige Fotoset, den Preis und eine similar_items-Liste mit, die Mercari selbst anzeigt (echte Felder — prüfe die docs):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "m38581776856",
    "url": "https://www.mercari.com/us/item/m38581776856",
    "title": "Women's NIKE WNBA Nike Mesh Jacket Size NEW MSRP 120",
    "description": "Women's NIKE WNBA Nike Mesh Jacket Size NEW MSRP 120",
    "photos": [
      "https://u-mercari-images.mercdn.net/photos/m38581776856_1.jpg?1777492193",
      "https://u-mercari-images.mercdn.net/photos/m38581776856_2.jpg?1777492193"
    ],
    "price_cents": 4578,
    "condition_code": 1,
    "category_code": 6,
    "shipping_from_state": "New Jersey",
    "similar_items": [
      {
        "id": "m34982910331",
        "url": "https://www.mercari.com/us/item/m34982910331",
        "title": "Lululemon Every Moment Pant *26\" Black Size 6",
        "thumbnail_url": "https://u-mercari-images.mercdn.net/photos/m34982910331_1.jpg?1783333561",
        "price_cents": 4000,
        "num_likes": 1967,
        "seller_id": "790985424",
        "created_at_unix": 1783333561
      }
    ]
  }
}

/mercari/home liefert dieselbe normalisierte Form wie die Suche, aber für Mercaris kuratierten Home-Feed, /mercari/autocomplete wandelt eine Teilanfrage in vorgeschlagene Suchbegriffe um, und /mercari/master liefert den vollständigen Kategoriebaum, die Markenliste und die Größenliste in einem Aufruf, damit du category_code- und condition_code-Werte anreichern kannst, statt Mercaris interne Zuordnung zu raten.

Was du sammeln kannst

• Such- und Home-Feed-Ergebnisse: ID, Titel, Thumbnail, Preis in Cent, Originalpreis bei Rabatt, Like-Zahl, Seller-ID sowie Erstellungs-/Aktualisierungs-Zeitstempel
• Item-Detail: vollständige Beschreibung, Foto-Array, Preis, Zustands- und Kategorie-Codes, Versandort-Bundesstaat und eine similar_items-Liste
• Autocomplete: vorgeschlagene Suchbegriffe für ein Teilstichwort, die Mercaris eigene Suchfeld-Vorschläge widerspiegeln
• Taxonomie: vollständiger Kategoriebaum (mit Parent-/Child-IDs), Markenliste und Größenliste (mit Kurznamen und Codes)

Grenzen

• Es gibt keine offizielle API. Mercari betreibt überhaupt kein Developer-Portal — es gibt keine freigegebene, aber sanktionierte Alternative als Rückfalloption, anders als bei eBay.
• Die Prohibited Conduct Policy ist eindeutig. Sie nennt Roboter, Spider und Scraper direkt als Verstoß, unabhängig von jeder technischen Sperre.
• US und Japan sind getrennte Marktplätze. Diese Endpoints decken Mercari US (mercari.com) ab — Item-IDs, Kategorien und Preise lassen sich nicht auf Mercari Japans (jp.mercari.com) separaten Katalog und Yen-Preise übertragen.
• Preise und Like-Zahlen sind eine Momentaufnahme. Mercari-Artikel werden ständig umbepreist, geliked, gebündelt oder als verkauft markiert — versieh gespeicherte Werte mit einem Zeitstempel.
• Nur öffentliche Daten. Das deckt öffentliche Such-, Item- und Taxonomiedaten ab — nicht private Nachrichten, Angebote oder einen Weg, im Namen eines Käufers eine Bestellung aufzugeben.

Wo das eingesetzt wird

• Resale- und Sourcing-Recherche — die Mercari-Angebotspreise einer Marke gegen Retail oder einen anderen Resale-Marktplatz vergleichen.
• Marken- und Kategorie-Sizing — Listing-Volumen und Preisspannen für eine Marke oder Kategorie mithilfe der Taxonomie plus Suche messen.
• Pricing- und Sourcing-Pipelines — normalisierte Item-Daten in einen Agenten einspeisen, der unterpreiste Listings markiert oder eine Watchlist verfolgt.

Sources

Leg los mit dem Sammeln

Probier es zuerst kostenlos aus: jage eine beliebige öffentliche URL durch den Free Web Scraper, oder prüfe mit dem Anti-Bot Checker, ob eine Seite Bots blockiert — ohne Anmeldung.

Teste die Search-, Item-, Home-, Autocomplete- und Master-Endpoints im Playground, sieh dir das Request- und Response-Schema in den API docs an, und wirf einen Blick auf die Credit-Kosten auf der pricing-Seite. Mercari ist ein allgemeiner Secondhand-Marktplatz, näher an Poshmarks Social-Selling-Listings und Vinteds Peer-to-Peer-Fashion-Resale als an StockX' Orderbuch-Pricing — kombiniere how to scrape StockX mit diesem Guide für ein vollständigeres Bild des Resale-Markts. Siehe auch is web scraping legal.