Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: DataForB2B Search API
description: Search API for Companies and People
version: 1.0.0
tags:
- name: Search
paths:
/search/people:
post:
tags:
- Search
summary: Search People Endpoint
description: 'Recherche avancée de profils avec système de filtres conditionnels
**Authentification requise:** Header `api_key: `
**Tarification:** 1 crédit par profil retourné (basic info LinkedIn)
Format similaire aux concurrents avec opérateurs de comparaison.
**Exemple de requête:**
```json
{
"filters": {
"op": "and",
"conditions": [
{"column": "company_headcount", "type": ">=", "value": 50},
{"column": "linkedin_followers", "type": ">=", "value": 1000},
{"column": "is_open_to_work", "type": "=", "value": true},
{"column": "current_company", "type": "like", "value": "Google"}
]
},
"offset": 0,
"count": 100,
"order_by": "linkedin_followers",
"order_direction": "desc"
}
```
**Opérateurs supportés:**
- `=`, `!=` : Égalité/Inégalité
- `>`, `>=`, `<`, `<=` : Comparaison numérique
- `in`, `not_in` : Dans/Pas dans une liste
- `like`, `not_like` : Recherche textuelle (case-insensitive)
- `is_null`, `is_not_null` : Null/Non-null
- `between` : Entre deux valeurs (nécessite value et value2)
**Colonnes disponibles:**
**Basic:** first_name, last_name, full_name, headline, country, city, region, profile_language
**Professional:** current_company, current_title, seniority_level, job_function, years_in_position, years_at_company
**Company:** company_hq_country, company_hq_city, company_headcount, company_headcount_range, company_type, company_industry
**Experience:** total_experience_years, companies_count, avg_tenure_months
**Education:** highest_degree, top_school, certification_count
**Influence:** linkedin_followers, linkedin_connections, follower_growth_30d, follower_growth_90d, is_creator, is_influencer
**Signals:** recently_changed_job, days_in_current_job, is_open_to_work
**Contact:** has_email, has_phone, email_verified
**Tarification:** 0.25 crédit par profil retourné (données de la base)'
operationId: search_people_endpoint_search_people_post
parameters:
- name: X-Debug-SQL
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Debug-Sql
- name: X-Debug-Verify
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Debug-Verify
- name: x-internal-secret
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Internal-Secret
- name: api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Api Key
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedPeopleSearchRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Search People Endpoint Search People Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/search/companies:
post:
tags:
- Search
summary: Search Companies Endpoint
description: 'Recherche avancée d''entreprises avec système de filtres conditionnels.
**Authentification requise:** Header `api_key: `
Format identique au people search avec opérateurs de comparaison.
**Exemple de requête:**
```json
{
"filters": {
"op": "and",
"conditions": [
{"column": "country_iso_code", "type": "=", "value": "FR"},
{"column": "employee_count", "type": ">=", "value": 50},
{"column": "is_actively_hiring", "type": "=", "value": true},
{"column": "category", "type": "like", "value": "SaaS"}
]
},
"offset": 0,
"count": 25,
"order_by": "follower_count",
"order_direction": "desc",
"verify_live": false
}
```
**Colonnes directes (companies_v2):**
- name, tagline, description, domain
- country_iso_code, city, region
- industry, employee_count, founded_year
- company_type, follower_count
- page_verified, is_actively_hiring
- employee_growth_percent, funding_stage
**Colonnes lookup (tables jointes):**
- category (via company_categories)
- investor (via company_investors)
- office_country, office_city (via company_locations)
- total_funding_usd, total_funding_rounds (via company_funding)
- employee_growth_1m/6m/12m (via company_growth_stats)
- job_title (via company_job_postings)
**Tarification:** 0.25 credit par company retournee (donnees de la base)'
operationId: search_companies_endpoint_search_companies_post
parameters:
- name: X-Debug-SQL
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Debug-Sql
- name: x-internal-secret
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Internal-Secret
- name: api-key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Api Key
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedCompanySearchRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CompanySearchResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/search/posts:
post:
tags:
- Search
summary: Search Posts Endpoint
description: 'Search LinkedIn posts with advanced filters
**Authentification requise:** Header `api_key: `
**Tarification:** 1 credit per 10 posts returned
Search for LinkedIn posts using various filters like author company,
industry, job title, content type, date, mentions, etc.
**Available filters:**
| Filter | Description | Example |
|--------|-------------|---------|
| `keyword` | Search in post content | "AI startup" |
| `author_company` | Author''s company name | "Google" |
| `author_industry` | Author''s industry | "Technology" |
| `author_job_title` | Author''s job title | "CEO" |
| `content_type` | Post type | ARTICLE, VIDEO, PHOTO, DOCUMENT |
| `date_posted` | Time filter | past_24h, past_week, past_month |
| `from_member` | Author''s member URN | "ACoAABxxxxxx" |
| `from_organization` | Company ID (numeric) | "1234567" |
| `mentions_member` | Mentioned member URN | "ACoAABxxxxxx" |
| `mentions_organization` | Mentioned org ID | "1234567" |
| `posted_by` | Relationship filter | first, following, first,following |
| `sort_by` | Sort order | date_posted (default), relevance |
**Example request:**
```json
{
"filters": {
"keyword": "AI",
"author_company": "Google"
},
"count": 10
}
```'
operationId: search_posts_endpoint_search_posts_post
parameters:
- name: X-Debug-SQL
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Debug-Sql
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AdvancedPostSearchRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PostSearchResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
CompanySearchResponse:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
AdvancedPostSearchRequest:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
HTTPValidationError:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
PostSearchResponse:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
AdvancedCompanySearchRequest:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
AdvancedPeopleSearchRequest:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true