Generect 5. Preview API
Search masked database leads for preview and reveal workflows.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/generect-com:generect-com-5-preview-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Generect 5. Preview API
description: 'Welcome to the Generect API documentation. Here we will help you integrate and use our API.
API base url: `https://api.generect.com` — every path below is relative to this host. Newer endpoints live under `/api/v1/...`, legacy endpoints under `/api/...`; use each path exactly as documented.
Protocol: `HTTPS`
# Authentication
Get your API token from the Generect app settings and send it in the `Authorization` header with the required `Token` prefix.
Example: `Authorization: Token xxxxxxxxx`
# Rate limits
There is no monthly request quota. What you can run is bounded by your account balance and by the parallel-request caps on the Limits page. Pricing depends on the operation and the number of results returned, and may increase with additional data flags. For exact pricing, see each endpoint''s Pricing section or your billing settings: https://app.generect.com/settings/billing
# Note
_Every endpoint must include the trailing `/`. Requests without the trailing slash may fail._'
version: 1.0.0
contact: {}
servers:
- url: https://api.generect.com
security:
- apiKey: []
tags:
- name: 5. Preview
description: Search masked database leads for preview and reveal workflows.
paths:
/api/v1/preview/leads/:
post:
tags:
- 5. Preview
summary: Preview leads
description: Search database leads with masked response data. Preview results include an internal lead ID for later enrichment and do not include LinkedIn URL, company domain, email, or phone. Billed at \$0.002 per returned row — a search that matches nothing is free — and free for the rest of the calendar month once the account's total spend that month reaches \$2,000 (see `preview_tier` on `GET /api/v1/accounts/me/`).
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
company_search_criteria:
type: object
description: Company filters (same as /search/database/companies/).
properties:
industries:
type: array
items:
type: string
headcounts:
type: array
items:
type: string
locations:
type: array
items:
type: string
company_types:
type: array
items:
type: string
lead_search_criteria:
type: object
description: Lead filters (same as /search/database/leads/).
properties:
job_titles:
type: array
items:
type: string
seniorities:
type: array
items:
type: string
locations:
type: array
items:
type: string
company_industries:
type: array
items:
type: string
company_headcounts:
type: array
items:
type: string
personas:
type: array
items:
type: array
limit_by:
type: integer
offset_by:
type: integer
examples:
Preview leads:
value:
company_search_criteria:
industries:
- Software Development
headcounts:
- 51-200
locations:
- United States
lead_search_criteria:
job_titles:
- CEO
- Founder
seniorities:
- c_suite
locations:
- United States
limit_by: 25
responses:
'400':
description: Validation error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
Validation error:
value:
status: error
status_code: 400
detail:
company_headcounts:
- Object with name=999 does not exist.
'401':
$ref: '#/components/responses/Unauthorized'
'403':
description: Account is not enabled for the Preview endpoint.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example:
error: You are not authorized to use this endpoint.
'200':
description: Masked lead preview results
content:
application/json:
schema:
$ref: '#/components/schemas/PreviewLeadsResponse'
example:
data:
leads:
- id: ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9
first_name: Jordan
last_name: Ellis
title: CEO
company_name: Microsoft
location: San Francisco, CA
industry: Software Development
seniority: CXO
headcount_range: 51-200
- id: ACwAAAFp2r4Bd1eF3gH5iJ7kL9mN0pQ2rS4tU6v
first_name: Morgan
last_name: Lee
title: VP Sales
company_name: Salesforce
location: New York, NY
industry: Software Development
seniority: VP
headcount_range: 201-500
meta:
amount_charged: 0.004
operationId: postApiV1PreviewLeads
x-operation-id-source: derived
/api/v1/preview/leads/count/:
post:
tags:
- 5. Preview
summary: Count preview leads
description: Count matching database leads for Preview. Count requests are always free.
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
company_search_criteria:
type: object
description: Company filters (same as Preview leads).
properties:
industries:
type: array
items:
type: string
headcounts:
type: array
items:
type: string
locations:
type: array
items:
type: string
lead_search_criteria:
type: object
description: Lead filters (same as Preview leads).
properties:
job_titles:
type: array
items:
type: string
seniorities:
type: array
items:
type: string
locations:
type: array
items:
type: string
company_industries:
type: array
items:
type: string
company_headcounts:
type: array
items:
type: string
examples:
Count preview leads:
value:
company_search_criteria:
industries:
- Software Development
locations:
- United States
lead_search_criteria:
job_titles:
- CEO
locations:
- United States
responses:
'400':
description: Validation error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
Validation error:
value:
status: error
status_code: 400
detail:
company_headcounts:
- Object with name=999 does not exist.
'401':
$ref: '#/components/responses/Unauthorized'
'403':
description: Account is not enabled for the Preview endpoint.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example:
error: You are not authorized to use this endpoint.
'200':
description: Matching lead count
content:
application/json:
schema:
$ref: '#/components/schemas/PreviewCountResponse'
example:
data:
count: 1240
meta:
amount_charged: 0
operationId: postApiV1PreviewLeadsCount
x-operation-id-source: derived
components:
schemas:
PreviewCountResponse:
type: object
properties:
data:
type: object
properties:
count:
type: integer
description: Number of preview leads matching the filters.
meta:
$ref: '#/components/schemas/Meta'
PreviewLeadsResponse:
type: object
properties:
data:
type: object
properties:
leads:
type: array
description: Masked lead previews — see the example for the field set.
items:
type: object
meta:
$ref: '#/components/schemas/Meta'
Error:
type: object
description: Standard error envelope returned for 4xx/5xx responses.
properties:
status:
type: string
example: error
status_code:
type: integer
example: 400
detail:
description: 'Human-readable message (string) for most errors, or a field-level validation map ({ field: [messages] }) for 400 validation errors.'
example: Person does not exist
Meta:
type: object
description: Operation metadata returned in every data/meta response.
required:
- amount_charged
properties:
amount_charged:
type: number
description: Actual amount charged for this request in USD, computed from your pricing tier. 0 for free operations and for not-found results (No Data — No Charge).
status:
type: string
description: Set to "error" when the operation finished with an error.
error:
type: string
description: Error details; present only when the operation failed.
time_cached:
type: string
format: date-time
description: When the cached result set was originally collected (returned by database company search when results are served from a previous identical search).
free_tier:
type: object
description: 'Present only on a database lead or company search sent with `"detail": "thin"`: where your account stands against today''s free row quota. The quota resets at 00:00 UTC.'
properties:
detail:
type: string
enum:
- thin
daily_rows:
type: integer
description: Free thin rows per account per UTC day.
rows_used_today:
type: integer
description: Thin rows returned to your account today, this page included.
rows_left_today:
type: integer
description: Thin rows your account can still take today.
responses:
Unauthorized:
description: Missing or invalid API token.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
status: error
status_code: 401
detail: Authentication credentials were not provided.
securitySchemes:
apiKey:
type: apiKey
in: header
name: Authorization
description: 'Use the required Token prefix. Example: Authorization: Token xxxxxxxxx'