{ "openapi": "3.0.0", "components": { "examples": {}, "headers": {}, "parameters": {}, "requestBodies": {}, "responses": {}, "schemas": { "ApiSuccessResponse": { "properties": { "statusCode": { "type": "number", "format": "double", "description": "HTTP status code" }, "messageCode": { "type": "string", "description": "Status message code" }, "data": { "description": "Response data" } }, "required": [ "statusCode", "messageCode", "data" ], "type": "object", "additionalProperties": false }, "ApiErrorResponse": { "properties": { "statusCode": { "type": "number", "format": "double", "description": "HTTP status code" }, "messageCode": { "type": "string", "description": "Status message code" }, "message": { "type": "string", "description": "Error message" } }, "required": [ "statusCode", "messageCode", "message" ], "type": "object", "additionalProperties": false }, "ProductDetailsRequest": { "description": "Request body for fetching product details by URL", "properties": { "url": { "type": "string", "description": "Full URL of the product on Ricardo website", "example": "https://www.ricardo.ch/de/a/moncler-jacke-montgenerve-groesse-2-1310444514/" } }, "required": [ "url" ], "type": "object", "additionalProperties": false }, "ProductListRequest": { "description": "Request body for fetching product list by URL", "properties": { "url": { "type": "string", "description": "Full URL of the product list on Ricardo website", "example": "https://www.ricardo.ch/de/c/herren-jacken-41016/" } }, "required": [ "url" ], "type": "object", "additionalProperties": false }, "SearchProductQuery": { "description": "Query parameters for searching productes", "properties": { "keyword": { "type": "string", "description": "Search keyword\n\nThe search keyword to find products (e.g., \"jacket\", \"watch\", \"smartphone\").", "example": "jacket" }, "language": { "type": "string", "description": "The language parameter:\n\n- \"de\" - German (DE)\n- \"fr\" - French (FR)\n- \"it\" - Italian (IT)", "example": "us" }, "condition": { "type": "string", "description": "The condition parameter:\n\n- \"\" - Any condition\n- \"new_see_description\" - New as described\n- \"new_original_package\" - New & in original packaging\n- \"used\" - Used\n- \"defekt\" - Defect\n- \"antik\" - Antique", "example": "1" }, "type_of_offer": { "type": "string", "description": "The type_of_offer parameter:\n\n- \"\" - All\n- \"auction\" - Auction\n- \"fixed_price\" - Buy now", "example": "1" }, "delivery": { "type": "string", "description": "The delivery parameter:\n\n- \"\" - All\n- \"shipping_cost\" - Delivery costs included\n- \"free\" - Free Shipping\n- \"pickup_by_buyer\" - Collection (pickup by buyer)", "example": "1" }, "sort_by": { "type": "string", "description": "The sort_by parameter:\n\n- \"\" - Relevance\n- \"close_to_end\" - Newest (auctions ending soon)\n- \"newest\" - Novelty (newest listings)\n- \"best\" - Lowest price\n- \"most_expensive\" - Highest price\n- \"most_bids\" - Most bids", "example": "1" }, "page": { "type": "integer", "format": "int32", "description": "Page number for pagination (starts from 1)", "example": 1, "minimum": 1 } }, "required": [ "keyword" ], "type": "object", "additionalProperties": false } }, "securitySchemes": {} }, "info": { "title": "Ricardo API", "version": "1.0.0" }, "paths": { "/scrapers/api/ricardo/product/get-by-url": { "post": { "operationId": "Get Product details by url", "responses": { "200": { "description": "Successfully retrieved product details", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiSuccessResponse" }, "examples": { "Example 1": { "value": { "statusCode": 200, "messageCode": "OK", "data": [ { "id": "1298940834", "url": "https://www.ricardo.ch/de/a/echte-lederjacke-biker-style-1298940834/", "offer": { "availability_key": "in_stock", "city": "Stans", "end_date": "2025-10-20T09:36:00Z", "initial_quantity": 1, "offer_id": "1298940834", "offer_type": "auction_with_buynow", "payment_method_keys": [], "price": 49, "remaining_quantity": 0, "remaining_time": -3130, "start_date": "2025-10-13T10:36:00Z", "zip_code": "6370", "price_offer": { "seller_allows_price_offers": false, "can_receive_price_offers": false, "minimum_price": null }, "seller_consent_date": "2025-10-13T21:47:14.12Z" }, "description": { "locale": "de", "html": "

Biker/Fashion echt leder Jacke zum Freundschaftspreis

Guter Zustand, leichte gebrauchsspuren in der Innentasche ansonsten alles TipTop.

Hersteller grösse L aber würde die Jacke eher als M einstufen da sie eher eng geschnitten ist.

Neupreis lag bei 350.- (Zalando)

Abholung in Luzern / Stans wäre auch möglich.

" }, "images": [ { "url": "https://img.ricardostatic.ch/images/b2283b2d-5c5a-457d-b0aa-cda81b102e62/t_1000x750/echte-lederjacke-biker-style", "preview_url": "https://img.ricardostatic.ch/images/b2283b2d-5c5a-457d-b0aa-cda81b102e62/t_100x75/echte-lederjacke-biker-style", "big_size_url": "https://img.ricardostatic.ch/images/b2283b2d-5c5a-457d-b0aa-cda81b102e62/t_1800x1350/echte-lederjacke-biker-style", "max_size": 32767 }, { "url": "https://img.ricardostatic.ch/images/273c453a-e6fe-4065-b016-aa12091ac3a1/t_1000x750/echte-lederjacke-biker-style", "preview_url": "https://img.ricardostatic.ch/images/273c453a-e6fe-4065-b016-aa12091ac3a1/t_100x75/echte-lederjacke-biker-style", "big_size_url": "https://img.ricardostatic.ch/images/273c453a-e6fe-4065-b016-aa12091ac3a1/t_1800x1350/echte-lederjacke-biker-style", "max_size": 32767 }, { "url": "https://img.ricardostatic.ch/images/6d285661-1830-4316-8ad4-ef739f07d042/t_1000x750/echte-lederjacke-biker-style", "preview_url": "https://img.ricardostatic.ch/images/6d285661-1830-4316-8ad4-ef739f07d042/t_100x75/echte-lederjacke-biker-style", "big_size_url": "https://img.ricardostatic.ch/images/6d285661-1830-4316-8ad4-ef739f07d042/t_1800x1350/echte-lederjacke-biker-style", "max_size": 32767 }, { "url": "https://img.ricardostatic.ch/images/6d73d944-f176-4818-b1f7-1c08becdc474/t_1000x750/echte-lederjacke-biker-style", "preview_url": "https://img.ricardostatic.ch/images/6d73d944-f176-4818-b1f7-1c08becdc474/t_100x75/echte-lederjacke-biker-style", "big_size_url": "https://img.ricardostatic.ch/images/6d73d944-f176-4818-b1f7-1c08becdc474/t_1800x1350/echte-lederjacke-biker-style", "max_size": 32767 }, { "url": "https://img.ricardostatic.ch/images/6256dda4-ee7d-4bc6-ae38-9e036aca3260/t_1000x750/echte-lederjacke-biker-style", "preview_url": "https://img.ricardostatic.ch/images/6256dda4-ee7d-4bc6-ae38-9e036aca3260/t_100x75/echte-lederjacke-biker-style", "big_size_url": "https://img.ricardostatic.ch/images/6256dda4-ee7d-4bc6-ae38-9e036aca3260/t_1800x1350/echte-lederjacke-biker-style", "max_size": 32767 }, { "url": "https://img.ricardostatic.ch/images/5b0bef5f-29e6-44e7-ad07-4fe93bc6dcbf/t_1000x750/echte-lederjacke-biker-style", "preview_url": "https://img.ricardostatic.ch/images/5b0bef5f-29e6-44e7-ad07-4fe93bc6dcbf/t_100x75/echte-lederjacke-biker-style", "big_size_url": "https://img.ricardostatic.ch/images/5b0bef5f-29e6-44e7-ad07-4fe93bc6dcbf/t_1800x1350/echte-lederjacke-biker-style", "max_size": 32767 }, { "url": "https://img.ricardostatic.ch/images/8f15066f-6a22-437c-81ab-3bf7b2640b04/t_1000x750/echte-lederjacke-biker-style", "preview_url": "https://img.ricardostatic.ch/images/8f15066f-6a22-437c-81ab-3bf7b2640b04/t_100x75/echte-lederjacke-biker-style", "big_size_url": "https://img.ricardostatic.ch/images/8f15066f-6a22-437c-81ab-3bf7b2640b04/t_1800x1350/echte-lederjacke-biker-style", "max_size": 32767 } ], "status": "CLOSED", "is_legacy_article": false, "delivery_options": [ { "id": "parcel_b_10kg", "price": 1150, "is_cumulative_shipping": false } ], "attributes": [ { "label": "Farbe", "key": "color", "values": [ { "label": "Schwarz", "value": 10001007, "group": "color" } ] }, { "label": "Geschlecht und Altersgruppe", "key": "gender", "values": [ { "label": "Herren", "value": 10002001, "group": "gender" } ] }, { "label": "Gespartes CO₂", "key": "co2_savings", "values": [ { "label": "74 kg" } ] }, { "label": "Grösse", "key": "jacket_size", "values": [ { "label": "L", "value": 2367, "group": "size" } ] }, { "label": "Hauptmaterial", "key": "jacket_material", "values": [ { "label": "Leder", "value": 10003027, "group": "material" } ] }, { "label": "Jackentyp", "key": "jacket_type", "values": [ { "label": "Übergangsjacke", "value": 4907, "group": "jacket_type" } ] }, { "label": "Stofftyp", "key": "cloth_fabric_type", "values": [ { "label": "Uni", "value": 300000017643, "group": "cloth_fabric_type" } ] } ], "category_id": "41016", "condition_key": "acceptable", "user_id": "407457441", "title": "Echte Lederjacke Biker Style", "product_type": { "key": "jacket", "insert_id": "", "product_type_source": "LISTING_FORM", "product_type_selection_source": "classifier-product-types", "validated": true, "attributes": [ { "id": 10001, "validated": true, "key": "color", "name": "Farbe", "group": "color", "data_type": "enum", "multi_select": true, "localized_values": true, "computed": false, "value_sort": "count", "status": "PUBLISHED", "values": [ { "id": 10001007, "name": "Schwarz", "is_other_value": false, "group": "color", "status": "PUBLISHED", "active": false } ] }, { "id": 10002, "validated": true, "key": "gender", "name": "Geschlecht und Altersgruppe", "group": "gender", "data_type": "enum", "multi_select": true, "localized_values": true, "computed": false, "value_sort": "count", "status": "PUBLISHED", "values": [ { "id": 10002001, "name": "Herren", "is_other_value": false, "group": "gender", "status": "PUBLISHED", "active": false } ] }, { "id": 300000018, "validated": true, "key": "cloth_fabric_type", "name": "Stofftyp", "group": "cloth_fabric_type", "data_type": "enum", "multi_select": true, "localized_values": true, "computed": false, "value_sort": "alphabetical", "status": "PUBLISHED", "values": [ { "id": 300000017643, "name": "Uni", "is_other_value": false, "group": "cloth_fabric_type", "status": "PUBLISHED", "active": false } ] }, { "id": 30164, "validated": true, "key": "jacket_material", "name": "Hauptmaterial", "group": "material", "data_type": "enum", "multi_select": true, "localized_values": true, "computed": false, "value_sort": "count", "status": "PUBLISHED", "values": [ { "id": 10003027, "name": "Leder", "is_other_value": false, "group": "material", "status": "PUBLISHED", "active": false } ] }, { "id": 30245, "validated": true, "unit": "kg", "key": "co2_savings", "name": "Gespartes CO₂", "group": "co2_savings", "data_type": "numeric", "multi_select": true, "localized_values": false, "computed": true, "status": "PUBLISHED", "values": [ { "id": 74, "name": "", "is_other_value": false, "group": "", "status": "PUBLISHED", "active": false } ] }, { "id": 30572, "validated": true, "key": "jacket_type", "name": "Jackentyp", "group": "jacket_type", "data_type": "enum", "multi_select": true, "localized_values": true, "computed": false, "value_sort": "alphabetical", "status": "PUBLISHED", "values": [ { "id": 4907, "name": "Übergangsjacke", "is_other_value": false, "group": "jacket_type", "status": "PUBLISHED", "active": false } ] }, { "id": 10046, "validated": true, "key": "jacket_size", "name": "Grösse", "group": "size", "data_type": "enum", "multi_select": true, "localized_values": true, "computed": false, "value_sort": "count", "status": "PUBLISHED", "values": [ { "id": 2367, "name": "L", "is_other_value": false, "group": "size", "status": "PUBLISHED", "active": false } ] } ] }, "seller": { "account_type": "private", "addresses": [ { "area_code": "NW", "city": "Stans", "zip_code": "6370" } ], "article_count": 3, "avatar_src": null, "country": "CH", "id": "407457441", "identification": { "id_document": { "status": "not_verified" }, "phone_number": { "status": "not_verified" }, "postal_address": { "status": "verified", "verified_at": "2017-11-28T00:00:00Z" } }, "is_pro": false, "nickname": "Fabdc", "open_offers": [ { "id": "1300678114", "title": "Retro Gaming PC GTX 1070", "has_buy_now": true, "has_auction": false, "end_date": "2026-01-11T11:53:00Z", "image": "https://img.ricardostatic.ch/images/f6a599fd-6c78-4f79-a8b6-d5a5da1e7452/t_265x200/retro-gaming-pc-gtx-1070", "buy_now_price": 195, "bid_price": null, "bids_count": 0, "category_id": 39289, "is_promo": false, "condition_key": "acceptable", "is_money_guard": false, "start_date": "2025-10-13T10:56:00Z", "creation_date": "2025-10-13T10:56:00Z", "seller_id": "407457441", "shipping": [ { "key": "get_by_buyer", "cost": 0, "zip_code": "6370", "city": "Stans" } ], "brand": "Asus", "co2_savings": "241.0 kg", "product_type_key": "pc", "can_make_an_offer": true, "highlights": [] }, { "id": "1300675318", "title": "Thonet Freischwinger mit Netz- / Textilbespannung", "has_buy_now": true, "has_auction": false, "end_date": "2025-11-10T11:10:00Z", "image": "https://img.ricardostatic.ch/images/e48deb4f-29df-4e58-81cc-2dbc52812325/t_265x200/thonet-freischwinger-mit-netz-textilbespannung", "buy_now_price": 500, "bid_price": null, "bids_count": 0, "category_id": 82161, "is_promo": false, "condition_key": "acceptable", "is_money_guard": false, "start_date": "2025-10-13T10:12:00Z", "creation_date": "2025-10-13T10:12:00Z", "seller_id": "407457441", "shipping": [ { "key": "get_by_buyer", "cost": 0, "zip_code": "6370", "city": "Stans" } ], "brand": "Thonet", "co2_savings": "47.0 kg", "product_type_key": "chair", "can_make_an_offer": true, "highlights": [] }, { "id": "1286133276", "title": "Dan Henry 1962 Chromograph 39mm Panda", "has_buy_now": true, "has_auction": false, "end_date": "2025-11-16T11:23:00Z", "image": "https://img.ricardostatic.ch/images/56b7cc5b-a2eb-4b11-8605-d3eabe9a5e89/t_265x200/dan-henry-1962-chromograph-39mm-panda", "buy_now_price": 220, "bid_price": null, "bids_count": 0, "category_id": 81990, "is_promo": false, "condition_key": "acceptable", "is_money_guard": true, "start_date": "2025-08-18T10:24:00Z", "creation_date": "2025-04-10T20:53:00Z", "seller_id": "407457441", "shipping": [ { "key": "get_by_buyer", "cost": 0, "zip_code": "6370", "city": "Stans" }, { "key": "parcel_b_2kg", "cost": 8.5, "zip_code": "6370", "city": "Stans" } ], "co2_savings": "11.0 kg", "product_type_key": "watch", "can_make_an_offer": true, "highlights": [] } ], "ratings_count": 27, "score": 1 }, "show_bank_transfer": true, "root_categories": [ { "id": "82435", "name": "Angebote der Saison", "display_name": "Angebote der Saison", "slug": "angebote-der-saison-82435", "url": "https://www.ricardo.ch/de/c/angebote-der-saison-82435/", "landing_page_type": "STANDARD", "children": [] }, { "id": "38399", "name": "Antiquitäten & Kunst", "display_name": "Antiquitäten & Kunst", "slug": "antiquitaeten-kunst-38399", "url": "https://www.ricardo.ch/de/c/antiquitaeten-kunst-38399/", "landing_page_type": "STANDARD", "children": [] }, { "id": "63787", "name": "Audio, TV & Video", "display_name": "Audio, TV & Video", "slug": "audio-tv-video-63787", "url": "https://www.ricardo.ch/de/c/audio-tv-video-63787/", "landing_page_type": "STANDARD", "children": [] }, { "id": "38766", "name": "Briefmarken", "display_name": "Briefmarken", "slug": "briefmarken-38766", "url": "https://www.ricardo.ch/de/c/briefmarken-38766/", "landing_page_type": "STANDARD", "children": [] }, { "id": "38889", "name": "Bücher & Comics", "display_name": "Bücher & Comics", "slug": "buecher-comics-38889", "url": "https://www.ricardo.ch/de/c/buecher-comics-38889/", "landing_page_type": "STANDARD", "children": [] }, { "id": "63788", "name": "Büro & Gewerbe", "display_name": "Büro & Gewerbe", "slug": "buero-gewerbe-63788", "url": "https://www.ricardo.ch/de/c/buero-gewerbe-63788/", "landing_page_type": "STANDARD", "children": [] }, { "id": "39091", "name": "Computer & Netzwerk", "display_name": "Computer & Netzwerk", "slug": "computer-netzwerk-39091", "url": "https://www.ricardo.ch/de/c/computer-netzwerk-39091/", "landing_page_type": "STANDARD", "children": [] }, { "id": "69956", "name": "Fahrzeuge", "display_name": "Fahrzeuge", "slug": "fahrzeuge-69956", "url": "https://www.ricardo.ch/de/c/fahrzeuge-69956/", "landing_page_type": "STANDARD", "children": [] }, { "id": "69989", "name": "Fahrzeugzubehör", "display_name": "Fahrzeugzubehör", "slug": "fahrzeugzubehoer-69989", "url": "https://www.ricardo.ch/de/c/fahrzeugzubehoer-69989/", "landing_page_type": "STANDARD", "children": [] }, { "id": "81382", "name": "Filme & Serien", "display_name": "Filme & Serien", "slug": "filme-serien-81382", "url": "https://www.ricardo.ch/de/c/filme-serien-81382/", "landing_page_type": "STANDARD", "children": [] }, { "id": "39460", "name": "Foto & Optik", "display_name": "Foto & Optik", "slug": "foto-optik-39460", "url": "https://www.ricardo.ch/de/c/foto-optik-39460/", "landing_page_type": "STANDARD", "children": [] }, { "id": "39563", "name": "Games & Spielkonsolen", "display_name": "Games & Spielkonsolen", "slug": "games-spielkonsolen-39563", "url": "https://www.ricardo.ch/de/c/games-spielkonsolen-39563/", "landing_page_type": "STANDARD", "children": [] }, { "id": "39825", "name": "Handwerk & Garten", "display_name": "Handwerk & Garten", "slug": "handwerk-garten-39825", "url": "https://www.ricardo.ch/de/c/handwerk-garten-39825/", "landing_page_type": "STANDARD", "children": [] }, { "id": "39940", "name": "Handy, Festnetz, Funk", "display_name": "Handy, Festnetz, Funk", "slug": "handy-festnetz-funk-39940", "url": "https://www.ricardo.ch/de/c/handy-festnetz-funk-39940/", "landing_page_type": "STANDARD", "children": [] }, { "id": "40295", "name": "Haushalt & Wohnen", "display_name": "Haushalt & Wohnen", "slug": "haushalt-wohnen-40295", "url": "https://www.ricardo.ch/de/c/haushalt-wohnen-40295/", "landing_page_type": "STANDARD", "children": [] }, { "id": "40520", "name": "Kind & Baby", "display_name": "Kind & Baby", "slug": "kind-baby-40520", "url": "https://www.ricardo.ch/de/c/kind-baby-40520/", "landing_page_type": "STANDARD", "children": [] }, { "id": "40748", "name": "Kleidung & Accessoires", "display_name": "Kleidung & Accessoires", "slug": "kleidung-accessoires-40748", "url": "https://www.ricardo.ch/de/c/kleidung-accessoires-40748/", "landing_page_type": "FASHION", "children": [] }, { "id": "41057", "name": "Kosmetik & Pflege", "display_name": "Kosmetik & Pflege", "slug": "kosmetik-pflege-41057", "url": "https://www.ricardo.ch/de/c/kosmetik-pflege-41057/", "landing_page_type": "STANDARD", "children": [] }, { "id": "41126", "name": "Modellbau & Hobby", "display_name": "Modellbau & Hobby", "slug": "modellbau-hobby-41126", "url": "https://www.ricardo.ch/de/c/modellbau-hobby-41126/", "landing_page_type": "STANDARD", "children": [] }, { "id": "63781", "name": "Musik & Musikinstrumente", "display_name": "Musik & Musikinstrumente", "slug": "musik-musikinstrumente-63781", "url": "https://www.ricardo.ch/de/c/musik-musikinstrumente-63781/", "landing_page_type": "STANDARD", "children": [] }, { "id": "41260", "name": "Münzen", "display_name": "Münzen", "slug": "waehrung-41260", "url": "https://www.ricardo.ch/de/c/waehrung-41260/", "landing_page_type": "STANDARD", "children": [] }, { "id": "41518", "name": "Sammeln & Seltenes", "display_name": "Sammeln & Seltenes", "slug": "sammeln-seltenes-41518", "url": "https://www.ricardo.ch/de/c/sammeln-seltenes-41518/", "landing_page_type": "STANDARD", "children": [] }, { "id": "41733", "name": "Spielzeug & Basteln", "display_name": "Spielzeug & Basteln", "slug": "spielzeug-basteln-41733", "url": "https://www.ricardo.ch/de/c/spielzeug-basteln-41733/", "landing_page_type": "STANDARD", "children": [] }, { "id": "41875", "name": "Sport", "display_name": "Sport", "slug": "sports-41875", "url": "https://www.ricardo.ch/de/c/sports-41875/", "landing_page_type": "STANDARD", "children": [] }, { "id": "42099", "name": "Tickets & Gutscheine", "display_name": "Tickets & Gutscheine", "slug": "tickets-gutscheine-42099", "url": "https://www.ricardo.ch/de/c/tickets-gutscheine-42099/", "landing_page_type": "STANDARD", "children": [] }, { "id": "42135", "name": "Tierzubehör", "display_name": "Tierzubehör", "slug": "tierzubehoer-42135", "url": "https://www.ricardo.ch/de/c/tierzubehoer-42135/", "landing_page_type": "STANDARD", "children": [] }, { "id": "42272", "name": "Uhren & Schmuck", "display_name": "Uhren & Schmuck", "slug": "uhren-schmuck-42272", "url": "https://www.ricardo.ch/de/c/uhren-schmuck-42272/", "landing_page_type": "STANDARD", "children": [] }, { "id": "42454", "name": "Wein & Genuss", "display_name": "Wein & Genuss", "slug": "wein-genuss-42454", "url": "https://www.ricardo.ch/de/c/wein-genuss-42454/", "landing_page_type": "STANDARD", "children": [] } ], "category": { "id": "41016", "name": "Jacken", "display_name": "Jacken", "slug": "herren-jacken-41016", "url": "https://www.ricardo.ch/de/c/herren-jacken-41016/", "landing_page_type": "NONE", "parent": { "id": "40800", "name": "Herrenmode", "display_name": "Herrenmode", "slug": "herrenmode-40800", "url": "https://www.ricardo.ch/de/c/herrenmode-40800/", "landing_page_type": "FASHION_CLOTHES", "parent": { "id": "40748", "name": "Kleidung & Accessoires", "display_name": "Kleidung & Accessoires", "slug": "kleidung-accessoires-40748", "url": "https://www.ricardo.ch/de/c/kleidung-accessoires-40748/", "landing_page_type": "FASHION", "children": [ { "id": "40749", "name": "Accessoires für Damen", "display_name": "Accessoires für Damen", "slug": "accessoires-fuer-damen-40749", "url": "https://www.ricardo.ch/de/c/accessoires-fuer-damen-40749/", "landing_page_type": "NONE", "children": [] }, { "id": "40982", "name": "Accessoires für Herren", "display_name": "Accessoires für Herren", "slug": "modische-accessoires-fuer-herren-40982", "url": "https://www.ricardo.ch/de/c/modische-accessoires-fuer-herren-40982/", "landing_page_type": "NONE", "children": [] }, { "id": "40843", "name": "Damenmode", "display_name": "Damenmode", "slug": "damenmode-40843", "url": "https://www.ricardo.ch/de/c/damenmode-40843/", "landing_page_type": "FASHION_CLOTHES", "children": [] }, { "id": "40943", "name": "Damenschuhe", "display_name": "Damenschuhe", "slug": "damenschuhe-40943", "url": "https://www.ricardo.ch/de/c/damenschuhe-40943/", "landing_page_type": "NONE", "children": [] }, { "id": "68310", "name": "Fasnachtskostüme & Themenpartys", "display_name": "Fasnachtskostüme & Themenpartys", "slug": "fasnachtskostueme-themenpartys-68310", "url": "https://www.ricardo.ch/de/c/fasnachtskostueme-themenpartys-68310/", "landing_page_type": "NONE", "children": [] }, { "id": "40800", "name": "Herrenmode", "display_name": "Herrenmode", "slug": "herrenmode-40800", "url": "https://www.ricardo.ch/de/c/herrenmode-40800/", "landing_page_type": "FASHION_CLOTHES", "children": [] }, { "id": "40822", "name": "Herrenschuhe", "display_name": "Herrenschuhe", "slug": "herrenschuhe-40822", "url": "https://www.ricardo.ch/de/c/herrenschuhe-40822/", "landing_page_type": "NONE", "children": [] }, { "id": "40836", "name": "Hochzeit", "display_name": "Hochzeit", "slug": "hochzeit-hochzeitsdeko-zubehoer-40836", "url": "https://www.ricardo.ch/de/c/hochzeit-hochzeitsdeko-zubehoer-40836/", "landing_page_type": "NONE", "children": [] }, { "id": "63790", "name": "Reisekoffer & -taschen", "display_name": "Reisekoffer & -taschen", "slug": "koffer-und-trolley-63790", "url": "https://www.ricardo.ch/de/c/koffer-und-trolley-63790/", "landing_page_type": "NONE", "children": [] }, { "id": "40842", "name": "Sonstige Kleidung & Accessoires", "display_name": "Sonstige Kleidung & Accessoires", "slug": "kleidung-accessoires-40842", "url": "https://www.ricardo.ch/de/c/kleidung-accessoires-40842/", "landing_page_type": "NONE", "children": [] }, { "id": "40975", "name": "Taschen für Damen", "display_name": "Taschen für Damen", "slug": "taschen-fuer-damen-40975", "url": "https://www.ricardo.ch/de/c/taschen-fuer-damen-40975/", "landing_page_type": "NONE", "children": [] }, { "id": "40839", "name": "Trachtenmode", "display_name": "Trachtenmode", "slug": "trachtenmode-40839", "url": "https://www.ricardo.ch/de/c/trachtenmode-40839/", "landing_page_type": "NONE", "children": [] } ] }, "children": [ { "id": "40995", "name": "Anzüge", "display_name": "Anzüge", "slug": "herren-anzug-40995", "url": "https://www.ricardo.ch/de/c/herren-anzug-40995/", "landing_page_type": "NONE", "children": [] }, { "id": "41041", "name": "Badehosen", "display_name": "Badehosen", "slug": "badehosen-41041", "url": "https://www.ricardo.ch/de/c/badehosen-41041/", "landing_page_type": "NONE", "children": [] }, { "id": "74393", "name": "Berufskleidung", "display_name": "Berufskleidung", "slug": "berufskleidung-fuer-maenner-74393", "url": "https://www.ricardo.ch/de/c/berufskleidung-fuer-maenner-74393/", "landing_page_type": "NONE", "children": [] }, { "id": "49379", "name": "Gilets & Westen", "display_name": "Gilets & Westen", "slug": "herren-gilets-westen-49379", "url": "https://www.ricardo.ch/de/c/herren-gilets-westen-49379/", "landing_page_type": "NONE", "children": [] }, { "id": "41000", "name": "Hemden", "display_name": "Hemden", "slug": "herren-hemden-41000", "url": "https://www.ricardo.ch/de/c/herren-hemden-41000/", "landing_page_type": "NONE", "children": [] }, { "id": "41005", "name": "Hosen", "display_name": "Hosen", "slug": "herren-hosen-41005", "url": "https://www.ricardo.ch/de/c/herren-hosen-41005/", "landing_page_type": "NONE", "children": [] }, { "id": "41016", "name": "Jacken", "display_name": "Jacken", "slug": "herren-jacken-41016", "url": "https://www.ricardo.ch/de/c/herren-jacken-41016/", "landing_page_type": "NONE", "children": [] }, { "id": "43910", "name": "Jeans", "display_name": "Jeans", "slug": "jeans-43910", "url": "https://www.ricardo.ch/de/c/jeans-43910/", "landing_page_type": "NONE", "children": [] }, { "id": "82308", "name": "Jumpsuits", "display_name": "Jumpsuits", "slug": "jumpsuits-82308", "url": "https://www.ricardo.ch/de/c/jumpsuits-82308/", "landing_page_type": "NONE", "children": [] }, { "id": "75408", "name": "Kleiderpakete", "display_name": "Kleiderpakete", "slug": "kleiderpakete-75408", "url": "https://www.ricardo.ch/de/c/kleiderpakete-75408/", "landing_page_type": "NONE", "children": [] }, { "id": "41021", "name": "Mäntel", "display_name": "Mäntel", "slug": "herrenmantel-41021", "url": "https://www.ricardo.ch/de/c/herrenmantel-41021/", "landing_page_type": "NONE", "children": [] }, { "id": "41026", "name": "Pullover & Sweatshirts", "display_name": "Pullover & Sweatshirts", "slug": "pullover-sweatshirt-fuer-maenner-41026", "url": "https://www.ricardo.ch/de/c/pullover-sweatshirt-fuer-maenner-41026/", "landing_page_type": "NONE", "children": [] }, { "id": "77863", "name": "Pyjamas", "display_name": "Pyjamas", "slug": "herren-pyjamas-77863", "url": "https://www.ricardo.ch/de/c/herren-pyjamas-77863/", "landing_page_type": "NONE", "children": [] }, { "id": "41036", "name": "Socken", "display_name": "Socken", "slug": "herrensocken-41036", "url": "https://www.ricardo.ch/de/c/herrensocken-41036/", "landing_page_type": "NONE", "children": [] }, { "id": "40817", "name": "Sonstige Herrenmode", "display_name": "Sonstige Herrenmode", "slug": "sonstige-herrenkleidung-40817", "url": "https://www.ricardo.ch/de/c/sonstige-herrenkleidung-40817/", "landing_page_type": "NONE", "children": [] }, { "id": "40801", "name": "Sportbekleidung", "display_name": "Sportbekleidung", "slug": "sportbekleidung-fuer-herren-40801", "url": "https://www.ricardo.ch/de/c/sportbekleidung-fuer-herren-40801/", "landing_page_type": "NONE", "children": [] }, { "id": "82311", "name": "T-Shirts & Polo-Shirts", "display_name": "T-Shirts & Polo-Shirts", "slug": "t-shirts-polo-shirts-82311", "url": "https://www.ricardo.ch/de/c/t-shirts-polo-shirts-82311/", "landing_page_type": "NONE", "children": [] }, { "id": "40812", "name": "Unterwäsche", "display_name": "Unterwäsche", "slug": "herren-unterwaesche-40812", "url": "https://www.ricardo.ch/de/c/herren-unterwaesche-40812/", "landing_page_type": "NONE", "children": [] } ] }, "children": [] }, "can_translate": false, "deliveries_and_associated_payment_methods": [ { "delivery_method": { "id": "parcel_b_10kg", "price": 1150, "is_cumulative_shipping": false }, "payment_methods": [ { "method": "bank_transfer", "type": "not_secured" }, { "method": "twint", "type": "secured" }, { "method": "credit_card", "type": "secured" } ], "has_secured_payment_method": true } ], "is_auction_mg_eligible": true, "is_price_offer_mg_eligible": true, "is_buy_now_mg_eligible": true, "money_guard_max_price": 500000, "seo_meta": { "title": "Echte Lederjacke Biker Style | Kaufen auf Ricardo", "meta_robots": "index, follow, max-image-preview:large", "alternate_urls": [ { "locale": "de", "alternate_url": "https://www.ricardo.ch/de/a/echte-lederjacke-biker-style-1298940834/" }, { "locale": "fr", "alternate_url": "https://www.ricardo.ch/fr/a/echte-lederjacke-biker-style-1298940834/" }, { "locale": "it", "alternate_url": "https://www.ricardo.ch/it/a/echte-lederjacke-biker-style-1298940834/" } ], "meta_description": "Startpreis: CHF 49 | Zustand: Gebraucht | Echte Lederjacke Biker Style in Stans online kaufen auf Ricardo | Biker/Fashion echt leder Jacke zum Freundschaftspreis Guter Zustand, leichte gebrauchsspure…" }, "bid_price": 49, "last_bid_price": 4900, "similar_articles_urls": [ "https://www.ricardo.ch/de/a/veste-matelassee-aigle-avec-capuchon-1300686788/", "https://www.ricardo.ch/de/a/jack-jones-kunstlederjacke-groesse-l-1286733214/", "https://www.ricardo.ch/de/a/lederjacke-schwarz-1216921472/", "https://www.ricardo.ch/de/a/veste-homme-'perfecto'-en-cuir-veritable-noir-1292526636/", "https://www.ricardo.ch/de/a/sams%C3%B8e-sams%C3%B8e-lederjacke-unisex-1295076670/", "https://www.ricardo.ch/de/a/giacca-in-pelle-nera-kikkallegra-1279173922/", "https://www.ricardo.ch/de/a/selected-homme-lederjacke-groesse-l-top-zustand-1300949100/", "https://www.ricardo.ch/de/a/herrenjacke-bershka-kunstleder-schwarz-gr-l-1299010872/", "https://www.ricardo.ch/de/a/wunderschoene-lederjacke-1299548530/", "https://www.ricardo.ch/de/a/jack-and-jones-lederjacke-1257695854/", "https://www.ricardo.ch/de/a/kunstlederjacke-mango-1300966662/", "https://www.ricardo.ch/de/a/kunstlederjacke-gr-s-1300464056/", "https://www.ricardo.ch/de/a/zara-lederjacke-1293769242/", "https://www.ricardo.ch/de/a/coole-kunstlederjacke-von-mango-groesse-l-schwarz!-1300478890/", "https://www.ricardo.ch/de/a/lederjacke-1283646548/", "https://www.ricardo.ch/de/a/manor-lederjacke-schwarz-groesse-m-fabrikneu!-1298336802/", "https://www.ricardo.ch/de/a/lederjacke-kiomi-schwarz-xxl-1287025436/", "https://www.ricardo.ch/de/a/vintage-lederjacke-1269579174/", "https://www.ricardo.ch/de/a/leather-jacket-1294484978/", "https://www.ricardo.ch/de/a/quadro-lederjacke-groesse-52-1294475754/", "https://www.ricardo.ch/de/a/h-m-veste-cuir-perfecto-1225688756/", "https://www.ricardo.ch/de/a/lederjacke-mango-1301181914/", "https://www.ricardo.ch/de/a/boggi-milano-moto-lederjacke-coffe-racer-style-m-1300850746/", "https://www.ricardo.ch/de/a/lederjacke-schwarz-echtleder-slim-fit-bikerjacke-1300236876/", "https://www.ricardo.ch/de/a/lederjacke-bikerjacke-esprit-gr-36-1240229424/", "https://www.ricardo.ch/de/a/echtleder-biker-jacke-leder-1297850026/", "https://www.ricardo.ch/de/a/kunstleder-jacke-von-amisu-gr-40-1267051260/", "https://www.ricardo.ch/de/a/lederjacke-barneys-original-groesse-42-originalpreis-275%C2%A3-1243160182/", "https://www.ricardo.ch/de/a/mango-lederjacke-gr-xl-schwarz-1300777730/", "https://www.ricardo.ch/de/a/lederjacke-1300718784/" ] } ] } } } } } }, "400": { "description": "Bad Request - Invalid URL format", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponse" } } } }, "404": { "description": "Not Found - Product not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponse" }, "examples": { "Example 1": { "value": { "statusCode": 500, "messageCode": "INTERNAL_SERVER_ERROR", "message": "Failed to run robot" } } } } } } }, "description": "Get detailed product information by URL", "summary": "Get detailed product information", "tags": [ "Product" ], "security": [], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductDetailsRequest" } } } } } }, "/scrapers/api/ricardo/product/listing-by-url": { "post": { "operationId": "Get Product list by url", "responses": { "200": { "description": "Successfully retrieved product information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiSuccessResponse" }, "examples": { "Example 1": { "value": { "statusCode": 200, "messageCode": "OK", "data": [ { "id": "1276561598", "title": "Snowboardjacke", "has_buy_now": true, "has_auction": false, "end_date": "2025-11-16T13:40:00Z", "image": "https://img.ricardostatic.ch/images/38d7433b-c884-4ac5-8399-182dee9e860c/t_450/snowboardjacke", "buy_now_price": 279, "bid_price": null, "bids_count": 0, "category_id": 41016, "is_promo": true, "promo_option": "bronze", "condition_key": "like_new", "is_money_guard": false, "start_date": "2025-08-18T12:41:00Z", "creation_date": "2024-12-16T07:05:00Z", "seller_id": "410679293", "shipping": [ { "key": "get_by_buyer", "cost": 0, "zip_code": "3627", "city": "Heimberg" } ], "brand": "Volcom", "size": "L", "product_type_key": "jacket", "can_make_an_offer": true, "highlights": [], "highlight": "boost", "from_url": "https://www.ricardo.ch/de/c/herren-jacken-41016" } ] } } } } } }, "400": { "description": "Bad Request - Invalid URL format", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponse" } } } }, "404": { "description": "Not Found - Product not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponse" }, "examples": { "Example 1": { "value": { "statusCode": 500, "messageCode": "INTERNAL_SERVER_ERROR", "message": "Failed to run robot" } } } } } } }, "description": "Get list of basic product information by URL\n\nRetrieves essential product data.\nUse this endpoint for faster queries when full details are not needed.", "summary": "Get list basic product information", "tags": [ "Product" ], "security": [], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductListRequest" } } } } } }, "/scrapers/api/ricardo/product/search": { "get": { "operationId": "Search Products", "responses": { "200": { "description": "Successfully retrieved search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiSuccessResponse" }, "examples": { "Example 1": { "value": { "statusCode": 200, "messageCode": "OK", "data": [ { "id": "1276561598", "title": "Snowboardjacke", "has_buy_now": true, "has_auction": false, "end_date": "2025-11-16T13:40:00Z", "image": "https://img.ricardostatic.ch/images/38d7433b-c884-4ac5-8399-182dee9e860c/t_450/snowboardjacke", "buy_now_price": 279, "bid_price": null, "bids_count": 0, "category_id": 41016, "is_promo": true, "promo_option": "bronze", "condition_key": "like_new", "is_money_guard": false, "start_date": "2025-08-18T12:41:00Z", "creation_date": "2024-12-16T07:05:00Z", "seller_id": "410679293", "shipping": [ { "key": "get_by_buyer", "cost": 0, "zip_code": "3627", "city": "Heimberg" } ], "brand": "Volcom", "size": "L", "product_type_key": "jacket", "can_make_an_offer": true, "highlights": [], "highlight": "boost", "from_url": "https://www.ricardo.ch/de/c/herren-jacken-41016" } ] } } } } } }, "400": { "description": "Bad Request - Invalid search parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponse" }, "examples": { "Example 1": { "value": { "statusCode": 500, "messageCode": "INTERNAL_SERVER_ERROR", "message": "Failed to run robot" } } } } } } }, "description": "Search for products\n\nSearch products in the Ricardo database using keyword and optional filters.\nSupports pagination for large result sets.", "summary": "Search productes with filters", "tags": [ "Product" ], "security": [], "parameters": [ { "description": "Search keyword\n\nThe search keyword to find products (e.g., \"jacket\", \"watch\", \"smartphone\").", "in": "query", "name": "keyword", "required": true, "schema": { "type": "string" }, "example": "jacket" }, { "description": "The language parameter:\n\n- \"de\" - German (DE)\n- \"fr\" - French (FR)\n- \"it\" - Italian (IT)", "in": "query", "name": "language", "required": false, "schema": { "type": "string" }, "example": "us" }, { "description": "The condition parameter:\n\n- \"\" - Any condition\n- \"new_see_description\" - New as described\n- \"new_original_package\" - New & in original packaging\n- \"used\" - Used\n- \"defekt\" - Defect\n- \"antik\" - Antique", "in": "query", "name": "condition", "required": false, "schema": { "type": "string" }, "example": "1" }, { "description": "The type_of_offer parameter:\n\n- \"\" - All\n- \"auction\" - Auction\n- \"fixed_price\" - Buy now", "in": "query", "name": "type_of_offer", "required": false, "schema": { "type": "string" }, "example": "1" }, { "description": "The delivery parameter:\n\n- \"\" - All\n- \"shipping_cost\" - Delivery costs included\n- \"free\" - Free Shipping\n- \"pickup_by_buyer\" - Collection (pickup by buyer)", "in": "query", "name": "delivery", "required": false, "schema": { "type": "string" }, "example": "1" }, { "description": "The sort_by parameter:\n\n- \"\" - Relevance\n- \"close_to_end\" - Newest (auctions ending soon)\n- \"newest\" - Novelty (newest listings)\n- \"best\" - Lowest price\n- \"most_expensive\" - Highest price\n- \"most_bids\" - Most bids", "in": "query", "name": "sort_by", "required": false, "schema": { "type": "string" }, "example": "1" }, { "description": "Page number for pagination (starts from 1)", "in": "query", "name": "page", "required": false, "schema": { "format": "int32", "type": "integer", "minimum": 1 }, "example": 1 } ] } } }, "servers": [ { "url": "/undefined" } ] }