> ## 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 데이터베이스에서 검색합니다. ## OpenAPI ````yaml ko-openapi POST /people/search 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: /people/search: post: tags: - Search summary: 인물 검색 description: 직책, 위치, 회사, 직급 등 지정된 조건에 맞는 인물을 Pubrio 데이터베이스에서 검색합니다. operationId: people_search parameters: [] requestBody: required: true content: application/json: schema: type: object properties: search_term: $ref: '#/components/schemas/search_term' people_name: $ref: '#/components/schemas/people_name' people_titles: $ref: '#/components/schemas/people_titles' peoples: $ref: '#/components/schemas/peoples' management_levels: $ref: '#/components/schemas/management_levels' departments: $ref: '#/components/schemas/departments' department_functions: $ref: '#/components/schemas/functions' employees: $ref: '#/components/schemas/employees' people_locations: $ref: '#/components/schemas/people_locations' company_locations: $ref: '#/components/schemas/company_locations' company_linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' linkedin_urls: $ref: '#/components/schemas/people_linkedin_urls' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' company_filters: $ref: '#/components/schemas/company_filters' filter_conditions: $ref: '#/components/schemas/people_filter_conditions' is_enable_similarity_search: $ref: '#/components/schemas/is_enable_similarity_search' similarity_score: $ref: '#/components/schemas/similarity_score' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' query: type: string example: decision makers in marketing description: >- 자연어 검색. 입력하면 Pubrio가 이를 아래의 인물 및 회사 필터(직무, 직급, 부서, 지역, 산업, 회사 규모 등)로 해석합니다. 함께 전달한 명시적 필터가 해석된 필터보다 우선합니다. 비워 두면 구조화된 필터만으로 검색합니다. is_include_similar_people_titles: type: boolean description: >- 활성화하면 `people_titles`가 정확히 일치하는 직함뿐 아니라 유사한 직함(예: `software engineer`가 `senior software engineer`와 일치)도 매칭합니다. people_title_similarity_score: type: number format: float example: 0.9 description: >- `is_include_similar_people_titles`와 함께 사용합니다. 직함이 얼마나 근접하게 일치해야 하는지를 제어하며, 값이 클수록 더 엄격하게 일치합니다. profile_id: $ref: '#/components/schemas/profile_id' responses: '200': description: 관련 세부 정보가 포함된 성공적인 응답입니다. content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/data' example: metadata: filters: management_levels: - c_suite profile: null data: pagination: page: 1 per_page: 25 total_entries: 199616132 total_pages: 100 total_display_pages: 100 is_timeout: false peoples: - people_search_id: 134591fb-f0fa-41ba-9c8c-f1eb8aab8946 name: Doug McMillon first_name: Doug last_name: McMillon title: President & CEO seniority: c_suite functions: null headline: President & CEO at Walmart Inc. tagline: null introduction: null description: null departments: - c_suite subdepartments: - executive keywords: null employment_history: - title: President & CEO current: true end_date: null start_date: '2014-02-01' company_name: Walmart - title: President & CEO, Walmart International current: false end_date: '2014-01-01' start_date: '2009-02-01' company_name: Walmart - title: President & CEO current: false end_date: '2009-01-01' start_date: '2005-08-01' company_name: Sam's Club country: United States country_code: US location: United States state: Arkansas city: Bentonville wantedly_name: null rocketpunch_name: null contacts: null contact_types: [] emails: null phones: null facebook_url: null github_url: null twitter_url: null linkedin_url: http://www.linkedin.com/in/dougmcmillon wantedly_url: null rocketpunch_url: null saved_lists: null sequences: null social_metadata: {} company: company_name: Walmart company_url: http://walmart.com is_company_url_active: true domain: walmart.com domain_id: 26067151 domain_ids: - 757023267 - 368242703 - 26067151 domain_search_id: 2a0d6cd7-cc10-44d6-94ec-41fd528a11b6 founded_year: 1962 country: United States country_code: US location: United States phones: null emails: [] contacts: [] wantedly_name: null rocketpunch_name: null tiktok_name: null company_size_printed: 466,000 company_size: 466000 industry: Retail specialties: - Retail - E-commerce logo_url: >- https://buckets.pubrio.com/company-logo/NzU3MDIzMjY3aWxqOXNzbmoxd2FsbWFydC5jb21saW5rZWRpbl8zMzMxOTgxMg==.jpg linkedin_url: http://www.linkedin.com/company/walmart facebook_url: http://facebook.com/walmart twitter_url: https://twitter.com/walmart crunchbase_url: null instagram_url: http://instagram.com/walmart youtube_url: http://youtube.com/user/walmart x_url: null github_url: null tiktok_url: null wantedly_url: null rocketpunch_url: null social_metadata: {} - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: search_term: type: string example: pubrio description: 결과를 필터링하기 위한 키워드 문자열입니다. people_name: type: string example: king description: 검색 결과를 지정된 사용자 이름으로 필터링합니다. people_titles: type: array items: type: string example: - sales manager - marketing manager description: >- 검색 대상 인물의 직함입니다. `software engineer`를 검색하면 `senior software engineer`와 같이 유사한 용어를 포함한 결과도 반환될 수 있습니다. peoples: type: array items: type: string format: uuid description: 사용자 조회 작업을 위한 고유 식별자(people_search_id) 목록. management_levels: type: array items: type: string example: - head description: |- 현재 조직에서 인물의 관리 직급을 나타냅니다. 특정 보고 계층(예: C레벨 또는 시니어)을 대상으로 필터링할 때 사용합니다. 자세한 내용은 필터 탭의 `management level` 엔드포인트를 참조하세요. departments: type: array items: type: string example: - master_human_resources description: |- 특정 전문 분야의 인물을 검색하기 위한 부서 필드입니다. 자세한 내용은 필터 탭의 `department` 엔드포인트를 참조하세요. functions: type: array items: type: string example: - human_resources description: |- 직무 기능 필드는 특정 직책이나 전문 분야를 지정해 인물을 검색할 때 사용합니다. 자세한 내용은 필터 탭의 `department functions` 엔드포인트를 참조하세요. employees: type: array items: type: array items: type: string example: - - 1 - 10 - - 11 - 20 - - 10001 description: >- 회사 직원 수 범위입니다. 총 직원 수를 기준으로 회사를 필터링할 수 있으며, 여러 범위를 추가해 검색 결과를 확장할 수 있습니다. 자세한 내용은 필터 탭의 `company size` 엔드포인트를 참조하세요. people_locations: type: array items: type: string example: - US - SG - CN description: 사용자 위치입니다. 자세한 내용은 필터 탭의 `location` 엔드포인트를 참고하세요. company_locations: type: array items: type: string example: - US - SG - CN description: 회사 본사 위치입니다. 자세한 내용은 필터 탭의 `location` 엔드포인트를 참고하세요. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- LinkedIn 회사 페이지의 전체 URL입니다. `http`로 시작하며 `linkedin.com/company/`를 포함해야 합니다. people_linkedin_urls: type: array items: type: string example: - http://www.linkedin.com/in/king-lai-605382b7 description: >- LinkedIn 사용자 프로필의 전체 URL입니다. `http`로 시작하며 `linkedin.com/in/` 또는 `linkedin.com/pub/`을 포함해야 합니다. companies: type: array items: type: string format: uuid description: 회사 및 인물 조회 작업을 위한 고유 식별자(domain_search_id) 목록. domains: type: array items: type: string example: - pubrio.com description: >- 회사 및 인물 조회 작업에 사용되는 회사 도메인 목록입니다. 입력된 주소가 `www.pubrio.com` 또는 `https://docs.pubrio.com/`인 경우, 시스템은 이를 자동으로 `pubrio.com`으로 변환하여 처리합니다. company_filters: type: object description: >- 회사 수준 필터의 래퍼 객체. 권장 그룹화 — 어떤 키가 *인물* 을 필터하고(최상위) 어떤 키가 *회사* 를 필터하는지를 시각적으로 분리합니다. 최상위 회사 필터와 동일한 키를 받습니다(예: `technologies`、`verticals`、`vertical_categories`、`vertical_sub_categories`、`categories`、`keywords`、`founded_dates`、`employees`、`revenues`、`company_locations`、`company_exclude_locations`、`company_places`、`company_exclude_places`、`companies`、`domains`、`company_linkedin_urls`、`is_enable_similarity_search`、`similarity_score` 그리고 `filter_conditions`). 엔진은 처리 전에 이 객체를 최상위로 평탄화합니다 — 동일 키가 있으면 최상위 키가 우선합니다. Monitor `company_filters` 와 같은 형태입니다. 예시는 필터 개요 개발자 가이드를 참조하세요. example: company_locations: - US technologies: - 37 - 152 founded_dates: - 2015 - 2023 filter_conditions: - key: technologies operator: and people_filter_conditions: type: array items: type: object properties: key: type: string enum: - keywords - verticals - vertical_categories - vertical_sub_categories - technologies - categories - places - exclude_places - social_media example: technologies description: >- 연산자를 적용할 필터 키. 통합 회사 필터 이름을 참조합니다(`company_places` 가 아니라 `places` 를 사용). operator: type: string enum: - or - and example: and description: 적용할 논리 연산자입니다. 지정된 값 중 하나와 일치하려면 'or'를, 모든 값과 일치하려면 'and'를 사용합니다. description: >- /people/search 의 필터에 대한 키별 AND/OR 재정의. 생략 시 기본값은 OR. 전체 키 리매핑 레퍼런스는 “인물 + 회사 필터” 개발자 가이드를 참조하세요. is_enable_similarity_search: type: boolean description: 활성화 시, 유사도 검색을 지원하는 필터에서 자유 텍스트로 특정 ID를 조회할 수 있습니다. similarity_score: type: number format: float example: 0.7 description: >- `is_enable_similarity_search`와 함께 사용됩니다. 이 값은 특정 slug(예: 산업, 기술)와 사용자 입력 간의 유사도를 분석하며, 값이 높을수록 일치율이 더 정확합니다. per_page: type: integer example: 25 description: 페이지당 반환할 검색 결과 수입니다. 결과 수를 제한하면 API 성능이 향상됩니다. page: type: integer example: 1 description: 조회할 데이터 페이지 번호입니다. 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 ````