search

Llm Search V2

Recherche en langage naturel v2 — filtres durs minimaux + ranking sémantique

Authentification requise: Header api_key: <your_api_key>

Tarification: identique à /search/people (tarif DB par profil)

Contrairement à /search/llm (v1), le LLM n'extrait ici que les contraintes DURES (géographie, années d'expérience explicites, taille d'entreprise explicite, secteur explicitement nommé, employeur nommé). Tout le reste (rôle, séniorité, skills, domaine, produit) est géré par le ranking sémantique sur la requête telle quelle : le jeu de résultats est large, ordonné par pertinence, chaque profil portant relevance_score (0-1). Aucun filtre n'est relâché ni ajouté côté serveur.

Paramètres:

  • query: la requête en langage naturel (obligatoire)
  • category: "people" (v2) — "company" est délégué au comportement v1
  • prioritize: null (défaut) = ordre de pertinence pur ; "personal_email"/"work_email"/"phone" = contact-d'abord
  • max_per_company: diversité, au plus N profils du même employeur en tête (désactivé par défaut, passer une valeur pour l'activer)
  • page / page_size / count, show_private_fields: comme la v1

La réponse a le même format que la v1 ; query_interpretation expose en plus rank_query et extraction (ce que le LLM a extrait).

post/search/llm/v2

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/v2
  • Auth: none declared

Headers

api-keystring nullable

Request body

querystring required

Requête en langage naturel

categorystring

Catégorie de recherche: 'people' (v2) ou 'company' (délégué au comportement v1)

lookalike_use_case'sales' | 'recruiter'

Lookalike use case (utilisé seulement quand la query contient une URL LinkedIn, délégué au comportement v1)

show_private_fieldsboolean

Si True, affiche les champs privés (photo, dates, is_open_to_work, is_hiring, etc.)

pageinteger

Numéro de page

page_sizeinteger

Nombre de résultats par page

countinteger nullable

Alias for page_size (takes priority if both provided)

prioritize'personal_email' | 'work_email' | 'phone' nullable

Tri contact-d'abord: les profils ayant ce type de contact passent devant, chaque groupe restant trié par pertinence. Défaut null = ordre de pertinence pur.

max_per_companyinteger nullable

Diversité: au plus N profils d'un même employeur dans la tête des résultats (le surplus est repoussé plus loin, rien n'est filtré, l'ordre par pertinence n'est plus strict au-delà). Désactivé par défaut (null) — préserve le tri par relevance_score ; passer une valeur pour l'activer.

Response

Successful Response

query_interpretationobject required

Interprétation de la requête par le LLM

totalinteger required
pageinteger required
page_sizeinteger required
has_next_pageboolean required
resultsobject[] required
_debugobject nullable

Changes

No recorded changes to this operation across all 1 revision of this API.