Endpoint Playground

Try the The RealReal category browse API

Returns a page of The RealReal listings browsed by category (taxon) permalink path, e.g. women/handbags. Pass a previous response's next_after back as after to fetch the next page.

What a live request returned

14 Oct 2026: 120 listings; 13 fields had a value in every checked item.

Observed request: GET /therealreal/category?path=women%2Fhandbags
Fields with a value in every checked item: id, name, sku, designer, condition, color, gender, price_usd

Sample value profiles: condition: Very Good (58), Good (31), Excellent (18) and 2 more; price_usd: 95 to 8,895, median 775; name: “Zucca FF Vintage Brown Handle Bag” and 100 other values.

Request: GET /therealreal/category
Cost: 4 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 99.8%, median 3.25 s
Monitored request: GET /therealreal/category?path=women%2Fhandbags

The RealReal category browse API documentation The RealReal platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/therealreal/category?path=women%2Fhandbags' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
path	string	Yes	women/handbags	Category permalink path, from the categories endpoint's permalink field
on_sale	boolean	No		Only return items currently marked down from their original price
available	boolean	No		Only return items currently available to purchase (excludes sold and waitlisted items)
after	string	No		Opaque pagination cursor from a previous response's next_after. Omit for the first page

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "total": 225361,
    "has_more": true,
    "next_after": "YXJyYXljb25uZWN0aW9uOjExOQ==",
    "listings": [
      {
        "id": "54388578",
        "name": "Denim Pearl Crush Wallet On Chain",
        "designer": "Chanel",
        "condition": "Very Good",
        "price_usd": 3800,
        "available": true,
        "url": "https://www.therealreal.com/products/women/handbags/crossbody-bags/chanel-denim-pearl-crush-wallet-on-chain-wdqhu"
      }
    ],
    "source_url": "https://www.therealreal.com/shop/women/handbags"
  }
}

More The RealReal endpoints

Get The RealReal search-box suggestions Get The RealReal category browse taxonomy Browse The RealReal listings by curated collection Get The RealReal curated collection slugs Get The RealReal condition-grading value space Browse The RealReal listings by designer Get The RealReal designer directory Get a The RealReal listing detail Search The RealReal luxury consignment listings Get The RealReal similar-item recommendations

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey4 credits/requesttherealreal.searchResponseDocThe RealReal

GET /therealreal/category

Browse The RealReal listings by category

Returns a page of The RealReal listings browsed by category (taxon) permalink path, e.g. women/handbags. Pass a previous response's next_after back as after to fetch the next page.

Response behavior

- Response shape matches [search](therealreal-search.md): `total`, `has_more`, `next_after`, `listings`. - An unrecognized `path` returns `404`.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

path

requiredstring

Category permalink path, from the categories endpoint's permalink field

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "total": 225361,
    "has_more": true,
    "next_after": "YXJyYXljb25uZWN0aW9uOjExOQ==",
    "listings": [
      {
        "id": "54388578",
        "name": "Denim Pearl Crush Wallet On Chain",
        "designer": "Chanel",
        "condition": "Very Good",
        "price_usd": 3800,
        "available": true,
        "url": "https://www.therealreal.com/products/women/handbags/crossbody-bags/chanel-denim-pearl-crush-wallet-on-chain-wdqhu"
      }
    ],
    "source_url": "https://www.therealreal.com/shop/women/handbags"
  }
}

Endpoint Playground

Try the The RealReal category browse API

Returns a page of The RealReal listings browsed by category (taxon) permalink path, e.g. women/handbags. Pass a previous response's next_after back as after to fetch the next page.

What a live request returned

14 Oct 2026: 120 listings; 13 fields had a value in every checked item.

Observed request: GET /therealreal/category?path=women%2Fhandbags
Fields with a value in every checked item: id, name, sku, designer, condition, color, gender, price_usd

Sample value profiles: condition: Very Good (58), Good (31), Excellent (18) and 2 more; price_usd: 95 to 8,895, median 775; name: “Zucca FF Vintage Brown Handle Bag” and 100 other values.

Request: GET /therealreal/category
Cost: 4 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 99.8%, median 3.25 s
Monitored request: GET /therealreal/category?path=women%2Fhandbags

The RealReal category browse API documentation The RealReal platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/therealreal/category?path=women%2Fhandbags' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
path	string	Yes	women/handbags	Category permalink path, from the categories endpoint's permalink field
on_sale	boolean	No		Only return items currently marked down from their original price
available	boolean	No		Only return items currently available to purchase (excludes sold and waitlisted items)
after	string	No		Opaque pagination cursor from a previous response's next_after. Omit for the first page

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "total": 225361,
    "has_more": true,
    "next_after": "YXJyYXljb25uZWN0aW9uOjExOQ==",
    "listings": [
      {
        "id": "54388578",
        "name": "Denim Pearl Crush Wallet On Chain",
        "designer": "Chanel",
        "condition": "Very Good",
        "price_usd": 3800,
        "available": true,
        "url": "https://www.therealreal.com/products/women/handbags/crossbody-bags/chanel-denim-pearl-crush-wallet-on-chain-wdqhu"
      }
    ],
    "source_url": "https://www.therealreal.com/shop/women/handbags"
  }
}

More The RealReal endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey4 credits/requesttherealreal.searchResponseDocThe RealReal

GET /therealreal/category

Browse The RealReal listings by category

Returns a page of The RealReal listings browsed by category (taxon) permalink path, e.g. women/handbags. Pass a previous response's next_after back as after to fetch the next page.

Response behavior

- Response shape matches [search](therealreal-search.md): `total`, `has_more`, `next_after`, `listings`. - An unrecognized `path` returns `404`.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

path

requiredstring

Category permalink path, from the categories endpoint's permalink field

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "total": 225361,
    "has_more": true,
    "next_after": "YXJyYXljb25uZWN0aW9uOjExOQ==",
    "listings": [
      {
        "id": "54388578",
        "name": "Denim Pearl Crush Wallet On Chain",
        "designer": "Chanel",
        "condition": "Very Good",
        "price_usd": 3800,
        "available": true,
        "url": "https://www.therealreal.com/products/women/handbags/crossbody-bags/chanel-denim-pearl-crush-wallet-on-chain-wdqhu"
      }
    ],
    "source_url": "https://www.therealreal.com/shop/women/handbags"
  }
}