Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: 'superagnt Lead APIs: People — Search API'
description: Unified API for social media data. Access LinkedIn, YouTube, TikTok, X, Instagram, Reddit, and Facebook through a single API key.
version: 1.0.0
contact:
name: superagnt
url: https://superagnt.com
servers:
- url: https://api.superagnt.com
description: superagnt API
security:
- ApiKeyAuth: []
tags:
- name: 'superagnt Lead APIs: People — Search'
description: Search the people graph by structured filters.
paths:
/v1/data/agnt/people/search:
post:
operationId: people_search
summary: Search people
description: Search the people graph using structured filters (job title, company, location, seniority, department, …). Returns paginated profile summaries.
tags:
- 'superagnt Lead APIs: People — Search'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PeopleSearchRequest'
example:
filters:
job_title: founder
location: San Francisco
page: 1
responses:
'200':
description: People search results.
content:
application/json:
schema:
type: object
required:
- success
- data
properties:
success:
type: boolean
enum:
- true
data:
$ref: '#/components/schemas/PeopleSearchResponse'
meta:
$ref: '#/components/schemas/AgntMeta'
'400':
description: Validation error.
'401':
description: Unauthorized.
security:
- ApiKeyAuth: []
components:
schemas:
PeopleSearchRequest:
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
AgntMeta:
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
PeopleSearchResponse:
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
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: Authorization
description: 'Bearer token. Pass your agntdata API key as: Authorization: Bearer agnt_live_...'