Skip to main content
POST
확장 순위

인증

pubrio-api-key
string
header
필수

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

본문

application/json
froms
string[]

출발 시장(ISO 3166-1 alpha-2). 기업이 어디에서부터 확장하는지 — 본사 / 모국. 단독으로 사용하면 이 시장에서 밖으로 확장하는 기업을 찾고, tos와 함께 사용하면 특정 출발→도착 코리도를 지정합니다.

예시:
tos
string[]

도착 시장(ISO 3166-1 alpha-2). 기업이 어디로 확장하는지. 단독으로 사용하면 이 시장에 진입하는 모든 기업을 찾고, froms와 함께 사용하면 특정 출발→도착 코리도를 지정합니다.

예시:
exclude_froms
string[]

제외할 출발 시장(ISO 3166-1 alpha-2).

예시:
exclude_tos
string[]

제외할 도착 시장(ISO 3166-1 alpha-2).

예시:
stages
enum<string>[]

값은 대소문자를 구분하며 검증되지 않습니다. 인식되지 않는 값은 오류가 아니라 조용히 버려집니다. stages, freshness, scopes, momentum에서는 필터 전체가 버려져 필터링되지 않은 결과가 반환되고, signal_typessignal_strengths에서는 필터가 적용되어 아무것도 일치하지 않습니다. 두 경우 모두 응답은 정상으로 보입니다. 유효한 슬러그는 Expansion Reference에서 확인하고, 결과가 이상해 보이면 data.pagination.total_entries를 필터 없는 호출과 비교하세요.

사용 가능한 옵션:
exploring,
committing,
expanding,
scaling,
established
예시:
signal_types
enum<string>[]

값은 대소문자를 구분하며 검증되지 않습니다. 인식되지 않는 값은 오류가 아니라 조용히 버려집니다. stages, freshness, scopes, momentum에서는 필터 전체가 버려져 필터링되지 않은 결과가 반환되고, signal_typessignal_strengths에서는 필터가 적용되어 아무것도 일치하지 않습니다. 두 경우 모두 응답은 정상으로 보입니다. 유효한 슬러그는 Expansion Reference에서 확인하고, 결과가 이상해 보이면 data.pagination.total_entries를 필터 없는 호출과 비교하세요.

사용 가능한 옵션:
AD,
NEWS,
DNS,
INFRA,
PARTNER,
EVENT_PLUS,
EXEC,
OFFICE,
HIRE,
SCALE,
PRODUCT
예시:
signal_strengths
enum<string>[]

값은 대소문자를 구분하며 검증되지 않습니다. 인식되지 않는 값은 오류가 아니라 조용히 버려집니다. stages, freshness, scopes, momentum에서는 필터 전체가 버려져 필터링되지 않은 결과가 반환되고, signal_typessignal_strengths에서는 필터가 적용되어 아무것도 일치하지 않습니다. 두 경우 모두 응답은 정상으로 보입니다. 유효한 슬러그는 Expansion Reference에서 확인하고, 결과가 이상해 보이면 data.pagination.total_entries를 필터 없는 호출과 비교하세요.

사용 가능한 옵션:
low,
medium,
high
예시:
min_signal_count
integer

해당 기간 동안 회사가 보유해야 하는 최소 확장 신호 수입니다 — "매우 활발함 / 활동 범위가 넓음"을 걸러냅니다.

예시:

3

only_contraction
boolean

true인 경우 축소로 표시된 확장만 반환합니다(규모를 축소하는 회사).

예시:

false

domain_search_id_list
string[]

포함할 회사 식별자(domain_search_id UUID).

예시:
verticals
integer[]

vertical_id 목록으로, 특정 산업 또는 분야의 회사를 검색합니다. ID를 얻으려면 필터 탭의 vertical 엔드포인트를 호출하세요.

이 필터는 is_enable_similarity_search를 지원하며, ["AI"]와 같은 자유 텍스트 검색이 가능합니다.

