Docs menu

Mercari API endpoint

Mercari master API

Returns Mercari's full reference taxonomy in one call: every category (with parent linkage), every recognized brand, and every clothing/shoe/apparel size. Large (tens of thousands of brand entries) and effectively static -- cache this response rather than polling it.

GETapiKey1 credit/requestMercarimercari.masterResponseDoc/mercari/master

Endpoint facts

Method: GET
API path: /mercari/master
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Mercari
Response schema: #/definitions/mercari.masterResponseDoc

Mercari Scraper API Try Mercari master API in Playground Mercari API documentation

How this endpoint behaves

Notable response behavior:

This is a large response — tens of thousands of brand entries. It is effectively static day to day; the endpoint is served with a 24-hour edge cache, so repeated calls do not re-fetch from Mercari each time.
categories is a flat list with parent_id linkage rather than a nested tree, matching the shape Mercari's own data uses. parent_id is omitted (zero) for a top-level category (e.g. "Women", "Men", "Home"); icon_url is only populated for top-level categories.
sizes is one flat list spanning all size-bearing categories — it is not scoped per-category. short_name and code are the two parts a size's name is composed from when both are present (e.g. name "XS (0-2)" = short_name "XS" + code "(0-2)"); either may be absent when Mercari's own data doesn't split them out.

Example response (truncated — the real response has ~3,000 categories, ~28,000 brands, and ~380 sizes):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "categories": [
      {
        "id": 1,
        "name": "Women",
        "icon_url": "https://u-mercari-images.mercdn.net/assets/img/home_categories/1.png"
      },
      {
        "id": 11,
        "name": "Dresses",
        "parent_id": 1
      }
    ],
    "brands": [
      { "id": 1, "name": "104+ Octane Boost" },
      { "id": 4, "name": "3.1 Phillip Lim" }
    ],
    "sizes": [
      { "id": 1, "name": "XXS (00)", "short_name": "XXS", "code": "(00)" },
      { "id": 2, "name": "XS (0-2)", "short_name": "XS", "code": "(0-2)" }
    ]
  }
}

Live monitoring

Monitored request: GET /mercari/master
Checks passed, 7 days to 14 Oct 2026: 99.8%
Median response time: 3.21 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /mercari/master
Items in brands: 28853
Fields filled in every checked item: 0
Fields empty in some or all items: 2

Field	Filled in, of 28853 checked	Values in the sample
id	500
name	500	“104+ Octane Boost” and 499 other values

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/mercari/master" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "categories": [
      {
        "id": 1,
        "name": "Women",
        "icon_url": "https://u-mercari-images.mercdn.net/assets/img/home_categories/1.png"
      },
      {
        "id": 11,
        "name": "Dresses",
        "parent_id": 1
      }
    ],
    "brands": [
      {
        "id": 1,
        "name": "104+ Octane Boost"
      },
      {
        "id": 4,
        "name": "3.1 Phillip Lim"
      }
    ],
    "sizes": [
      {
        "id": 1,
        "name": "XXS (00)",
        "short_name": "XXS",
        "code": "(00)"
      },
      {
        "id": 2,
        "name": "XS (0-2)",
        "short_name": "XS",
        "code": "(0-2)"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/mercari.masterResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	mercari.MasterResponse	No
data.brands	array	No
data.brands[].id	integer	No
data.brands[].name	string	No
data.categories	array	No
data.categories[].icon_url	string	No
data.categories[].id	integer	No
data.categories[].name	string	No
data.categories[].parent_id	integer	No
data.sizes	array	No
data.sizes[].code	string	No
data.sizes[].id	integer	No
data.sizes[].name	string	No
data.sizes[].short_name	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/mercari/master" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Mercari endpoint docs Mercari Scraper API Mercari search autocomplete API documentation Mercari home API documentation Mercari item API documentation Mercari search API documentation

Open in Playground Back to group

Docs menu

Mercari API endpoint

Mercari master API

GETapiKey1 credit/requestMercarimercari.masterResponseDoc/mercari/master

Endpoint facts

Method: GET
API path: /mercari/master
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Mercari
Response schema: #/definitions/mercari.masterResponseDoc

Mercari Scraper API Try Mercari master API in Playground Mercari API documentation

How this endpoint behaves

Notable response behavior:

This is a large response — tens of thousands of brand entries. It is effectively static day to day; the endpoint is served with a 24-hour edge cache, so repeated calls do not re-fetch from Mercari each time.
categories is a flat list with parent_id linkage rather than a nested tree, matching the shape Mercari's own data uses. parent_id is omitted (zero) for a top-level category (e.g. "Women", "Men", "Home"); icon_url is only populated for top-level categories.
sizes is one flat list spanning all size-bearing categories — it is not scoped per-category. short_name and code are the two parts a size's name is composed from when both are present (e.g. name "XS (0-2)" = short_name "XS" + code "(0-2)"); either may be absent when Mercari's own data doesn't split them out.

Example response (truncated — the real response has ~3,000 categories, ~28,000 brands, and ~380 sizes):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "categories": [
      {
        "id": 1,
        "name": "Women",
        "icon_url": "https://u-mercari-images.mercdn.net/assets/img/home_categories/1.png"
      },
      {
        "id": 11,
        "name": "Dresses",
        "parent_id": 1
      }
    ],
    "brands": [
      { "id": 1, "name": "104+ Octane Boost" },
      { "id": 4, "name": "3.1 Phillip Lim" }
    ],
    "sizes": [
      { "id": 1, "name": "XXS (00)", "short_name": "XXS", "code": "(00)" },
      { "id": 2, "name": "XS (0-2)", "short_name": "XS", "code": "(0-2)" }
    ]
  }
}

Live monitoring

Monitored request: GET /mercari/master
Checks passed, 7 days to 14 Oct 2026: 99.8%
Median response time: 3.21 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /mercari/master
Items in brands: 28853
Fields filled in every checked item: 0
Fields empty in some or all items: 2

Field	Filled in, of 28853 checked	Values in the sample
id	500
name	500	“104+ Octane Boost” and 499 other values

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/mercari/master" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "categories": [
      {
        "id": 1,
        "name": "Women",
        "icon_url": "https://u-mercari-images.mercdn.net/assets/img/home_categories/1.png"
      },
      {
        "id": 11,
        "name": "Dresses",
        "parent_id": 1
      }
    ],
    "brands": [
      {
        "id": 1,
        "name": "104+ Octane Boost"
      },
      {
        "id": 4,
        "name": "3.1 Phillip Lim"
      }
    ],
    "sizes": [
      {
        "id": 1,
        "name": "XXS (00)",
        "short_name": "XXS",
        "code": "(00)"
      },
      {
        "id": 2,
        "name": "XS (0-2)",
        "short_name": "XS",
        "code": "(0-2)"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/mercari.masterResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	mercari.MasterResponse	No
data.brands	array	No
data.brands[].id	integer	No
data.brands[].name	string	No
data.categories	array	No
data.categories[].icon_url	string	No
data.categories[].id	integer	No
data.categories[].name	string	No
data.categories[].parent_id	integer	No
data.sizes	array	No
data.sizes[].code	string	No
data.sizes[].id	integer	No
data.sizes[].name	string	No
data.sizes[].short_name	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/mercari/master" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Mercari endpoint docs Mercari Scraper API Mercari search autocomplete API documentation Mercari home API documentation Mercari item API documentation Mercari search API documentation

Open in Playground Back to group

Mercari master API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Mercari master API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related