# ManoMano Search ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/manomano/search` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 2 credits per call | | **Documentation** | https://www.piloterr.com/library/manomano-search | ## Description Read a ManoMano category URL or keyword. Each card keeps the site fields and adds prices.main, brand_name, and image_fullpath. pagination.next is a boolean. ## 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/manomano/search' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Perceuse category, first Makita card ```json { "results": [ { "url": "https://www.manomano.fr/p/perceuse-visseuse-lxt-makita-18-v-3-ah-84523637?product_id=158588345", "brand": { "id": 16, "name": "MAKITA" }, "title": "Makita – Perceuse-visseuse 18V DDF482SFE – 2 batteries 3Ah – Moteur Brushless", "is_mmf": false, "prices": { "main": 189, "retail": 208.27, "discount": "9" }, "article_id": "84523637", "brand_name": "MAKITA", "product_id": "158588345", "seller_name": "Maxoutil", "image_fullpath": "https://cdn.manomano.com/pim-media/images/medium/6f240a922d86f0dec7bab96b2e8f3f41c58e3c93.jpg" } ], "pagination": { "next": true, "current": 1, "total_hits": 11143, "total_pages": 100, "total_results": 6000 } } ``` ## Documentation ## Overview Read a ManoMano category page. `query` is a full category URL, or a keyword such as `perceuse-1146`, which is opened on manomano.fr. ## Quickstart ``` GET https://api.piloterr.com/v2/manomano/search?query=https://www.manomano.fr/perceuse-1146 ``` ## Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `query` | string | yes | Category URL on manomano.fr, .de, .es, .it, or .co.uk, or a manomano.fr keyword. | ## Response fields Each result keeps the site fields and adds `prices.main`, `prices.retail`, `prices.discount`, `brand_name`, `image_fullpath`, `is_mmf`, and a string `product_id`. `pagination.next` is true when another page exists. `pagination.current` is the page that was read. ## Use cases - Watch prices on a DIY category - Collect product URLs before opening each product