Endpoint Playground

Try the The RealReal Condition Scale API

Returns The RealReal's full authentication condition-grading scale: the closed 6-tier set (Pristine, Excellent, Very Good, Good, Fair, As Is) it defines, each with an id (usable directly against search's condition_id) and live matching item count. This is reference data that changes rarely, so responses are cached.

What a live request returned

14 Oct 2026: 6 conditions; 3 fields had a value in every checked item.

Observed request: GET /therealreal/conditions
Fields with a value in every checked item: id, name, count

Sample value profiles: count: 3,906 to 116,357, median 19,219; name: “Pristine” and 5 other values.

Request: GET /therealreal/conditions
Cost: 2 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 0.19 s
Monitored request: GET /therealreal/conditions

The RealReal Condition Scale API documentation The RealReal platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/therealreal/conditions' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

No request parameters

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "conditions": [
      {
        "id": "18",
        "name": "Pristine",
        "count": 11840
      },
      {
        "id": "19",
        "name": "Excellent",
        "count": 73390
      },
      {
        "id": "20",
        "name": "Very Good",
        "count": 162975
      },
      {
        "id": "30560",
        "name": "Good",
        "count": 123448
      },
      {
        "id": "655545",
        "name": "Fair",
        "count": 27403
      },
      {
        "id": "2988045",
        "name": "As Is",
        "count": 5105
      }
    ],
    "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 category Browse The RealReal listings by curated collection Get The RealReal curated collection slugs 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

GETapiKey2 credits/requesttherealreal.conditionsResponseDocThe RealReal

GET /therealreal/conditions

Get The RealReal condition-grading value space

Response behavior

- This is reference data that changes rarely, so responses are cached for 24 hours — repeated calls within that window return the cached result rather than re-fetching from The RealReal. - The condition grades are, from best to worst: `Pristine`, `Excellent`, `Very Good`, `Good`, `Fair`, `As Is`.

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

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": {
    "conditions": [
      {
        "id": "18",
        "name": "Pristine",
        "count": 11840
      },
      {
        "id": "19",
        "name": "Excellent",
        "count": 73390
      },
      {
        "id": "20",
        "name": "Very Good",
        "count": 162975
      },
      {
        "id": "30560",
        "name": "Good",
        "count": 123448
      },
      {
        "id": "655545",
        "name": "Fair",
        "count": 27403
      },
      {
        "id": "2988045",
        "name": "As Is",
        "count": 5105
      }
    ],
    "source_url": "https://www.therealreal.com/shop/women/handbags"
  }
}

Endpoint Playground

Try the The RealReal Condition Scale API

What a live request returned

14 Oct 2026: 6 conditions; 3 fields had a value in every checked item.

Observed request: GET /therealreal/conditions
Fields with a value in every checked item: id, name, count

Sample value profiles: count: 3,906 to 116,357, median 19,219; name: “Pristine” and 5 other values.

Request: GET /therealreal/conditions
Cost: 2 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 0.19 s
Monitored request: GET /therealreal/conditions

The RealReal Condition Scale API documentation The RealReal platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/therealreal/conditions' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

No request parameters

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "conditions": [
      {
        "id": "18",
        "name": "Pristine",
        "count": 11840
      },
      {
        "id": "19",
        "name": "Excellent",
        "count": 73390
      },
      {
        "id": "20",
        "name": "Very Good",
        "count": 162975
      },
      {
        "id": "30560",
        "name": "Good",
        "count": 123448
      },
      {
        "id": "655545",
        "name": "Fair",
        "count": 27403
      },
      {
        "id": "2988045",
        "name": "As Is",
        "count": 5105
      }
    ],
    "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

GETapiKey2 credits/requesttherealreal.conditionsResponseDocThe RealReal

GET /therealreal/conditions

Get The RealReal condition-grading value space

Response behavior

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

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": {
    "conditions": [
      {
        "id": "18",
        "name": "Pristine",
        "count": 11840
      },
      {
        "id": "19",
        "name": "Excellent",
        "count": 73390
      },
      {
        "id": "20",
        "name": "Very Good",
        "count": 162975
      },
      {
        "id": "30560",
        "name": "Good",
        "count": 123448
      },
      {
        "id": "655545",
        "name": "Fair",
        "count": 27403
      },
      {
        "id": "2988045",
        "name": "As Is",
        "count": 5105
      }
    ],
    "source_url": "https://www.therealreal.com/shop/women/handbags"
  }
}