# Reichelt Search ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/reichelt/search` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 1 credit per call | | **Documentation** | https://www.piloterr.com/library/reichelt-search | ## Description Search reichelt.de by keyword or category. Euro prices are rebuilt from the number, including whole-euro amounts. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/reichelt/search' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### 1N4148W diode on Reichelt ```json { "results": [ { "url": "https://www.reichelt.de/de/de/shop/produkt/kleinsignal-schalt-diode_100_v_300_ma_sod-123-332913", "brand": "HOTTECH SEMICONDUCTOR", "price": 0.02, "title": "Kleinsignal-Schalt-Diode, 100 V, 300 mA, SOD-123", "currency": "EUR", "in_stock": false, "image_url": "https://cdn-reichelt.de/resize/130%2F-/web/artikel_ws/A400%2FSOD-123-HOTTECH.jpg?type=Product&resize=130%252F-&", "attributes": [ { "name": "Typ", "value": "Gleichrichterdiode" }, { "name": "Ausführung", "value": "Switching" }, { "name": "URRM", "value": "100 V" }, { "name": "Montageart", "value": "SMD" }, { "name": "Bauform", "value": "SOD-123" }, { "name": "IF(AV)", "value": "0,3 A" }, { "name": "IFSM", "value": "2 A" }, { "name": "Temperaturbereich", "value": "-55..+150 °C" } ], "product_id": "332913", "price_display": "0,02 €", "article_number": "1N4148W HOT" } ], "pagination": { "next": null, "page": 1, "per_page": 8, "total_pages": 1, "total_results": 8 } } ``` ## Documentation ## Overview Search reichelt elektronik. The crawler reads the article cards on the German shop. `query` is a keyword, a search link, or a category link. `page` starts at 1. On the shop, page 2 is the query parameter `PAGE=1`. ## Quickstart ``` GET https://api.piloterr.com/v2/reichelt/search?query=1n4148 ``` ``` GET https://api.piloterr.com/v2/reichelt/search?query=buchse&page=2 ``` ``` GET https://api.piloterr.com/v2/reichelt/search?query=https://www.reichelt.de/de/de/shop/kategorie/arduino/einplatinen-mikrocontroller-8243 ``` ## Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `query` | string | yes | A word such as `1n4148`, or a reichelt.de search or category link. A product link returns 400. | | `page` | integer | no | Page number from 1. | | `return_page_source` | boolean | no | When true, the response is the raw HTML in `result`. | ## Response fields `price` is the numeric euro amount from the page. `price_display` is rebuilt from that number, so a whole euro printed as `14,- €` comes back as `14,00 €`. `article_number` is the Reichelt order code. `attributes` lists the short specs on the card. `pagination.next` is null on the last page. `total_results` is set when the page says how many Treffer it found. ## Use cases - Look up a diode or microcontroller by part number - Page through a large component search - Collect brand, price, and stock for a category ## Error codes | Code | Meaning | |---|---| | 400 | Empty query, another website, or a product link | | 404 | The page had no article cards | | 500 | The fetch failed |