# Mercari Item API Documentation

<p><strong>Mercari Item API Documentation</strong> Read one Mercari listing by id (for example m85764352496) or by its page url. The url also sets the market. The answer has title, description, price with currency, status, sold price, condition, brand, size, category, all photos in full size, likes, shipping (payer, carrier, ships from, fee), listing and update time and the seller with rating. The Japanese market adds the category path, colors, comments, attributes and the sold time. Mercari Shops listings are not supported. Listings are single items, so there is no stock per size. A listing that does not exist answers 404 and is not billed. Each successful request costs 1 credit. A failed request is never billed.</p>

- **Documentation:** [https://scrappa.co/docs/mercari-api/mercari_item](https://scrappa.co/docs/mercari-api/mercari_item)
- **API group:** Mercari API
- **Endpoint:** `GET https://scrappa.co/api/mercari/item`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | No | Listing id, for example m85764352496. Send id or url. |
| `url` | string | No | Listing page url on mercari.com/us or jp.mercari.com. The url also sets the market. |
| `market` | string | No | Marketplace: us (United States) or jp (Japan). Defaults to us. The two markets are separate: ids and filters differ. |

## Example response

```json
{
    "data": {
        "item": {
            "id": "m85764352496",
            "url": "https://www.mercari.com/us/item/m85764352496/",
            "size": {
                "id": 78,
                "name": "13 (46)"
            },
            "brand": {
                "id": 31861,
                "name": "Nike SB"
            },
            "likes": 7,
            "price": 250,
            "title": "Freddy Krueger SB Dunks",
            "market": "us",
            "photos": [
                "https://u-mercari-images.mercdn.net/photos/m85764352496_1.jpg?1793310628"
            ],
            "seller": {
                "id": 207052431,
                "name": "donburgundy01",
                "rating_count": 81
            },
            "status": "on_sale",
            "sold_at": null,
            "category": {
                "id": 399,
                "name": "Fashion sneakers"
            },
            "currency": "USD",
            "shipping": {
                "fee": 0,
                "payer": "buyer",
                "method": null,
                "carrier": "UPS Ground Saver",
                "package": "3 lb",
                "ships_from": {
                    "id": 19,
                    "name": "Louisiana"
                }
            },
            "condition": {
                "id": 1,
                "name": "New"
            },
            "listed_at": "2026-10-29T21:50:28Z",
            "thumbnail": "https://u-mercari-images.mercdn.net/photos/m85764352496_1.jpg?1793310628",
            "sold_price": null,
            "updated_at": "2026-10-29T21:50:28Z",
            "description": "Nike SB Dunk Low Premium Freddy Krueger. Size US 13",
            "total_price": 259,
            "original_price": null,
            "discount_percent": null
        }
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. Mercari is not called and the request is not billable. |
| 404 | Not Found | The listing was removed or is not public. This response is not billable. |
| 503 | Transport Unavailable | Mercari did not answer after several tries. Retry later. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)