Skip to main content
POST
채용 공고 검색

인증

pubrio-api-key
string
header
필수

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

본문

application/json
locations
string[]

ISO 3166-1 alpha-2(cca2) 코드로 지역을 필터링하는 데 사용됩니다. 자세한 내용은 필터 탭의 location 엔드포인트를 참조하세요.

예시:
exclude_locations
string[]

채용 결과에서 제외할 ISO 3166-1 alpha-2 (cca2) 지역 코드입니다. 유효한 코드는 필터 탭의 location 엔드포인트를 참조하세요.

예시:
company_locations
string[]

회사 본사 위치입니다. 자세한 내용은 필터 탭의 location 엔드포인트를 참고하세요.

예시:
companies
string<uuid>[]

회사 및 인물 조회 작업을 위한 고유 식별자(domain_search_id) 목록.

domains
string[]

회사 및 인물 조회 작업에 사용되는 회사 도메인 목록입니다. 입력된 주소가 www.pubrio.com 또는 https://docs.pubrio.com/인 경우, 시스템은 이를 자동으로 pubrio.com으로 변환하여 처리합니다.

예시:
linkedin_urls
string[]

LinkedIn 회사 페이지의 전체 URL입니다. http로 시작하며 linkedin.com/company/를 포함해야 합니다.

예시:
search_term
string

결과를 필터링하기 위한 키워드 문자열입니다.

예시:

"pubrio"

search_terms
string[]

채용 공고를 필터링하기 위한 키워드 문자열 배열입니다. 각 키워드는 채용 내용과 매칭됩니다. 단일 문자열에는 search_term을, 여러 키워드에는 search_terms를 사용하세요.

예시:
titles
string[]

검색 대상 인물의 직함입니다.

software engineer를 검색하면 senior software engineer와 같이 유사한 용어를 포함한 결과도 반환될 수 있습니다.

예시:
posted_dates
string[]

게시 날짜 범위입니다. 최대값은 오늘 날짜입니다.

예시:
is_realtime_enrichment
boolean
기본값:false

단일 회사 범위 쿼리(즉, domain_search_id, domains, 또는 linkedin_urls 로 필터링됨)에서 실시간 보강을 활성화합니다. 초기 검색 결과가 0건일 때 엔드포인트가 소스를 스크랩해 레코드를 저장한 뒤 검색을 다시 실행하고 응답합니다. 라우트별 데드라인이 적용됩니다.

예시:

true

per_page
integer
기본값:25

페이지당 레코드 수입니다. 기본값은 25이며 대부분의 플랜에서 상한이기도 합니다. 이 한도는 구독의 max_search_per_page이며 Profile에서 확인할 수 있습니다. 초과하면 결과가 잘리는 것이 아니라 HTTP 416과 코드 41676(기업·인물 검색은 41613)이 반환됩니다.

필수 범위: x <= 25
예시:

25

page
integer
기본값:1

페이지 번호이며 1부터 시작합니다. 상한은 구독의 max_search_page(기업 검색은 max_company_search_page)이며 Profile에서 확인할 수 있습니다. 초과하면 HTTP 416이 반환됩니다.

예시:

1

응답

관련 세부 정보가 포함된 성공적인 응답입니다.

metadata
object

요청 컨텍스트: 반향된 filterscredit, topup_credit, total_credit_cost를 포함하는 profile 블록입니다.

data
object | null

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