Skip to main content
POST
Search Company Records (POST)

Request contract

  • Method and path: POST /apis/v1/people-data-labs/search-company-post
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/people-data-labs/search-company-post
  • Runtime facts: d9aafd76ae02b9bcd98e168c52eb69aba6e12890a1eed8da421910f394e8200a
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Usage-based billing; Default request estimate: $0.1003 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.1003
  • Declared unit rate (USD): 1e-06
  • Billing unit: provider_credit
  • Cost contract: response_units
  • Published reference multiplier: 1.0
  • Declared maximum count/units: 10000000
  • Settlement evidence source: response_body

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
size
integer
required

Batch size/max records returned. Must be between 1 and 100. Default: 1

Required range: 1 <= x <= 100
Examples:

10

50

100

query
string
required

An Elasticsearch (v7.7) DSL query for searching company data. Must be a valid JSON object as a string. Either 'query' or 'sql' is required, but not both.

Examples:

"{\"query\": {\"term\": {\"industry\": \"computer software\"}}}"

"{\"bool\": {\"must\": [{\"term\": {\"industry\": \"computer software\"}}, {\"exists\": {\"field\": \"website\"}}]}}"

sql
string

SQL query format: SELECT * FROM company WHERE [condition]. Either 'query' or 'sql' is required, but not both.

Examples:

"SELECT * FROM company WHERE industry='computer software' AND website IS NOT NULL"

"SELECT * FROM company WHERE employee_count >= 100 AND location.country='united states'"

pretty
boolean
default:false

Human-readable JSON formatting. Default: false

titlecase
boolean
default:false

Titlecase response text. Default: false

from_offset
integer

Legacy offset for pagination (0-9999), max 10000 records total. Use scroll_token for unlimited pagination.

Required range: 0 <= x <= 9999
Examples:

0

100

500

scroll_token
string

Pagination token from previous response for unlimited record retrieval. Use this for paginating beyond 10000 records.

Example:

"104$14.278746"

Response

Tool result data

data
object[]
required
status
integer
required
total
integer
scroll_token
string