跳转到主要内容
POST
Company Search with Elasticsearch

请求规范

  • 方法与路径: POST /apis/v1/people-data-labs/search-company-elastic
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/people-data-labs/search-company-elastic
  • Runtime 事实版本: d9aafd76ae02b9bcd98e168c52eb69aba6e12890a1eed8da421910f394e8200a
完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

按用量计费;默认请求预估费用:$0.1003 USD(不是固定价格)。 声明的单位费率:每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。
  • 默认请求参考估价(USD): 0.1003
  • 声明的单位费率(USD): 1e-06
  • 计费单位: provider_credit
  • 计费依据: response_units
  • 公开参考倍率: 1.0
  • 声明的最大计数或单位数: 10000000
  • 结算证据来源: response_body

授权

Authorization
string
header
必填

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

请求体

application/json
size
integer
必填

The number of matched company records to return. Must be an integer between 1 and 100, inclusive.

必填范围: 1 <= x <= 100
query
string
必填

Elasticsearch DSL query string (JSON object) for searching People Data Labs company profiles.

Supported query types: term, terms, match, match_phrase, range, exists, bool (must/should/filter/must_not), wildcard, prefix.

Common Company Fields: name, display_name, website, industry, employee_count, founded, size, location.country, location.region, location.locality, location.name, tags, linkedin_url, type, summary.

Location Searches: Use nested fields: location.country, location.region, location.locality, location.name. Example: {"term": {"location.country": "united states"}}.

Important Restrictions:

  • Do NOT include size or scroll_token in this query; use the dedicated request fields.
  • Do NOT use minimum_should_match in bool queries.

For complete field mappings, see https://docs.peopledatalabs.com/docs/company-search-api.

示例:

"{\"bool\": {\"must\": [{\"term\": {\"industry\": \"computer software\"}}]}}"

"{\"range\": {\"employee_count\": {\"gte\": 5000}}}"

"{\"bool\": {\"filter\": [{\"range\": {\"founded\": {\"gte\": 2010}}}, {\"term\": {\"location.country\": \"united states\"}}]}}"

"{\"match\": {\"name\": \"google\"}}"

pretty
boolean
默认值:false

If true, the JSON response will be pretty-printed with human-readable indentation. Defaults to false.

示例:

"true"

"false"

titlecase
boolean
默认值:false

If true, an attempt will be made to title-case relevant text fields in the returned company records. Defaults to false.

示例:

"true"

"false"

scroll_token
string
默认值:""

A token returned from a previous search response, used for paginating through large result sets. Provide this token to retrieve the next batch of size records. Leave empty or omit for the first request.

示例:

"627275426f6b656e3432363935383437303232353438373930323030343934383635343734313337"

""

响应

Tool result data

query
string
必填
total
integer
必填
records
object[]
必填
scroll_token
string
必填