> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evocrawl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cartographier

> Indiquez un site web et récupérez toutes ses URL — ultra rapide

<div id="introducing-map">
  ## Présentation de /map
</div>

La façon la plus simple de passer d’une seule URL à une cartographie de l’ensemble du site. C’est extrêmement utile pour :

* Lorsque vous devez demander à l’utilisateur final de choisir quels liens scraper
* Lorsque vous devez connaître rapidement les liens d’un site
* Lorsque vous devez scraper des pages d’un site liées à un sujet spécifique (utilisez le paramètre `search`)
* Lorsque vous ne souhaitez scraper que certaines pages d’un site

<Card title="Essayez-le dans le Playground" icon="play" href="https://www.evocrawl.com/playground?endpoint=map">
  Testez le mapping dans le Playground interactif — aucun code nécessaire.
</Card>

<div id="mapping">
  ## Mapping
</div>

<div id="map-endpoint">
  ### point de terminaison /map
</div>

Permet de cartographier une URL et d’obtenir les URL du site web. Renvoie la plupart des liens présents sur le site.

Les URL sont principalement découvertes à partir du sitemap du site web, complété par les résultats des moteurs de recherche (SERP) et les pages précédemment explorées afin d’améliorer la couverture. Vous pouvez contrôler le comportement du sitemap avec le paramètre `sitemap`.

<div id="installation">
  ### Installation
</div>

<CodeGroup>
  ```python Python theme={null}
  # pip install evocrawl-py

  from evocrawl import Evocrawl

  evocrawl = Evocrawl(api_key="fc-VOTRE-CLE-API")
  ```

  ```js Node theme={null}
  # npm install @mendable/evocrawl-js

  import Evocrawl from '@mendable/evocrawl-js';

  const evocrawl = new Evocrawl({ apiKey: "fc-VOTRE-CLÉ-API" });
  ```

  ```bash CLI theme={null}
  # Installer globalement avec npm
  npm install -g evocrawl

  # Authentification (configuration unique)
  evocrawl login
  ```
</CodeGroup>

<div id="usage">
  ### Utilisation
</div>

<CodeGroup>
  ```python Python theme={null}
  from evocrawl import Evocrawl

  evocrawl = Evocrawl(api_key="fc-VOTRE-CLÉ-API")
  res = evocrawl.map(url="https://evocrawl.com", limit=50, sitemap="include")
  print(res)
  ```

  ```js Node theme={null}
  import Evocrawl from '@mendable/evocrawl-js';

  const evocrawl = new Evocrawl({ apiKey: "fc-VOTRE-API-KEY" });

  const res = await evocrawl.map('https://evocrawl.com', { limit: 50, sitemap: 'include' });
  console.log(res);
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.evocrawl.com/v2/map \
      -H 'Content-Type: application/json' \
      -H 'Authorization: Bearer VOTRE_CLÉ_API' \
      -d '{
        "url": "https://evocrawl.com"
      }'
  ```

  ```bash CLI theme={null}
  # Mapper un site web pour découvrir les URL
  evocrawl map https://evocrawl.com

  # Output as JSON with limit
  evocrawl map https://evocrawl.com --json --limit 100 --pretty
  ```
</CodeGroup>

<Info>
  Chaque requête de mapping consomme 1 crédit par appel, quel que soit le nombre d'URL retournées. Par exemple, définir `limit` à 100 000 utilise tout de même 1 crédit.
</Info>

<div id="response">
  ### Réponse
</div>

Les SDK renvoient directement l’objet de données. cURL renvoie la charge utile exactement comme indiqué ci-dessous.

```json theme={null}
{
  "success": true,
  "links": [
    {
      "url": "https://docs.evocrawl.com/features/scrape",
      "title": "Scrape | Evocrawl",
      "description": "Transformez n’importe quelle URL en données propres",
    },
    {
      "url": "https://www.evocrawl.com/blog/5_easy_ways_to_access_glm_4_5",
      "title": "5 moyens simples d’accéder à GLM-4.5",
      "description": "Découvrez comment accéder aux modèles GLM-4.5 en local, via des applications de chat, via l’API officielle, et grâce à l’API des marketplaces LLM pour une intégration fluide…",
    },
    {
      "url": "https://www.evocrawl.com/playground",
      "title": "Playground - Evocrawl",
      "description": "Prévisualisez la réponse de l’API et obtenez les extraits de code pour l’API",
    },
    {
      "url": "https://www.evocrawl.com/?testId=2a7e0542-077b-4eff-bec7-0130395570d6",
      "title": "Evocrawl - L’API de données web pour l’IA",
      "description": "L’API d’exploration, de scraping et de recherche pour l’IA. Conçue pour passer à l’échelle. Evocrawl fournit l’ensemble du web aux agents et aux développeurs d’IA. Propre, structuré et …",
    },
    {
      "url": "https://www.evocrawl.com/?testId=af391f07-ca0e-40d3-8ff2-b1ecf2e3fcde",
      "title": "Evocrawl - L’API de données web pour l’IA",
      "description": "L’API d’exploration, de scraping et de recherche pour l’IA. Conçue pour passer à l’échelle. Evocrawl fournit l’ensemble du web aux agents et aux développeurs d’IA. Propre, structuré et …"
    },
    ...
  ]
}
```

