跳转到主要内容
POST
Reference example

请求规范

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

费用与请求规则

按用量计费;默认请求预估费用:$0.2803 USD(不是固定价格)。 声明的单位费率:每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。
  • 默认请求参考估价(USD): 0.2803
  • 声明的单位费率(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
email
string
必填

Email address.

示例:

"john.doe@example.com"

lid
string

LinkedIn ID.

示例:

"123456789"

name
string

Full name.

示例:

"John Michael Doe"

phone
string

Phone number; E.164 format recommended.

示例:

"+14155552671"

pdl_id
string

People Data Labs unique record ID.

示例:

"qEnxS5T1G2YvasA1x24qoA_0000"

pretty
boolean
默认值:true

Format JSON response with indentation for readability.

region
string

State, province, or region of residence.

示例:

"CA"

school
string

School name attended.

示例:

"Stanford University"

company
string

Company name where person has worked.

示例:

"Acme Corporation"

country
string

Country of residence (ISO 3166-1 alpha-2 code or full name).

示例:

"US"

"United States"

profile
string

Social profile URL (e.g., LinkedIn, Facebook).

示例:

"https://www.linkedin.com/in/john-doe"

"https://www.facebook.com/jane.doe"

locality
string

City or locality of residence.

示例:

"San Francisco"

location
string

General location (e.g., city, state, country).

示例:

"San Francisco, CA, USA"

required
string

Boolean expression of top-level fields required in enriched profile for match. Use AND/OR operators and parentheses for logic (e.g., 'emails AND phone_numbers', 'education AND (emails OR phone_numbers)'). Valid fields: emails, phone_numbers, experience, education, job_title, job_company_name, full_name, location_country, work_email, personal_emails, mobile_phone, linkedin_url, profiles, skills, etc.

示例:

"emails AND phone_numbers"

"education AND (emails OR phone_numbers)"

"job_title AND job_company_name"

"experience AND work_email"

last_name
string

Last name.

示例:

"Doe"

birth_date
string

Birth date (YYYY-MM-DD format).

示例:

"1990-01-15"

email_hash
string

SHA-256 or MD5 hash of an email, for matching without exposing the raw email.

示例:

"d41d8cd98f00b204e9800998ecf8427e"

"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"

first_name
string

First name.

示例:

"John"

postal_code
string

Postal or ZIP code of residence.

示例:

"94107"

data_include
string

Comma-separated data fields to include in response (e.g., 'emails,phones'). Refer to People Data Labs docs for all fields.

示例:

"emails,phones,profiles"

"jobs,education"

min_likelihood
integer
默认值:2

Minimum confidence score (0-10) for a match to be returned; higher is stricter.

必填范围: 0 <= x <= 10
示例:

0

5

10

street_address
string

Street address.

示例:

"123 Main St"

include_if_matched
boolean
默认值:false

Include input parameters used for matching in the response if true.

响应

Tool result data

data
object
必填
status
integer
必填
likelihood
integer
必填
matched
string[]