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

{
  "category": "people",
  "filters": {
    "op": "and",
    "conditions": [
      {
        "op": "or",
        "conditions": [
          {"column": "skills", "type": "like", "value": "Python"},
          {"column": "headline", "type": "like", "value": "Python"},
          {"column": "current_title", "type": "like", "value": "Python Developer"}
        ]
      },
      {
        "op": "or",
        "conditions": [
          {"column": "location", "type": "like", "value": "Paris"},
          {"column": "country", "type": "eq", "value": "FR"}
        ]
      }
    ]
  },
  "requested_count": null
}

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.

Convert a natural language query into structured filters that can be used with /search/people or /search/companies endpoints.

​
Credit Cost

ActionCredits
Filter generation1 credit

​
Request Body

​
query
string
required
Natural language search query (minimum 3 characters).Examples:
  • "développeurs Python à Paris"
  • "CEOs of fintech startups in London"
  • "50 data scientists with 5+ years experience"
​
category
string
required
Category to generate filters for: "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" — Generate filters similar from a sales/prospecting perspective
  • "recruiter" — Generate filters similar from a recruiting perspective

​
Response

​
category
string
The category for the filters ("people" or "company").
​
filters
object
Structured filters in FilterGroup format, directly usable with /search/people or /search/companies.
​
requested_count
integer | null
Count detected in the query if specified (e.g., "50 devs" → 50), otherwise null.

​
Examples

{
  "query": "développeurs Python à Paris",
  "category": "people"
}

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

{
  "query": "50 fintech startups in London",
  "category": "company"
}

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

{
  "category": "people",
  "filters": {
    "op": "and",
    "conditions": [
      {
        "op": "or",
        "conditions": [
          {"column": "skills", "type": "like", "value": "Python"},
          {"column": "headline", "type": "like", "value": "Python"},
          {"column": "current_title", "type": "like", "value": "Python Developer"}
        ]
      },
      {
        "op": "or",
        "conditions": [
          {"column": "location", "type": "like", "value": "Paris"},
          {"column": "country", "type": "eq", "value": "FR"}
        ]
      }
    ]
  },
  "requested_count": null
}