search

Reasoning Search

Agentic reasoning search over people.

Authentication: header api_key: <your_api_key>

How it works: a Claude agent reasons about the query, asks clarifying questions when needed, probes the database in real time (free counts), then runs the best final search. Multi-turn via session_id.

Flow:

  1. First call: send query. Response is either needs_input (answer the questions) or complete (final results).
  2. If needs_input: send back session_id + answers ({question_id: answer}).

Pricing: a flat agent fee (2 credits) per completed search, plus the final search billed like /search/people (per-result, DB rate). Clarification turns (needs_input) are free.

post/search/reasoning

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

Headers

api-keystring nullable

Request body

querystring nullable

Requête en langage naturel (max 3000 caractères). Obligatoire au 1er tour (session_id absent).

session_idstring nullable

Identifiant de session renvoyé par un tour 'needs_input'. À fournir avec 'answers'.

answersobject nullable

Réponses aux questions du tour précédent, au format {question_id: réponse}.

category'people' | 'companies'

Cible de recherche: 'people' ou 'companies'.

max_resultsinteger

Nombre de résultats de la recherche finale.

Response

Successful Response

status'needs_input' | 'complete' required

'needs_input' = répondre aux questions ; 'complete' = résultats finaux.

session_idstring required

À renvoyer pour poursuivre la conversation.

reasoningstring nullable

Résumé du raisonnement / de ce qui a été recherché.

applied_filtersobject nullable

FilterGroup final construit par l'agent et exécuté.

totalinteger nullable
countinteger nullable
has_next_pageboolean nullable
credits_usednumber nullable
resultsobject[] nullable

Changes

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