# Back Market Search API Documentation

<p><strong>Back Market Search API</strong> searches refurbished products by keyword and returns page 1 with numeric price and currency, original price, condition grade, rating, review count, full-size image, a numeric product_id and a UUID listing_public_id. Ids pass unchanged into the product and reviews routes. Search returns page 1 only. `count` is the number of rows returned. `total`, `total_pages` and `has_next_page` are null because the public page does not expose a reliable catalogue total.</p><p><strong>Credits:</strong> 1 credit per successful request. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/backmarket-api/backmarket_search](https://scrappa.co/docs/backmarket-api/backmarket_search)
- **API group:** Back Market API
- **Endpoint:** `GET https://scrappa.co/api/backmarket/search`

## 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 keyword, 2 to 100 characters. |

## Example response

```json
{
    "data": {
        "query": "iphone 13",
        "products": [
            {
                "grade": "Hervorragend",
                "price": {
                    "amount": 429,
                    "currency": "EUR"
                },
                "title": "Apple iPhone 13 128 Go Schwarz",
                "rating": 4.6,
                "image_url": "https://fr-mdm-prod.imgix.net/iphone.jpg",
                "price_new": {
                    "amount": 809,
                    "currency": "EUR"
                },
                "seller_id": "seller-42",
                "product_id": "624159",
                "review_count": 1240,
                "listing_public_id": "9f8e7d6c-1234-4abc-8def-0123456789ab"
            }
        ],
        "pagination": {
            "page": 1,
            "count": 1,
            "total": null,
            "per_page": 31,
            "total_pages": null,
            "has_next_page": null
        }
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. Not billable. |
| 503 | Upstream Unavailable | The upstream blocked the request or returned data that does not match. Not billable and retryable. |

## 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)
