# Depop Newest Listings API Documentation

<p><strong>Depop Newest Listings API Documentation</strong> Search the Depop marketplace and get the newest listings first. The order is the upstream listing time, given in created_at; Scrappa does not sort the rows itself. The row shape is slightly smaller than in the search endpoint: price breakdown, picture sizes, location, size and seller id. Page with the cursor from data.pagination.next_cursor. Repeated rows inside a page are removed. A search with no hits is a successful, billable response with an empty list. The data is public Depop data and the endpoint is read only. A failed request is never billed.</p>

- **Documentation:** [https://scrappa.co/docs/depop-api/depop_search_newest](https://scrappa.co/docs/depop-api/depop_search_newest)
- **API group:** Depop API
- **Endpoint:** `GET https://scrappa.co/api/depop/search/newest`

## 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 keywords, for example jacket. |
| `country` | string | No | Depop market code, two letters, lowercase. List the codes with /api/depop/markets. Defaults to us. |
| `limit` | integer | No | Listings per page, 1 to 100. Defaults to 24. |
| `cursor` | string | No | Opaque cursor from data.pagination.next_cursor of the previous page. |

## Example response

```json
{
    "data": {
        "sort": "newest",
        "items": [
            {
                "id": 962272183,
                "url": "https://www.depop.com/products/_pas2lives-black-leather-trench-coat-with-8014/",
                "slug": "_pas2lives-black-leather-trench-coat-with-8014",
                "brand": {
                    "id": 1667
                },
                "status": "S",
                "country": "US",
                "is_sold": false,
                "location": "Perth Amboy, United States",
                "seller_id": 15456663,
                "description": "Black leather trench coat with belt\n\n\nMaterial: Leather\n\nMeasurements: Medium\n\nCondition : Excellent \n\n\n\n\n #leather #...",
                "category_ids": [
                    13
                ],
                "active_status": "active"
            },
            {
                "id": 962272126,
                "url": "https://www.depop.com/products/piecdbypiecedtx-90s-marithe-francois-girbaud-navy-8d49/",
                "slug": "piecdbypiecedtx-90s-marithe-francois-girbaud-navy-8d49",
                "brand": {
                    "id": 650
                },
                "status": "S",
                "country": "US",
                "is_sold": false,
                "location": "Lucas, United States",
                "seller_id": 20451428,
                "description": "90s Marithe Francois Girbaud navy blue denim jacket\n-size XXL Men\u2019s \n28.5 pit to pit \n31 length \n-good condition no h...",
                "category_ids": [
                    5
                ],
                "active_status": "active"
            }
        ],
        "query": "jacket",
        "country": "us",
        "pagination": {
            "has_more": true,
            "next_cursor": "cHJvZHVjdHxNbncxZkRFM09USTBORE0zT0RBfGJvb3N0ZWR8fHJlbGF0aXZlT2Zmc2V0c3w1fDV8MHwwfDE"
        },
        "order_basis": "upstream_listing_time"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "search_newest"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. Depop is not called and the request is not billable. |
| 503 | Upstream Unavailable | Depop did not answer after several tries. 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)
