# ManoMano Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/manomano/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/manomano-search |

## Description

Search for products on ManoMano by category or keyword URL, returning listings with prices, ratings, and seller information.

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

### Search for drills (perceuse)

```json
{
  "results": [
    {
      "cpc": 0.1,
      "url": "https://www.manomano.fr/makita-perceuse-visseuse-18v-3x3ah-ddf484rf3j",
      "bulk": false,
      "title": "Perceuse visseuse 18V Ø 13 mm - MAKITA - Avec 2 batteries 18V Li-Ion 5.0 Ah, chargeur, MakPak- DDF484RTJ",
      "is_b2b": false,
      "is_mmf": true,
      "prices": {
        "main": 277.2,
        "unit": null,
        "retail": 569.16,
        "discount": "51",
        "secondary": null
      },
      "rating": 4.589109,
      "brand_id": 16,
      "is_local": false,
      "model_id": 54973303,
      "offer_id": "d63853b8-314b-4de0-8cd8-fc9c993fe6f6",
      "position": 1,
      "seller_id": 5307819,
      "article_id": 78566961
    },
    {
      "url": "https://www.manomano.fr/dewalt-perceuse-visseuse-18v-dcd778d2t",
      "bulk": false,
      "title": "Perceuse visseuse sans fil 18V - DEWALT - DCD778D2T",
      "is_b2b": false,
      "is_mmf": false,
      "prices": {
        "main": 149.99,
        "unit": null,
        "retail": 199.99,
        "discount": "25",
        "secondary": null
      },
      "rating": 4.72,
      "model_id": 12345678,
      "offer_id": "abc123-def456",
      "position": 2,
      "article_id": 12345678
    }
  ]
}
```

## Documentation

## Overview
Extract product listings from any ManoMano search or category page. Returns products with prices, discounts, ratings, and offer IDs.

## Quickstart
```
GET https://api.piloterr.com/v2/manomano/search?query=https://www.manomano.fr/perceuse-1146
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | ManoMano search or category URL |

## Main use cases
- Scrape categories for comprehensive DIY product catalogs
- Monitor search rankings for products and brands
- Aggregate discounted products for deal tools
- Track competitor pricing in home improvement marketplace