# Grailed Designer Lookup API Documentation

<p><strong>Grailed Designer Lookup API Documentation</strong> Find designers on Grailed by name. Each designer has the id, name, slug, number of listings, departments, logo and collaboration names. Use the name exactly as returned in the designer filter of the search endpoint. Cost: 1 credit per request, only for successful requests.

- **Documentation:** [https://scrappa.co/docs/grailed-api/grailed_designers](https://scrappa.co/docs/grailed-api/grailed_designers)
- **API group:** Grailed API
- **Endpoint:** `GET https://scrappa.co/api/grailed/designers`

## 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 |
| --- | --- | --- | --- |
| `query` | string | Yes | Designer name or part of it, e.g. undercover. |
| `limit` | integer | No | Number of designers, 1 to 20. Default 10. |

## Example response

```json
{
    "meta": {
        "billable": true,
        "endpoint_family": "designers"
    },
    "query": "undercover",
    "success": true,
    "designers": [
        {
            "id": 10,
            "name": "Undercover",
            "slug": "undercover",
            "logo_url": "https://media-assets.grailed.com/prd/detail-page/a1e40611eef4443aae108a84acb4ae4c",
            "departments": [
                "menswear",
                "womenswear"
            ],
            "collaborations": [
                "Supreme x Undercover",
                "Uniqlo x Undercover",
                "Supreme x Undercover x Public Enemy",
                "Nike x Undercover",
                "GU x Undercover",
                "Off-White x Undercover",
                "Undercover x Hysteric Glamour",
                "The North Face x Undercover",
                "Nike x Sacai x Undercover",
                "Eastpak x Undercover",
                "Converse x Undercover",
                "Valentino x Undercover",
                "Vans x Undercover",
                "Comme des Garcons x Undercover",
                "New Era x Undercover",
                "Nonnative x Undercover",
                "Levi's x Undercover",
                "Undercover x Girls Don't Cry",
                "Undercover x Number (N)ine",
                "Undercover x Jack Purcell",
                "Medicom Toy x Undercover",
                "Human Made x Undercover",
                "Undercover x A.F.F.A.",
                "Undercover x Vandalize",
                "Undercover x Visvim",
                "Porter x Undercover",
                "Undercover x Disney",
                "Undercover x Neighborhood x Fragment Design",
                "Adieu Paris x Undercover",
                "Undercover x United Arrows",
                "Clarks x Undercover",
                "Dr. Martens x Undercover",
                "Dr. Martens x Supreme x Undercover",
                "Bape x Undercover",
                "Carhartt Wip x Undercover",
                "Takahiromiyashita The Soloist. x Undercover",
                "Undercover x Kaws",
                "Undercover x Fragment Design",
                "Undercover x Wtaps",
                "Undercover x KIJIMA TAKAYUKI"
            ],
            "listings_count": 40483
        },
        {
            "id": 32559,
            "name": "John Undercover",
            "slug": "john-undercover",
            "logo_url": null,
            "departments": [
                "menswear",
                "womenswear"
            ],
            "collaborations": [],
            "listings_count": 421
        }
    ]
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 503 | Upstream Unavailable | Grailed could not be reached or answered with an unexpected shape. 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)