# Pneusonline Search ## Overview | Property | Value | |----------|-------| | **Status** | private | | **Method** | `GET` | | **Endpoint** | `/v2/pneusonline/search` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 1 credit per call | | **Documentation** | https://www.piloterr.com/library/pneusonline-search | ## Description Search the Pneusonline catalog by tire size or brand and get real-time prices, stock status, and EU ratings for the French market. ## 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/pneusonline/search' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Search 205/55 R16 Michelin ```json { "results": [ { "url": "https://www.pneusonline.fr/pneu-ete/michelin-pilot-sport-5/205-55-r16", "name": "Michelin Pilot Sport 5 205/55 R16 91V", "size": "205/55 R16", "brand": "Michelin", "price": 112.9, "width": 205, "rating": 4.7, "season": "summer", "currency": "EUR", "diameter": 16, "wet_grip": "A", "load_index": 91, "product_id": "pno-mich-ps5-20555r16-91v", "sale_price": 99.5, "noise_level": 69, "speed_index": "V", "aspect_ratio": 55, "availability": "in_stock", "review_count": 284, "thumbnail_url": "https://cdn.pneusonline.fr/images/products/michelin-pilot-sport-5-205-55-r16-thumb.jpg", "fuel_efficiency": "A" }, { "url": "https://www.pneusonline.fr/pneu-ete/michelin-primacy-4-plus/205-55-r16", "name": "Michelin Primacy 4+ 205/55 R16 91V", "size": "205/55 R16", "brand": "Michelin", "price": 105.4, "width": 205, "rating": 4.6, "season": "summer", "currency": "EUR", "diameter": 16, "wet_grip": "A", "load_index": 91, "product_id": "pno-mich-prim4-20555r16-91v", "sale_price": 105.4, "noise_level": 68, "speed_index": "V", "aspect_ratio": 55, "availability": "in_stock", "review_count": 421, "thumbnail_url": "https://cdn.pneusonline.fr/images/products/michelin-primacy-4-plus-205-55-r16-thumb.jpg", "fuel_efficiency": "A" }, { "url": "https://www.pneusonline.fr/pneu-ete/michelin-e-primacy/205-55-r16", "name": "Michelin e.Primacy 205/55 R16 91H", "size": "205/55 R16", "brand": "Michelin", "price": 98.2, "width": 205, "rating": 4.5, "season": "summer", "currency": "EUR", "diameter": 16, "wet_grip": "B", "load_index": 91, "product_id": "pno-mich-ecop-20555r16-91v", "sale_price": 90, "noise_level": 67, "speed_index": "H", "aspect_ratio": 55, "availability": "in_stock", "review_count": 188, "thumbnail_url": "https://cdn.pneusonline.fr/images/products/michelin-e-primacy-205-55-r16-thumb.jpg", "fuel_efficiency": "A" } ], "pagination": { "total_pages": 4, "current_page": 1, "has_next_page": true, "total_results": 87 } } ``` ### Search winter tires 225/45 R17 ```json { "results": [ { "url": "https://www.pneusonline.fr/pneu-hiver/continental-wintercontact-ts-870/225-45-r17", "name": "Continental WinterContact TS 870 225/45 R17 94H", "size": "225/45 R17", "brand": "Continental", "price": 134.5, "width": 225, "rating": 4.5, "season": "winter", "currency": "EUR", "diameter": 17, "wet_grip": "B", "load_index": 94, "product_id": "pno-cont-wc-ts870-22545r17-94h", "sale_price": 134.5, "noise_level": 71, "speed_index": "H", "aspect_ratio": 45, "availability": "in_stock", "review_count": 137, "thumbnail_url": "https://cdn.pneusonline.fr/images/products/continental-wintercontact-ts870-225-45-r17-thumb.jpg", "fuel_efficiency": "C" }, { "url": "https://www.pneusonline.fr/pneu-hiver/pirelli-winter-sottozero-3/225-45-r17", "name": "Pirelli Winter SottoZero 3 225/45 R17 94V", "size": "225/45 R17", "brand": "Pirelli", "price": 128.9, "width": 225, "rating": 4.4, "season": "winter", "currency": "EUR", "diameter": 17, "wet_grip": "B", "load_index": 94, "product_id": "pno-pir-wint-sz3-22545r17-94v", "sale_price": 119.9, "noise_level": 70, "speed_index": "V", "aspect_ratio": 45, "availability": "in_stock", "review_count": 203, "thumbnail_url": "https://cdn.pneusonline.fr/images/products/pirelli-winter-sottozero-3-225-45-r17-thumb.jpg", "fuel_efficiency": "D" }, { "url": "https://www.pneusonline.fr/pneu-hiver/bridgestone-blizzak-lm-6/225-45-r17", "name": "Bridgestone Blizzak LM 6 225/45 R17 94H", "size": "225/45 R17", "brand": "Bridgestone", "price": 142, "width": 225, "rating": 4.6, "season": "winter", "currency": "EUR", "diameter": 17, "wet_grip": "B", "load_index": 94, "product_id": "pno-brid-blizz-lm6-22545r17-94h", "sale_price": 130, "noise_level": 72, "speed_index": "H", "aspect_ratio": 45, "availability": "low_stock", "review_count": 89, "thumbnail_url": "https://cdn.pneusonline.fr/images/products/bridgestone-blizzak-lm6-225-45-r17-thumb.jpg", "fuel_efficiency": "C" } ], "pagination": { "total_pages": 5, "current_page": 1, "has_next_page": true, "total_results": 112 } } ``` ## Documentation ## Overview Pneusonline.fr is a French online tire retailer protected by Cloudflare. Piloterr handles the challenge layer transparently, giving you direct access to live search results without managing proxies or browser automation. Each call returns up to 24 tire listings with real-time pricing, stock status, EU label grades, and key specifications. ## Quickstart ``` GET https://api.piloterr.com/v2/pneusonline/search?query=205%2F55+R16+Michelin ``` ## Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `query` | string | yes | Tire size, brand name, or combined search term | | `page` | integer | no | Page number (default: 1) | | `brand` | string | no | Filter by brand name | | `season` | string | no | Filter by season: `summer`, `winter`, `all-season` | | `width` | integer | no | Filter by tire width in mm | | `aspect_ratio` | integer | no | Filter by aspect ratio | | `diameter` | integer | no | Filter by rim diameter in inches | ## Response fields | Field | Type | Description | |---|---|---| | `results[].product_id` | string | Internal Pneusonline identifier | | `results[].brand` | string | Tire brand name | | `results[].name` | string | Full product name with size | | `results[].size` | string | Tire size in standard notation | | `results[].season` | string | Season type | | `results[].load_index` | integer | Load index code | | `results[].speed_index` | string | Speed rating letter | | `results[].price` | number | Regular price in EUR | | `results[].sale_price` | number | Current sale price in EUR | | `results[].rating` | number | Average rating out of 5 | | `results[].review_count` | integer | Number of customer reviews | | `results[].availability` | string | Stock status | | `results[].fuel_efficiency` | string | EU label fuel grade | | `results[].wet_grip` | string | EU label wet grip grade | | `results[].noise_level` | integer | Rolling noise in dB | | `pagination.current_page` | integer | Current page | | `pagination.total_pages` | integer | Total pages | | `pagination.total_results` | integer | Total matching products | ## Notes - Pneusonline.fr is behind Cloudflare; Piloterr resolves the challenge layer automatically - Results are paginated at 24 products per page - The `season` filter accepts `summer`, `winter`, or `all-season` - This endpoint is available on request ## Main use cases - Pull real-time tire prices from Pneusonline for auto repair shops building price comparison tools - Sync a tire distributor's catalog with live Pneusonline stock and pricing data - Track seasonal price changes across Michelin, Continental, and Pirelli ranges throughout the year - Analyze competitor pricing strategies for tire manufacturers monitoring the French online market - Feed a vehicle maintenance platform with compatible tire options for any car make and size Check [Piloterr pricing](https://www.piloterr.com/pricing) to review credit consumption.