메인 콘텐츠로 건너뛰기
POST
/
companies
/
jobs
/
search
cURL
curl --request POST \
  --url https://api.pubrio.com/companies/jobs/search \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "profile_id": 123,
  "locations": [
    "US",
    "SG",
    "CN"
  ],
  "company_locations": [
    "US",
    "SG",
    "CN"
  ],
  "companies": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "domains": [
    "pubrio.com"
  ],
  "linkedin_urls": [
    "https://www.linkedin.com/company/pubrio"
  ],
  "search_term": "pubrio",
  "titles": [
    "sales manager",
    "marketing manager"
  ],
  "posted_dates": [
    "2025-01-01",
    "2025-01-10"
  ],
  "per_page": 25,
  "page": 1
}
'
{
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_entries": 2228628,
      "total_pages": 89146,
      "is_timeout": false
    },
    "jobs": [
      {
        "job_id": "371d0c44-4c56-4c9c-98e2-ef6dd986b848",
        "job_search_id": "371d0c44-4c56-4c9c-98e2-ef6dd986b848",
        "last_modified": "2025-05-31T20:41:27.894Z",
        "companies": {
          "logo_url": "https://buckets.pubrio.com/company-logo/OTQxMjYxMTFnb29nbGUuY29tLnBrbGlua2VkaW5fcF9sb2dvMTU=.jpg",
          "domain_search_id": "539e2c34-de6b-4613-8f5b-e3aa18b4ef47",
          "company_name": "Google",
          "linkedin_name": "google",
          "country_code": "US",
          "domain": "google.com"
        },
        "location": "Seoul, Seoul, South Korea",
        "job_url": "https://kr.linkedin.com/jobs/view/software-engineer-greach-program-for-people-with-disabilities-%EC%9E%A5%EC%95%A0%EC%9D%B8-%EC%B1%84%EC%9A%A9-at-google-4224659596?position=7&pageNum=0&refId=DwDpGXGftUql%2FkETvFCwXw%3D%3D&trackingId=gAvrIP0yUQuf8fjK67HSbQ%3D%3D",
        "posting_date": "2025-05-31",
        "country_code": "KR",
        "location_id": 491,
        "title": "Software Engineer, gReach Program for People with Disabilities (장애인 채용)",
        "country": "South Korea"
      },
      "..."
    ]
  }
}

Authorizations

​
pubrio-api-key
string
header
required

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

Body

application/json
​
profile_id
integer
required

요청을 수행하는 팀 식별자입니다. 이 ID는 조회 및 사용 크레딧 추적을 위해 특정 팀(작업 공간)과 연계됩니다.

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

​
locations
string[]

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

Example:
["US", "SG", "CN"]
​
company_locations
string[]

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

Example:
["US", "SG", "CN"]
​
companies
string<uuid>[]

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

​
domains
string[]

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

Example:
["pubrio.com"]
​
linkedin_urls
string[]

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

Example:
["https://www.linkedin.com/company/pubrio"]
​
search_term
string

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

Example:

"pubrio"

​
titles
string[]

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

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

Example:
["sales manager", "marketing manager"]
​
posted_dates
string[]

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

Example:
["2025-01-01", "2025-01-10"]
​
per_page
integer

페이지당 반환할 검색 결과 수입니다. 결과 수를 제한하면 API 성능이 향상됩니다.

Example:

25

​
page
integer

조회할 데이터 페이지 번호입니다.

Example:

1

Response

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

​
data
object

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