Mercari Scraper – Live Thrift Resale Data
Pricing
from $1.50 / 1,000 results
Live Mercari resale intelligence for thrift, vintage & streetwear resellers. Keyword search, full listing details, closet inventory, seller stats, sold comps & URL scrape — streamed as structured JSON in real time. Free plan: 2 results per run; paid plans unlimited.
You can access the Mercari Scraper – Live Thrift Resale Data programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.0", "x-build-id": "rxCajiIZSjx0lQbfE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/b2b_leads~mercari-real-time-data-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-b2b_leads-mercari-real-time-data-scraper", "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/b2b_leads~mercari-real-time-data-scraper/runs": { "post": { "operationId": "runs-sync-b2b_leads-mercari-real-time-data-scraper", "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/b2b_leads~mercari-real-time-data-scraper/run-sync": { "post": { "operationId": "run-sync-b2b_leads-mercari-real-time-data-scraper", "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", "properties": { "country": { "title": "Region", "enum": [ "US", "JP" ], "type": "string", "description": "Marketplace region. Affects currency, catalog language, and the recommended connection region.", "default": "US" }, "enableListingSearch": { "title": "Listing Search", "type": "boolean", "description": "Search Mercari by keyword and optional filters. On by default — prefilled so you can click Start immediately.", "default": true }, "searchKeywords": { "title": "Search keywords", "type": "array", "description": "One or more search terms (e.g. carhartt detroit jacket, vintage 90s levis 501, patagonia fleece). Required when Listing Search is on.", "default": [ "carhartt detroit jacket", "vintage 90s levis 501", "patagonia fleece" ], "items": { "type": "string" } }, "searchMaxResults": { "title": "Max results per keyword", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum listings to return for each keyword (1–200). Defaults to 10 for fast instant demo runs.", "default": 10 }, "searchSort": { "title": "Sort order", "enum": [ "relevance", "created_time", "price_asc", "price_desc", "likes_desc" ], "type": "string", "description": "How to order search results.", "default": "created_time" }, "searchBrand": { "title": "Brand filter (optional)", "type": "string", "description": "Limit results to a brand name (e.g. Carhartt, Levi's, Patagonia, The North Face).", "default": "" }, "searchSize": { "title": "Size filter (optional)", "type": "string", "description": "e.g. M, L, XL, 32, 34.", "default": "" }, "searchItemCondition": { "title": "Condition filter (optional)", "type": "array", "description": "Filter by item condition IDs (1 = New, 2 = Like new, 3 = Hardly used, 4 = Lightly used, 5 = Used, 6 = Damaged). Leave empty for any.", "default": [], "items": { "type": "string" } }, "searchMinPrice": { "title": "Min price (optional)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Minimum price in the selected region currency." }, "searchMaxPrice": { "title": "Max price (optional)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Maximum price in the selected region currency — great for under-retail hunts." }, "searchStatus": { "title": "Listing status filter (optional)", "type": "array", "description": "STATUS_ON_SALE for live listings, STATUS_SOLD_OUT for sold ones. Defaults to on-sale listings.", "default": [ "STATUS_ON_SALE" ], "items": { "type": "string" } }, "searchCategoryId": { "title": "Category ID (optional)", "type": "string", "description": "Optional numeric Mercari category ID to narrow the search.", "default": "" }, "searchFetchFullDetails": { "title": "Enrich with full listing details", "type": "boolean", "description": "When on, each search result is the SAME row enriched with full product fields (description, fabric/material tags, style tags, full image gallery, seller shipping discounts). Still featureType listing_search with detailsFetched=true — never a second row, and nothing is filtered out. Adds a little extra time per listing to enrich full product details.", "default": false }, "enableListingDetails": { "title": "Listing Details", "type": "boolean", "description": "Fetch full product data for specific listing IDs or URLs.", "default": false }, "itemIds": { "title": "Listing IDs", "type": "array", "description": "Mercari listing IDs (24-character codes).", "default": [], "items": { "type": "string" } }, "itemUrls": { "title": "Listing URLs", "type": "array", "description": "Full Mercari product URLs (https://www.mercari.com/us/item/…).", "default": [], "items": { "type": "string" } }, "enableClosetListings": { "title": "Closet Listings", "type": "boolean", "description": "Collect a reseller's or thrift closet's full active inventory to track competitor stock.", "default": false }, "enableSellerProfile": { "title": "Seller Profile", "type": "boolean", "description": "Extract reseller stats: love notes (ratings), items sold, closet size, verification, bio details.", "default": false }, "enableSoldHistory": { "title": "Sold Item Comps / History", "type": "boolean", "description": "Collect completed and sold listings to calculate real market comps, resale margins, and sell-through rates.", "default": false }, "sellerIds": { "title": "Seller IDs", "type": "array", "description": "Mercari seller (user) IDs. Shared by Closet Listings, Seller Profile, and Sold Item Comps.", "default": [], "items": { "type": "string" } }, "sellerUsernames": { "title": "Seller usernames (optional)", "type": "array", "description": "Alternative to seller IDs — merged automatically when IDs are empty.", "default": [], "items": { "type": "string" } }, "sellerMaxListings": { "title": "Max listings per closet", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum active listings to collect per closet (1–500).", "default": 30 }, "soldMaxItems": { "title": "Max sold items per seller", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum sold listings to collect per seller (1–200).", "default": 30 }, "enableScrapeByUrl": { "title": "Scrape By URL", "type": "boolean", "description": "Paste any Mercari URL — search, closet, item, category, or brand feed.", "default": false }, "scrapeUrls": { "title": "Mercari URLs", "type": "array", "description": "Any Mercari search, closet, item, category, or brand URL.", "default": [], "items": { "type": "string" } }, "scrapeMaxPages": { "title": "Max pages per URL", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many result pages to browse per URL (1–20).", "default": 3 }, "includeDescription": { "title": "Include description", "type": "boolean", "description": "Include the seller-written listing description when available in fast search cards.", "default": true }, "includeShippingDetails": { "title": "Include shipping details", "type": "boolean", "description": "Include shipping cost, method, and origin when present.", "default": true }, "includeSellerDetails": { "title": "Include seller details", "type": "boolean", "description": "Include seller rating, counts, and location fields on item rows.", "default": true }, "maxItems": { "title": "Global max items (optional)", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap across all features for this run. Leave empty for no global cap." }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional. Every record is always saved to the run dataset — this webhook is an ADDITIONAL real-time push. Each new row is also POSTed to this URL (Slack, Discord, Zapier, Make, n8n, custom pricing bot).", "default": "" }, "webhookFormat": { "title": "Webhook format", "enum": [ "json", "slack" ], "type": "string", "description": "json = full record object; slack = Slack-friendly message payload.", "default": "json" }, "proxyConfiguration": { "title": "Proxy settings", "type": "object", "description": "Residential proxy recommended. Match country to the Region above (US / JP).", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Mercari Scraper – Live Thrift Resale Data from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: