Mercari Inserzioni vendute API

Search Mercari US or Japan sold listings by keyword with optional price-range, condition, category, brand, and sort filters, page by page; ideal for resale pricing research. The sold price is the final price after any accepted offer; it does not include buyer fees, and whether shipping is included depends on the listing's shipping terms. Rows carry no sale date: call mercari.product for soldUtc (US only).

POST/v1/run/mercari.sold_listings

Richieste

-

30d

Prezzi

Prezzi dell'API Mercari Inserzioni vendute

Provider

Chameleon- serviti- di disponibilità- p50---0,85 USD/1k richiestefisso

Mi servonorichieste

Paghi

8,50 USD

0,85 USD/1k richieste, solo per ciò che usi. Nessun piano mensile.

Le tue prime 117 richieste sono gratuite con il saldo iniziale di 0,10 USD.

Provalo

Ottieni Mercari Inserzioni vendute in una sola richiesta

query*stringSearch keyword (e.g. nike air jordan 1). Japanese terms return far more in Japan, though Latin brand and model names work.brandIdstringMercari brand id, or several separated by commas; the US and Japan use separate ids (e.g. 319 for Apple in the US). Every US row carries its brandId.categoryIdstringMercari category id, or several separated by commas; the US and Japan use separate ids and a parent id includes its children (e.g. 778 for US cell phones and smartphones). Every row carries its categoryId.countryenumMercari marketplace: us (mercari.com, USD) or jp (jp.mercari.com, JPY).cursorstringPagination cursor: pass the previous response's nextCursor with the same query and filters; omit for the first page.maxPriceinteger 0-Highest sold price to include, in whole units of the country's currency (e.g. 300).minPriceinteger 0-Lowest sold price to include, in whole units of the country's currency (US dollars or yen) (e.g. 50).sortenumResult order; omitted means Mercari's default (most recently sold first for a US sold search). most_liked is Japan only; recently_sold is US only (e.g. price_desc).

import os, requests

res = requests.post(
    "https://api.getanyapi.com/v1/run/mercari.sold_listings",
    headers={"Authorization": f"Bearer {os.environ['ANYAPI_KEY']}"},
    json={
        "query": "nike air jordan 1",
        "country": "us"
    },
)
print(res.json())

const res = await fetch("https://api.getanyapi.com/v1/run/mercari.sold_listings", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ANYAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "query": "nike air jordan 1",
    "country": "us"
  }),
});
const data = await res.json();
console.log(data);

curl -X POST https://api.getanyapi.com/v1/run/mercari.sold_listings \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"nike air jordan 1","country":"us"}'

Apri inPrompt copiato

Ottieni una chiave gratuita

Risposta di esempio

Le esecuzioni gratuite restituiscono solo i primi 3 risultati. Ricarica una chiave per ottenere la risposta completa.

{
  "data": {
    "items": [
      {
        "brand": "Acme Inc",
        "brandId": "Acme Inc",
        "category": "general",
        "categoryId": "general",
        "condition": "example",
        "createdUtc": 12.5,
        "currency": "USD",
        "image": "https://example.com/image.jpg",
        "itemId": "a1b2c3d4",
        "originalPrice": 19.99,
        "price": 19.99,
        "sellerId": "a1b2c3d4",
        "size": "example",
        "status": "active",
        "title": "Example title",
        "updatedUtc": 12.5,
        "url": "https://example.com/page"
      }
    ],
    "nextCursor": "example"
  },
  "found": true,
  "reason": "not_found"
}

Riferimento completo di parametri e risposta - ogni campo, tipo ed esempio per questo endpoint.

Riferimento

Una richiesta, una sola forma di risposta.

Ogni campo che invii e ogni campo che ricevi, ciascuno con un esempio reale.

Ultima verifica 2026-11-11 · disponibilità e latenza misurate su 30d

Corpo della richiesta

JSON, inviato a questo endpoint.

querystring
nike air jordan 1
Search keyword (e.g. nike air jordan 1). Japanese terms return far more in Japan, though Latin brand and model names work.
brandIdstring
Mercari brand id, or several separated by commas; the US and Japan use separate ids (e.g. 319 for Apple in the US). Every US row carries its brandId.
categoryIdstring
Mercari category id, or several separated by commas; the US and Japan use separate ids and a parent id includes its children (e.g. 778 for US cell phones and smartphones). Every row carries its categoryId.
conditionarray
Only listings in any of these condition grades (e.g. ["new", "like_new"]). worn is Japan only.
countryenum
Mercari marketplace: us (mercari.com, USD) or jp (jp.mercari.com, JPY).
cursorstring
Pagination cursor: pass the previous response's nextCursor with the same query and filters; omit for the first page.
maxPriceinteger
Highest sold price to include, in whole units of the country's currency (e.g. 300).
minPriceinteger
Lowest sold price to include, in whole units of the country's currency (US dollars or yen) (e.g. 50).
sortenum
Result order; omitted means Mercari's default (most recently sold first for a US sold search). most_liked is Japan only; recently_sold is US only (e.g. price_desc).

Tu invii. Un piccolo corpo JSON. I valori mostrati sono esempi da sostituire con i tuoi.

Risposta

JSON, un valore di esempio per campo.

each itemdata.items[]

Sold listing records: up to 100 a page in the US and 120 in Japan. Populated whenever the provider has data for the entity.

brandstring
Brand name the seller tagged; null when untagged (Japan search rows carry no brand: use mercari.product).
brandIdstring
Mercari brand id, usable as the brandId filter in the same country.
categorystring
Leaf category name (US); null on Japan search rows.
categoryIdstring
Mercari leaf category id, usable as the categoryId filter in the same country.
conditionstring
Item condition grade: new, like_new, good, fair, poor, or worn (Japan only).
createdUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the item was listed. Japan only: null on US search rows (use mercari.product).
currencystring
ISO currency code of the price: USD for the US, JPY for Japan. Populated whenever the provider has data for the entity.
imagestring
Primary listing image URL. Populated whenever the provider has data for the entity.
itemIdstring
Mercari item id (m followed by 11 digits, or a 22-character Mercari Shops product id in Japan). Populated whenever the provider has data for the entity.
originalPricenumber
First asking price of the listing in USD; differs from price when the seller lowered it or accepted an offer. US only: null in Japan.
pricenumber
Price in the listing currency. On a sold row (status sold_out or trading) this is the final sale price after any accepted offer; it does not include buyer fees, and whether shipping is included depends on the listing's shipping terms. Populated whenever the provider has data for the entity.
sellerIdstring
Mercari seller id.
sizestring
Size label the seller chose (e.g. 8.5 (39)), when the category has sizes.
statusstring
Listing state: on_sale (active), trading (sold, handover in progress) or sold_out (sold). Populated whenever the provider has data for the entity.
titlestring
Listing title. Populated whenever the provider has data for the entity.
updatedUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the listing last changed. Japan only: null on US search rows.
urlstring
Canonical listing URL. Populated whenever the provider has data for the entity.

datadata

nextCursorstring
Opaque cursor for the next page, or null at the end. Pass it back as cursor with the same query and filters.

top level

foundboolean
True when the search returned at least one listing.
reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Tu ricevi. Campi con nome e tipo nella stessa struttura, qualunque fonte risponda.

FAQ

Sull'API Mercari Inserzioni vendute

L'API Mercari Inserzioni vendute di AnyAPI restituisce dati Mercari come JSON normalizzato da una sola chiamata POST a /v1/run/mercari.sold_listings. Search Mercari US or Japan sold listings by keyword with optional price-range, condition, category, brand, and sort filters, page by page; ideal for resale pricing research. The sold price is the final price after any accepted offer; it does not include buyer fees, and whether shipping is included depends on the listing's shipping terms. Rows carry no sale date: call mercari.product for soldUtc (US only). AnyAPI restituisce un unico schema normalizzato qualunque fonte la serva. Costa da 0,85 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile.

Costa da 0,85 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Ricarichi un portafoglio in USD e ogni chiamata lo scala. Alcune richieste fallite finanziate dal portafoglio comportano costi di elaborazione che trasferiamo al costo, senza ricarico; la risposta di errore mostra l'importo addebitato.

Search Mercari US or Japan sold listings by keyword with optional price-range, condition, category, brand, and sort filters, page by page; ideal for resale pricing research. The sold price is the final price after any accepted offer; it does not include buyer fees, and whether shipping is included depends on the listing's shipping terms. Rows carry no sale date: call mercari.product for soldUtc (US only). La risposta è JSON normalizzato con la stessa busta che restituisce ogni endpoint AnyAPI, quindi analizzare un secondo endpoint significa cambiare l'URL e nient'altro.

Sì. Un nuovo account AnyAPI parte con 0,10 USD di saldo gratuito e senza bisogno di carta, che copre 117 chiamate Mercari Inserzioni vendute a 0,00085 USD ciascuna.

Invia una richiesta POST a https://api.getanyapi.com/v1/run/mercari.sold_listings con la tua chiave AnyAPI in un header "Authorization: Bearer" e l'input come corpo JSON. La stessa chiave e lo stesso portafoglio funzionano su ogni endpoint AnyAPI.

No. Aggiungi dollari statunitensi a un unico saldo prepagato AnyAPI e ogni richiesta lo scala. Non c'è un piano mensile né un minimo, e lo stesso saldo paga ogni endpoint AnyAPI.

Sì. Installa @getanyapi/sdk da npm per TypeScript o getanyapi da pip per Python. Entrambi chiamano ogni endpoint AnyAPI con la stessa chiave, e funziona anche qualsiasi client HTTP.

Sì. Un agente può collegarsi al server MCP di AnyAPI su https://api.getanyapi.com/mcp, oppure creare da solo la propria chiave di prova gratuita con un POST non autenticato a https://api.getanyapi.com/agent/signup e chiamare questo endpoint via HTTP.

Altro da chiamare

Altri endpoint di Mercari

Prodottoda 0,85 USD /1k richieste Ricercada 0,85 USD /1k richieste

Mercari Inserzioni vendute API

Prezzi dell'API Mercari Inserzioni vendute

Ottieni Mercari Inserzioni vendute in una sola richiesta

Una richiesta, una sola forma di risposta.

Sull'API Mercari Inserzioni vendute

Quanto costa l'API Mercari Inserzioni vendute?

Cosa restituisce l'API Mercari Inserzioni vendute?

Posso provare gratis l'API Mercari Inserzioni vendute?

Come chiamo l'API Mercari Inserzioni vendute?

Mi serve un abbonamento per l'API Mercari Inserzioni vendute?

Esiste un SDK per l'API Mercari Inserzioni vendute?

Un agente IA può usare l'API Mercari Inserzioni vendute?

Altri endpoint di Mercari

Una chiave, un portafoglio e la tua prima chiamata a Mercari.

Una chiave, un portafoglio e
la tua prima chiamata a Mercari.