메인 콘텐츠로 건너뛰기
POST
/
redeem
/
people
/
contact
/
lookup
/
batch
연락처 식별자로 인물 일괄 조회
curl --request POST \
  --url https://api.pubrio.com/redeem/people/contact/lookup/batch \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "peoples": [
    {
      "email": "[email protected]"
    },
    {
      "first_name": "John",
      "last_name": "Smith",
      "domain": "example.com"
    }
  ],
  "is_enable_similarity_search": true,
  "profile_id": 123
}
'
{
  "data": {
    "profile": {
      "credit": 450374,
      "topup_credit": 235236,
      "total_credit_cost": 2
    },
    "peoples": [
      {
        "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
        "people_name": "King Lai",
        "company_name": "Pubrio",
        "domain": "pubrio.com",
        "match": {
          "confidence": "exact",
          "input": {
            "value": "[email protected]",
            "type": "email-work"
          },
          "is_duplicate_input": false
        }
      },
      {
        "people_search_id": "1c4f0a9d-9a8e-4ab0-9b07-2cd09c4a3a6b",
        "people_name": "John Smith",
        "company_name": "Example",
        "domain": "example.com",
        "match": {
          "confidence": "similarity_domain",
          "input": {
            "value": "example.com",
            "type": "domain"
          },
          "is_duplicate_input": false
        }
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt

Use this file to discover all available pages before exploring further.

인증

pubrio-api-key
string
header
필수

API에서 수행하는 작업 및 해당 권한을 식별하는 고유한 API 토큰입니다. 이 토큰은 설정 섹션에서 생성할 수 있습니다.

본문

application/json
peoples
object[]
필수

조회 명세 배열. 각 항목은 단일 조회 본문과 동일한 식별자(email, phone, 또는 유사도 검색이 활성화된 경우 first_name + last_name + domain/company)를 허용합니다. 구독의 일괄 처리 크기 제한이 적용됩니다.

예시:
[
{ "email": "[email protected]" },
{
"first_name": "John",
"last_name": "Smith",
"domain": "example.com"
}
]

true 인 경우 정확한 이메일/전화번호 일치가 없으면 이름 기반 유사도 매칭으로 폴백합니다. first_name, last_name, 그리고 domain 또는 company 가 필요합니다.

예시:

true

profile_id
integer

선택 사항. 요청을 수행하는 팀 식별자입니다. API 키에 이미 워크스페이스 정보가 포함되어 있으므로 이 매개변수는 더 이상 필수가 아닙니다. 제공되면 조회 및 사용 크레딧 추적을 위해 특정 팀(작업 공간)과 연계됩니다.

자세한 내용은 팀 탭의 user details 엔드포인트를 참고하세요.

응답

매칭된 인물과 항목별 매칭 메타데이터가 포함된 성공 응답.

data
object

응답 정보는 특정 API에 따라 다릅니다.