# Poshmark Suggestions API Documentation

<p><strong>Poshmark Suggestions API Documentation</strong> Get brand and keyword suggestions for a search text. Use it to find the exact brand spelling for the brand filter of the search endpoint. Each suggestion has the type, id, brand, keyword and image. Cost: 1 credit per request, only for successful requests.</p>

- **Documentation:** [https://scrappa.co/docs/poshmark-api/poshmark_suggestions](https://scrappa.co/docs/poshmark-api/poshmark_suggestions)
- **API group:** Poshmark API
- **Endpoint:** `GET https://scrappa.co/api/poshmark/suggestions`

## 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 | Search text of at least 2 characters, e.g. zar. |
| `country` | string | No | Poshmark site: us (poshmark.com, USD) or ca (poshmark.ca, CAD). Defaults to us. Australia and India closed in 2023. |

## Example response

```json
{
    "meta": {
        "billable": true,
        "endpoint_family": "suggestions"
    },
    "query": "zar",
    "country": "us",
    "success": true,
    "suggestions": [
        {
            "id": "53d96e555632a0280000045a",
            "type": "brand",
            "brand": "Zara",
            "keyword": "Zara",
            "image_url": "https://di2ponv0v5otw.cloudfront.net/brands/2025/12/18/53d96e555632a0280000045a/m_694475c0e2c7c2f44b27dbe1.png"
        },
        {
            "id": "6909a3602ab665df53924eb6",
            "type": "brand",
            "brand": "Zara Shahjahan",
            "keyword": "Zara Shahjahan",
            "image_url": "https://d2zlsagv0ouax1.cloudfront.net/assets/icon/img-icon-brands.png"
        },
        {
            "id": "578d40285632a012f40010c6",
            "type": "brand",
            "brand": "Zara Terez",
            "keyword": "Zara Terez",
            "image_url": "https://d2zlsagv0ouax1.cloudfront.net/assets/icon/img-icon-brands.png"
        }
    ]
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 502 | Upstream Unavailable | Poshmark could not be reached or answered with an unexpected shape. This response is not billable. |
| 504 | Upstream Timeout | Poshmark did not answer in time. 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)