---
title: "Llm Search"
method: POST
path: "/search/llm"
tags: ["search"]
---

# Llm Search

`POST /search/llm`

## Request

- Base URL: `https://api.dataforb2b.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dataforb2b.ai/search/llm`
- Auth: none declared

Recherche en langage naturel via LLM

**Authentification requise:** Header `api_key: <your_api_key>`

**Tarification:** 1 crédit par profil retourné (basic info LinkedIn)

Cette endpoint permet de rechercher des profils ou des entreprises
en utilisant une requête en langage naturel.

**Exemples de requêtes:**
- "développeurs Python à Paris"
- "data scientists qui ont travaillé chez Google"
- "CTO de startups en France"
- "personnes open to work avec plus de 5000 followers"
- "ingénieurs sortis de Polytechnique"

**Paramètres:**
- **query**: La requête en langage naturel (obligatoire)
- **category**: "people" ou "company" (optionnel, auto-détecté si absent)
- **output_fields**: Liste des champs à retourner (optionnel)
- **show_private_fields**: Afficher les champs privés (photo, dates, statuts)
- **page**: Numéro de page (défaut: 1)
- **page_size**: Résultats par page (défaut: 25, max: 100)

## Headers

- `X-Debug-SQL` string, nullable
- `X-Debug-Verify` string, nullable
- `api-key` string, nullable

## Request body

- LLMSearchRequest: Requête de recherche en langage naturel
  - `query` string, required: Requête en langage naturel
  - `category` string, required: Catégorie de recherche: 'people' ou 'company'
  - `lookalike_use_case` 'sales' | 'recruiter': Lookalike use case (only used when query contains a LinkedIn profile URL): 'sales' to find similar prospects or 'recruiter' to find similar candidates
  - `output_fields` string[], nullable: Champs à retourner dans les résultats. Si non fourni, champs par défaut.
  - `show_private_fields` boolean: Si True, affiche les champs privés (photo, dates, is_open_to_work, is_hiring, etc.)
  - `page` integer: Numéro de page
  - `page_size` integer: Nombre de résultats par page
  - `count` integer, nullable: Alias for page_size (takes priority if both provided)
  - `order_by` string, nullable: Colonne de tri (ex: follower_count, first_name, last_name)
  - `order_direction` 'asc' | 'desc': Direction du tri

## Response `200`

Successful Response

- LLMSearchResponse: Réponse de recherche LLM
  - `query_interpretation` object, required: Interprétation de la requête par le LLM
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required
  - `has_next_page` boolean, required
  - `results` object[], required
  - `_debug` object, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dataforb2b/apis/dataforb2b-api.md) · [All operations](https://skmtc.dev/dataforb2b/apis/dataforb2b-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dataforb2b/apis/dataforb2b-api/revisions/24ea79caa1a1?raw)