# Ricardo Listing Detail API Documentation

<p><strong>Ricardo Listing Detail API Documentation</strong> Retrieve one Ricardo.ch listing: title, web url, offer type, status (open or closed), condition label, start and end date (ISO 8601, UTC), buy-now price, current bid, minimum next bid and bid increment for auctions, bid count, available quantity, description as HTML and plain text, images (largest size), category breadcrumb, shipping options, payment methods, attributes and the seller with rating in percent. All prices are CHF numbers. Ended auctions return status closed with the final bid. An unknown listing id answers a non-billable 404.</p>

- **Documentation:** [https://scrappa.co/docs/ricardo-api/ricardo_listing](https://scrappa.co/docs/ricardo-api/ricardo_listing)
- **API group:** Ricardo API
- **Endpoint:** `GET https://scrappa.co/api/ricardo/listing`

## 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 |
| --- | --- | --- | --- |
| `id` | string | Yes | Ricardo listing number of 6 to 12 digits, e.g. 1320000000. Take it from the id field of a search result. |
| `language` | string | No | Language of labels and the listing url: de or fr. Defaults to de. |

## Example response

```json
{
    "data": {
        "id": "1320000000",
        "url": "https://www.ricardo.ch/de/a/1320000000/",
        "title": "IWC Porsche Design Titanium, Vintage,automatic",
        "images": [
            {
                "url": "https://img.ricardostatic.ch/images/765c8f11-91d2-4f89-842d-476bcd062786/t_1800x1350"
            },
            {
                "url": "https://img.ricardostatic.ch/images/39005c87-4126-4a84-9aa5-3d76a9231cea/t_1800x1350"
            },
            {
                "url": "https://img.ricardostatic.ch/images/dc4784d8-2755-4d5e-8acb-45b133974cf7/t_1800x1350"
            }
        ],
        "seller": {
            "id": "408769950",
            "city": "Grand-Lancy",
            "country": "CH",
            "nickname": "Montre-Swiss",
            "zip_code": "1212",
            "rating_percent": 99.4,
            "profile_picture_url": "https://img.ricardostatic.ch/images/6bbad529-49c0-4c4f-8061-3c29d262b2ef/t_250"
        },
        "status": "closed",
        "currency": "CHF",
        "end_date": "2026-07-27T10:58:47Z",
        "attributes": [
            {
                "name": "Gespartes CO\u2082e",
                "values": [
                    "9 kg"
                ]
            },
            {
                "name": "Material",
                "values": [
                    "Titanium"
                ]
            },
            {
                "name": "Farbe",
                "values": [
                    "Andere"
                ]
            }
        ],
        "bids_count": 1,
        "categories": [
            {
                "name": "Uhren & Schmuck",
                "category_id": "42272"
            },
            {
                "name": "Uhren",
                "category_id": "81990"
            }
        ],
        "offer_type": "auction_with_buynow",
        "start_date": "2026-07-27T10:42:00Z",
        "current_bid": 420,
        "bid_increment": 1,
        "buy_now_price": 420,
        "condition_label": "Gebraucht",
        "payment_methods": [
            "cash",
            "bank"
        ],
        "description_html": "<p>IWC Porsche Design, une montre automatique d&#39;occasion en titane pour homme. Un classique intemporel! Cette montre combine l&#39;\u00e9l\u00e9gance et la robustesse. Parfaite pour un usage quotidien ou pour les collectionneurs. Son design distinctif ne manquera pas d&#39;attirer l&#39;attention. movement authentic top cualite.. fonction parfaitement.. magnifique cadran noir..avec date rapide.. bracelet neuf,anti allergies..</p><p>boucle d&#39;origine iwc Porsche Design..</p><p>en bonne \u00e9tat g\u00e9n\u00e9ral voir photo..</p><p>vondu avec un bo\u00eete neuf pour protection..</p><p>Une opportunit\u00e9 \u00e0 ne pas manquer!</p>",
        "description_text": "IWC Porsche Design, une montre automatique d'occasion en titane pour homme. Un classique intemporel! Cette montre combine l'\u00e9l\u00e9gance et la robustesse. Parfaite pour un usage quotidien ou pour les collectionneurs. Son design distinctif ne manquera pas d'attirer l'attention. movement authentic top cualite.. fonction parfaitement.. magnifique cadran noir..avec date rapide.. bracelet neuf,anti allergies..\nboucle d'origine iwc Porsche Design..\nen bonne \u00e9tat g\u00e9n\u00e9ral voir photo..\nvondu avec un bo\u00eete neuf pour protection..\nUne opportunit\u00e9 \u00e0 ne pas manquer!",
        "shipping_options": [
            {
                "method": "get_by_buyer",
                "pickup": true
            },
            {
                "cost": 6.7,
                "method": "letter_a_b5_500g_5cm"
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "listing"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The id is missing or not a listing number of 6 to 12 digits. This response is not billable. |
| 404 | Resource Not Found | The listing does not exist. This response is not billable. |
| 503 | Invalid Source Response | Ricardo answered with a response Scrappa could not read. This response is not billable. |
| 503 | Service Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

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