vertical_categories
integer[]

vertical_category_id 목록으로, 특정 산업 카테고리에 속한 회사를 검색합니다. ID를 얻으려면 필터 탭의 vertical category 엔드포인트를 호출하세요.

이 필터는 is_enable_similarity_search를 지원하며 ["Information Technology"]와 같은 텍스트 입력이 가능합니다.

vertical_sub_categories
integer[]

vertical_sub_category_id 목록으로, 특정 산업 하위 카테고리에 속한 회사를 검색합니다. ID를 얻으려면 필터 탭의 vertical sub category 엔드포인트를 호출하세요.

이 필터는 is_enable_similarity_search를 지원하며 ["Software"]와 같은 자유 텍스트 검색이 가능합니다.

technologies
integer[]

tag_id 목록으로, 특정 기술을 사용하는 회사를 검색하는 데 사용됩니다. ID를 얻으려면 필터 탭의 technology 엔드포인트를 호출하세요.

이 필터는 is_enable_similarity_search를 지원하며, 활성화 시 ["Shopify"]와 같은 자유 텍스트 입력이 가능합니다.

employees
string[][]

회사 직원 수 범위입니다. 총 직원 수를 기준으로 회사를 필터링할 수 있으며, 여러 범위를 추가해 검색 결과를 확장할 수 있습니다.

자세한 내용은 필터 탭의 company size 엔드포인트를 참조하세요.

예시:
revenues
integer[]

회사의 최소 및 최대 수익 범위입니다.

예시:
founded_dates
integer[]

회사의 설립 연도 범위입니다. 최대값은 현재 연도입니다.

예시:
keywords
string[]

회사 검색 결과를 관련성, 전문 분야 또는 설명으로 필터링하기 위한 키워드 목록입니다.

예시:
companies
string[]

domain_search_id, 회사 도메인 또는 회사 소셜 미디어 프로필 URL의 임의 조합으로 회사를 지정합니다. 도메인과 URL은 순위가 가장 높은 회사로 확인됩니다.

예시:
job_locations
string[]

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

예시:
job_exclude_locations
string[]

채용 공고 결과에서 제외할 지리적 위치.

예시:
job_posted_dates
string[]

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

예시:
job_titles
string[]

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

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

예시:
advertisement_target_locations
string[]

광고의 대상 지리적 위치.

예시:
advertisement_exclude_target_locations
string[]

광고 타겟팅에서 제외할 지리적 위치.

예시:
advertisement_search_terms
string[]

광고 콘텐츠 또는 제목 내에서 검색하는 데 사용되는 키워드입니다.

예시:
advertisement_start_dates
string<date>[]

광고 필터링을 위한 시작 날짜 범위입니다.

예시:
advertisement_end_dates
string<date>[]

광고 필터링을 위한 종료 날짜 범위입니다.

예시:
news_categories
string[]

category slugs 목록으로, 특정 뉴스 카테고리를 검색합니다. slug를 얻으려면 필터 탭의 news categories 엔드포인트를 호출하세요.

예시:
news_published_dates
string[]

발행 날짜 범위입니다. 최대값은 오늘 날짜입니다.

예시:
is_include_established
boolean

established 단계(활성 확장 신호가 없는 오랜 기간 운영해 온 기업)를 포함합니다. 기본값은 false입니다.

예시:

false

select_size
integer

반환할 최대 레코드 수. 플랜에 따라 상한이 정해집니다.

예시:

50

is_include_metadata
boolean

전체 상세 페이로드를 반환합니다. API 키 트래픽은 기본적으로 경량 응답입니다. 이 값이 true가 아니면 model 블록, 신뢰도 값(기업 확장 상세의 stage.confidence, other_markets[] 및 순위 markers[]confidence_score), 그리고 established_min / share_of_detected / has_known_office 필드가 모두 생략됩니다.

예시:

true

응답

200 - application/json

순위가 매겨진 회사/시장 마커입니다.

metadata
object
data
any