Mercari API endpoint
Returns a Mercari item-detail page: description, all photos, price, condition, category, hashtags, the shipping origin state, and a "similar items" carousel of related listings.
/mercari/item/{id}Path parameters:
id (required) — the Mercari item id (e.g. m98337445585), as returned
by a search result's id field.Notable response behavior:
title is the item's description text up to its first line break —
Mercari's mobile API does not expose a separate, shorter title field at
this response's top level; description is the full text.condition_code and category_code are best-effort field labels,
recovered by decoding raw upstream responses rather than from a
published schema — treat them as directionally useful, not authoritative.similar_items is a list of related listings in the same shape as /mercari/search's items array (title, price, thumbnail, condition, seller). It is omitted (not an error) when Mercari's response doesn't include a similar-items carousel for that listing, and it never includes the requested item itself.404.id returns 400 before any upstream request is made.| Field | Filled in, of 50 checked | Values in the sample |
|---|---|---|
| id | 50 | |
| url | 50 | mercari.com |
| title | 50 | “Wilson SPS Nemesis Graphite Tennis Racquet” and 49 other values |
| thumbnail_url | 50 | u-mercari-images.mercdn.net |
| price_cents | 50 | 525 to 8,500, median 2,175 |
| num_likes | 50 | 17 to 1,984, median 236 |
| seller_id | 50 | |
| created_at_unix | 50 | 2022-07-09 to 2026-10-12 |
| updated_at_unix | 20 | 2026-05-08 to 2026-06-03 |
| condition_code | 32 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | Mercari item id, e.g. from a search result's id field | m98337445585 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/mercari/item/m98337445585" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"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
}
]
}
}Request schema
No body schema
Response schema
#/definitions/mercari.ItemDetailResponse
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| category_code | integer | No | ||||
| condition_code | integer | No | ||||
| description | string | No | ||||
| hashtags | array | No | ||||
| id | string | No | ||||
| photos | array | No | ||||
| price_cents | integer | No | ||||
| shipping_from_state | string | No | ||||
| similar_items | array | No | ||||
| similar_items[].condition_code | integer | No | ||||
| similar_items[].created_at_unix | integer | No | ||||
| similar_items[].id | string | No | ||||
| similar_items[].num_likes | integer | No | ||||
| similar_items[].original_price_cents | integer | No | ||||
| similar_items[].price_cents | integer | No | ||||
| similar_items[].seller_id | string | No | ||||
| similar_items[].thumbnail_url | string | No | ||||
| similar_items[].title | string | No | ||||
| similar_items[].updated_at_unix | integer | No | ||||
| similar_items[].url | string | No | ||||
| title | string | No | ||||
| url | string | No |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/mercari/item/m98337445585" \
-H "x-api-key: $CRAWLORA_API_KEY"