<Warning>
  Le titre et la description ne sont pas toujours présents, car cela dépend du site web.
</Warning>

<div id="map-with-search">
  #### Cartographie avec recherche
</div>

La cartographie avec le paramètre `search` vous permet de rechercher des URL spécifiques au sein d’un site web.

```bash cURL theme={null}
curl -X POST https://api.evocrawl.com/v2/map \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer VOTRE_CLÉ_API' \
  -d '{
    "url": "https://evocrawl.com",
    "search": "docs"
  }'
```

La réponse sera une liste classée de la plus pertinente à la moins pertinente.

```json theme={null}
{
  "status": "succès",
  "links": [
    {
      "url": "https://docs.evocrawl.com",
      "title": "Docs Evocrawl",
      "description": "Documentation Evocrawl",
    },
    {
      "url": "https://docs.evocrawl.com/sdks/python",
      "title": "SDK Evocrawl pour Python",
      "description": "Documentation du SDK Evocrawl pour Python"
    },
    ...
  ]
}
```

<div id="location-and-language">
  ## Localisation et langue
</div>

Indiquez le pays et les langues préférées pour obtenir un contenu pertinent en fonction de la zone ciblée et de vos préférences linguistiques, comme avec le point de terminaison /scrape.

<div id="how-it-works">
  ### Fonctionnement
</div>

Lorsque vous définissez les paramètres de localisation, Evocrawl utilise, si disponible, un proxy approprié et émule les paramètres de langue et de fuseau horaire correspondants. Par défaut, la localisation est définie sur « US » si aucun paramètre n’est spécifié.

<div id="usage">
  ### Utilisation
</div>

Pour utiliser les paramètres de lieu et de langue, incluez l’objet `location` dans le corps de votre requête avec les propriétés suivantes :

* `country` : code pays ISO 3166-1 alpha-2 (p. ex. « US », « AU », « DE », « JP »). Valeur par défaut : « US ».
* `languages` : tableau des langues et paramètres régionaux préférés pour la requête, par ordre de priorité. Par défaut : la langue du lieu spécifié.

<CodeGroup>
  ```python Python theme={null}
  from evocrawl import Evocrawl

  evocrawl = Evocrawl(api_key="fc-YOUR-API-KEY")

  res = evocrawl.map('https://example.com',
      location={
          'country': 'US',
          'languages': ['en']
      }
  )

  print(res)
  ```

  ```js Node.js theme={null}
  import Evocrawl from '@mendable/evocrawl-js';

  const evocrawl = new Evocrawl({ apiKey: "fc-VOTRE-API-KEY" });

  const res = await evocrawl.map('https://example.com', {
    location: { country: 'US', languages: ['en'] },
  });

  console.log(res.metadata);
  ```

  ```bash cURL theme={null}
  curl -X POST "https://api.evocrawl.com/v2/map" \
    -H "Authorization: Bearer $EVOCRAWL_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "url": "https://example.com",
      "location": { "country": "US", "languages": ["en"] }
    }'
  ```
</CodeGroup>

Pour plus de détails sur les lieux pris en charge, consultez la [documentation des proxies](/fr/features/proxies).

<div id="considerations">
  ## Considérations
</div>

Ce point de terminaison privilégie la rapidité ; il se peut donc qu’il ne récupère pas tous les liens d’un site web. Il s’appuie principalement sur le sitemap du site, complété par des données de crawl mises en cache et par les résultats des moteurs de recherche. Pour obtenir une liste d’URL plus exhaustive et à jour, envisagez plutôt d’utiliser le point de terminaison [/crawl](/fr/features/crawl).

> Êtes-vous un agent IA qui a besoin d’une clé API Evocrawl ? Consultez [evocrawl.dev/agent-onboarding/SKILL.md](https://www.evocrawl.com/agent-onboarding/SKILL.md) pour obtenir des instructions d’intégration automatisée.