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 엔드포인트를 참조하세요.

예시:
location_ids
integer[]

Pubrio location_id로 지정한 공고 국가(Locations 엔드포인트, 각 행에도 포함). locations의 대안.

예시:
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와 같이 유사한 용어를 포함한 결과도 반환될 수 있습니다.

예시:
functions
string[]

직책명에서 도출한 직무 슬러그(예: engineering, sales, marketing, finance, product_management) 또는 software_development 같은 부서 직무 슬러그이며, 대소문자를 구분하지 않습니다. 알 수 없는 슬러그는 아무것도 일치하지 않습니다. 전체 목록은 열거값 및 상수.

예시:
departments
string[]

부서 슬러그 또는 이름(예: master_sales, Sales, 대소문자 무관)이며 부서에서 가져옵니다. 직책명이 이 중 하나에 해당하는 채용 공고와 일치하며, 카탈로그에 없는 값은 아무것도 일치하지 않습니다.

예시:
exclude_departments
string[]

제외할 부서 슬러그 또는 이름입니다. 부서가 없는 채용 공고는 유지됩니다.

예시:
seniority_ranks
enum<integer>[]

직책명에서 해석한 직급: 1 주니어, 2 시니어, 3 매니저, 4 디렉터, 5 임원. 1–5 밖의 값은 아무것도 일치하지 않습니다. 각 행은 seniority_rank에 계층을 반환합니다(0 = 미분류).

사용 가능한 옵션:
1,
2,
3,
4,
5
예시:
posted_dates
string[]

게시 날짜 범위입니다. 최대값은 오늘 날짜입니다. 날짜 경계는 워크스페이스 시간대를 따릅니다.

예시:
launch_dates
string<date>[]

게시일에 대한 양끝 포함 [from, to](UTC). posting_date를 쓰고, 없으면 수집일을 씁니다. 채용 인사이트의 집계 방식과 일치합니다. 날짜 하나면 그 하루와 일치.

Required array length: 1 - 2 elements
예시:
created_at
string<date-time>

이 시각 이후에 수집됨(UTC). 날짜 또는 ISO 타임스탬프. 증분 동기화에서는 저장한 최신 행의 created_at을 전달하세요.

예시:

"2026-09-02T12:00:00Z"

is_realtime_enrichment
boolean
기본값:false

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

예시:

true

is_ascending_order
boolean
기본값:false

정렬 방향입니다. 기본값은 최신순이며 true로 설정하면 오래된 순으로 반환합니다. 이 엔드포인트에는 sort_by가 없으며, 정렬 키는 고정되어 엔드포인트 설명에 명시되어 있습니다.

예시:

false

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

요청 컨텍스트입니다.

data
object
마지막 수정일 2025년 12월 8일