Skip to main content
POST
/
search
/
llm
curl -X POST https://api.dataforb2b.ai/search/llm \
  -H "api_key: YOUR_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "développeurs Python à Paris",
    "category": "people",
    "count": 10
  }'

{
  "query_interpretation": {
    "original_query": "cherche head of sales",
    "advanced_filters": {
      "op": "and",
      "conditions": [
        {
          "op": "or",
          "conditions": [
            {"column": "current_title", "type": "like", "value": "Head of Sales"},
            {"column": "current_title", "type": "like", "value": "VP Sales"},
            {"column": "current_title", "type": "like", "value": "Sales Director"},
            {"column": "current_title", "type": "like", "value": "Directeur Commercial"},
            {"column": "current_title", "type": "like", "value": "Chief Sales Officer"}
          ]
        }
      ]
    }
  },
  "total": 10000,
  "count": 25,
  "results": [
    {
      "id": "prof_PVWah3PBfgXQHuiaZitgcXKdRQyyuTSPbATZ",
      "first_name": "Ahmed",
      "last_name": "Othman",
      "headline": "Regional Sales Director - MENA - Irritech Global",
      "location": "Cairo, Egypt",
      "country": "EG",
      "industry": "Business Supplies & Equipment",
      "summary": "A successful technical Sales and marketing engineer...",
      "profile_language": "en_US",
      "profile_picture_url": "https://media.licdn.com/dms/image/...",
      "links": {
        "linkedin": "https://www.linkedin.com/in/ahmed-othman-a2b33097",
        "twitter": null,
        "github": null
      },
      "experience": [
        {
          "company": {
            "id": "org_0lox54iG5IEZSb71mZWLR8z9CVK6PG18bXO4",
            "name": "Irritech Global",
            "url": "https://linkedin.com/company/irritechchina",
            "logo_url": "https://media.licdn.com/dms/image/...",
            "size": "11-50",
            "industry": "Farming"
          },
          "title": "Regional Sales Director",
          "employment_type": "Full-time",
          "location": "Middle East & North Africa",
          "duration_months": 11,
          "start_date": "2025-03",
          "end_date": null,
          "is_current": true
        }
      ],
      "education": [
        {
          "school": {
            "name": "Tanta University"
          },
          "degree": "B.Sc. of Agriculture",
          "field_of_study": "General division department."
        }
      ],
      "skills": [
        "Sales Management",
        "New Business Development",
        "Customer Service",
        "Account Management",
        "Negotiation"
      ],
      "languages": [
        {"name": "Arabic", "proficiency": null},
        {"name": "English", "proficiency": null}
      ],
      "metrics": {
        "followers": 3500,
        "skills_count": 11
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.dataforb2b.ai/llms.txt

Use this file to discover all available pages before exploring further.

Search for people or companies using natural language. The AI automatically interprets your query and extracts relevant filters.

​
Credit Cost

ModeCredits per Result
enrich_live: true1.5 credits
enrich_live: false0.75 credits

​
Request Body

​
query
string
required
Natural language search query (minimum 3 characters).Examples:
  • "développeurs Python à Paris"
  • "CEOs of fintech startups in London"
  • "data scientists with 5+ years experience"
​
category
string
required
Category to search in: "people" or "company".
​
lookalike_use_case
string
default:"sales"
Use case for lookalike search. Only applies when the query contains a LinkedIn profile URL (e.g., linkedin.com/in/...), which is automatically detected.
  • "sales" — Find profiles similar from a sales/prospecting perspective
  • "recruiter" — Find profiles similar from a recruiting perspective
​
count
integer
default:"25"
Number of results to return. Maximum: 100.
​
enrich_live
boolean
default:"true"
Whether to enrich results with live data.
  • true - Returns fresh, up-to-date data (1.5 credits per result)
  • false - Returns cached data (0.75 credits per result)
Pagination is not available on this endpoint. To paginate results, use the /search/people or /search/companies endpoint with the filters extracted by the LLM (available in query_interpretation.advanced_filters) and set the appropriate offset.

​
Response

​
query_interpretation
object
Details about how your query was interpreted by the AI.
​
total
integer
Total number of results matching the query.
​
count
integer
Number of results returned.
​
results
array
List of profiles or companies matching the query. The structure depends on the detected category.

​
Examples

{
  "query": "find profiles like https://www.linkedin.com/in/thomas-kurian-469b6219/",
  "category": "people",
  "lookalike_use_case": "recruiter"
}

curl -X POST https://api.dataforb2b.ai/search/llm \
  -H "api_key: YOUR_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "développeurs Python à Paris",
    "category": "people",
    "count": 10
  }'

{
  "query_interpretation": {
    "original_query": "cherche head of sales",
    "advanced_filters": {
      "op": "and",
      "conditions": [
        {
          "op": "or",
          "conditions": [
            {"column": "current_title", "type": "like", "value": "Head of Sales"},
            {"column": "current_title", "type": "like", "value": "VP Sales"},
            {"column": "current_title", "type": "like", "value": "Sales Director"},
            {"column": "current_title", "type": "like", "value": "Directeur Commercial"},
            {"column": "current_title", "type": "like", "value": "Chief Sales Officer"}
          ]
        }
      ]
    }
  },
  "total": 10000,
  "count": 25,
  "results": [
    {
      "id": "prof_PVWah3PBfgXQHuiaZitgcXKdRQyyuTSPbATZ",
      "first_name": "Ahmed",
      "last_name": "Othman",
      "headline": "Regional Sales Director - MENA - Irritech Global",
      "location": "Cairo, Egypt",
      "country": "EG",
      "industry": "Business Supplies & Equipment",
      "summary": "A successful technical Sales and marketing engineer...",
      "profile_language": "en_US",
      "profile_picture_url": "https://media.licdn.com/dms/image/...",
      "links": {
        "linkedin": "https://www.linkedin.com/in/ahmed-othman-a2b33097",
        "twitter": null,
        "github": null
      },
      "experience": [
        {
          "company": {
            "id": "org_0lox54iG5IEZSb71mZWLR8z9CVK6PG18bXO4",
            "name": "Irritech Global",
            "url": "https://linkedin.com/company/irritechchina",
            "logo_url": "https://media.licdn.com/dms/image/...",
            "size": "11-50",
            "industry": "Farming"
          },
          "title": "Regional Sales Director",
          "employment_type": "Full-time",
          "location": "Middle East & North Africa",
          "duration_months": 11,
          "start_date": "2025-03",
          "end_date": null,
          "is_current": true
        }
      ],
      "education": [
        {
          "school": {
            "name": "Tanta University"
          },
          "degree": "B.Sc. of Agriculture",
          "field_of_study": "General division department."
        }
      ],
      "skills": [
        "Sales Management",
        "New Business Development",
        "Customer Service",
        "Account Management",
        "Negotiation"
      ],
      "languages": [
        {"name": "Arabic", "proficiency": null},
        {"name": "English", "proficiency": null}
      ],
      "metrics": {
        "followers": 3500,
        "skills_count": 11
      }
    }
  ]
}