# reBuy Suggest API Documentation

<p>Search public reBuy suggestions by query. Returns six products with per-condition buy prices, sell-to-us prices, ratings, identifiers, a product url and full size image URLs. Prices are numbers in EUR. The upstream ignores page, so this route has no page parameter. Use the search route for paging. One credit per successful request. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/rebuy-api/rebuy_suggest](https://scrappa.co/docs/rebuy-api/rebuy_suggest)
- **API group:** reBuy API
- **Endpoint:** `GET https://scrappa.co/api/rebuy/suggest`

## 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 words, e.g. iphone 13 |

## Example response

```json
{
    "data": {
        "query": "iphone 13",
        "total": 6,
        "products": [
            {
                "id": 12216196,
                "url": "https://www.rebuy.de/i,12216196",
                "price": {
                    "amount": 429,
                    "currency": "EUR"
                },
                "title": "Apple iPhone 13"
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "suggest"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A missing query or an unsupported parameter was sent. Failed requests are not billed. |
| 503 | Upstream Unavailable | The source is temporarily unreachable. Failed requests are not billed. |

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