> ## 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. # 연락처 조회 - 단일 > 이메일, 전화번호, 또는 (유사도 검색이 활성화된 경우) 이름 + 성 + 도메인이나 회사명으로 인물을 역조회합니다. 매칭된 인물의 `people_search_id` 와 기본 정보, 매칭 방식을 설명하는 `match` 메타데이터를 반환합니다. 청구 가능한 매칭당 1 크레딧을 차감합니다. ## OpenAPI ````yaml ko-openapi POST /redeem/people/contact/lookup openapi: 3.0.0 info: description: >- Pubrio API는 마켓 확장 인텔리전스를 제공합니다——기업의 신규 시장 진입을 포착하는 실시간 시그널과 그 기반이 되는 기업·인물 데이터. 계정과 연락처를 검색·조회·보강하고, 200+ 시장에 걸친 유형·날짜가 있는 움직임 시그널을 구독하세요. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ko/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ko/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: 워크스페이스 프로필 정보 및 사용량 통계 - name: Enrichment description: 상세한 B2B 데이터로 인물 및 기업 레코드를 보강 - name: Lookalike description: 지정된 기업과 유사한 기업 검색 - name: Search description: 필터를 사용하여 인물, 기업, 채용, 뉴스 및 광고 검색 - name: Lookup description: 특정 인물, 기업, 채용, 뉴스, 광고 및 기술의 상세 정보 조회 - name: LinkedIn description: LinkedIn 프로필 URL을 통한 인물 및 기업 데이터 조회 - name: Redeem description: 크레딧을 사용하여 인물 연락처 정보 잠금 해제 (단건 및 배치) - name: Channels description: 아웃리치 채널 템플릿 관리 (생성, 수정, 삭제, 목록) - name: Monitor description: 웹훅, 통계 및 처리를 포함한 데이터 모니터 생성 및 관리 - name: Filters description: 검색 매개변수에 사용 가능한 필터 값 조회 (기술, 지역, 버티컬 등) - name: API Keys description: API 키의 요청 로그 및 사용량 분석 조회 - name: Insights description: 회사의 신호 집계 인사이트(채용, 뉴스, 광고). - name: Export description: 대량 데이터 내보내기(크레딧 차감). - name: Expansion description: '회사 시장 확장 인텔리전스: 신호, 단계, 시장, 내보내기.' externalDocs: description: >- Pubrio API는 연락처와 계정 정보를 검색, 미리보기, 그리고 보강하는 데 사용됩니다. Pubrio 데이터베이스는 풍부한 B2B 연락처 및 영업 인텔리전스 데이터를 제공합니다. url: https://docs.pubrio.com paths: /redeem/people/contact/lookup: post: tags: - Redeem summary: 연락처 식별자로 인물 조회 description: >- 이메일, 전화번호, 또는 (유사도 검색이 활성화된 경우) 이름 + 성 + 도메인이나 회사명으로 인물을 역조회합니다. 매칭된 인물의 `people_search_id` 와 기본 정보, 매칭 방식을 설명하는 `match` 메타데이터를 반환합니다. 청구 가능한 매칭당 1 크레딧을 차감합니다. operationId: redeem_people_contact_lookup parameters: [] requestBody: required: true content: application/json: schema: type: object properties: email: $ref: '#/components/schemas/contact_lookup_email' phone: $ref: '#/components/schemas/contact_lookup_phone' first_name: $ref: '#/components/schemas/contact_lookup_first_name' last_name: $ref: '#/components/schemas/contact_lookup_last_name' domain: $ref: '#/components/schemas/contact_lookup_domain' company: $ref: '#/components/schemas/contact_lookup_company' is_enable_similarity_search: $ref: >- #/components/schemas/contact_lookup_is_enable_similarity_search profile_id: $ref: '#/components/schemas/profile_id' anyOf: - title: 이메일 required: - email - title: 전화번호 required: - phone - title: 이름 + 도메인(유사도 매칭) required: - first_name - last_name - domain - is_enable_similarity_search - title: 이름 + 회사명(유사도 매칭) required: - first_name - last_name - company - is_enable_similarity_search responses: '200': description: 매칭된 인물과 매칭 메타데이터가 포함된 성공 응답. content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/data' example: data: profile: credit: 450375 topup_credit: 235236 total_credit_cost: 1 peoples: - people_search_id: e37ccf38-ea8f-422e-9874-cb23b15e8fe4 first_name: King last_name: Lai people_name: King Lai company_name: Pubrio domain: pubrio.com match: confidence: exact input: value: king.lai@pubrio.com type: email-work is_duplicate_input: false '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: contact_lookup_email: type: string format: email example: person@example.com description: 조회할 업무용 또는 개인 이메일 주소. 시스템은 매칭 전 대소문자와 공백을 정규화합니다. contact_lookup_phone: type: string example: '+15551234567' description: 조회할 전화번호. 국제 형식(E.164)을 권장합니다. contact_lookup_first_name: type: string example: King description: >- 이름. `is_enable_similarity_search` 가 `true` 일 때 `last_name` 및 `domain` 또는 `company` 와 함께 사용합니다. contact_lookup_last_name: type: string example: Lai description: >- 성. `is_enable_similarity_search` 가 `true` 일 때 `first_name` 및 `domain` 또는 `company` 와 함께 사용합니다. contact_lookup_domain: type: string example: pubrio.com description: >- 회사 도메인. `is_enable_similarity_search` 가 `true` 일 때 `first_name` + `last_name` 과 함께 유사도 검색의 기준점으로 사용됩니다. contact_lookup_company: type: string example: Pubrio description: >- 회사명. `is_enable_similarity_search` 가 `true` 이고 `domain` 이 제공되지 않은 경우 `first_name` + `last_name` 과 함께 유사도 검색의 기준점으로 사용됩니다. contact_lookup_is_enable_similarity_search: type: boolean default: false example: true description: >- `true` 인 경우 정확한 이메일/전화번호 일치가 없으면 이름 기반 유사도 매칭으로 폴백합니다. `first_name`, `last_name`, 그리고 `domain` 또는 `company` 가 필요합니다. profile_id: type: integer description: >- 선택 사항. 요청을 수행하는 팀 식별자입니다. API 키에 이미 워크스페이스 정보가 포함되어 있으므로 이 매개변수는 더 이상 필수가 아닙니다. 제공되면 조회 및 사용 크레딧 추적을 위해 특정 팀(작업 공간)과 연계됩니다. 자세한 내용은 팀 탭의 `user details` 엔드포인트를 참고하세요. data: type: object nullable: true description: 응답 정보는 특정 API에 따라 다릅니다. responses: general_error: description: 잘못된 요청. 요청 형식이 올바르지 않거나 잘못된 매개변수가 포함되어 있습니다. 오류 코드와 메시지를 확인하세요. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: 오류 코드 및 메시지는 상황에 따라 다를 수 있습니다. 자세한 내용은 문서를 참조하세요. type: string details: type: object rate_limit_error: description: 요청 속도 제한 초과. 주어진 시간 내에 너무 많은 요청이 전송되었습니다. 속도 제한 창이 재설정된 후 다시 시도하세요. content: application/json: schema: required: - error type: object properties: error: example: 요청 빈도가 제한을 초과했습니다. 잠시 후 다시 시도해주세요. type: string server_error: description: 내부 서버 오류. 서버에서 예기치 않은 오류가 발생했습니다. 오류가 지속되면 지원팀에 문의하세요. content: application/json: schema: required: - error type: object properties: error: example: 요청을 처리하는 중 서버에서 예기치 않은 오류가 발생했습니다 type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- API에서 수행하는 작업 및 해당 권한을 식별하는 고유한 API 토큰입니다. 이 토큰은 [설정](https://dashboard.pubrio.com/#/settings/) 섹션에서 생성할 수 있습니다. in: header ````