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
예시:
momentum
enum<string>[]

해당 시장에서 기업의 추세입니다. advancing은 전진, steady는 유지, pulling_back은 축소와 철수를 포괄합니다.

여기에 Expansion Referencedirections 값을 사용하지 마세요. 해당 값(advancing, steady, retreating, new)은 stage.direction으로 반환되는 응답 값이며, 필터로 허용되는 것은 위의 세 가지뿐입니다. retreating이나 new를 전달하면 필터가 조용히 비활성화되어 필터링되지 않은 결과가 반환됩니다.

사용 가능한 옵션:
accelerating,
advancing,
steady,
pulling_back
예시:
freshness
enum<string>[]

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

사용 가능한 옵션:
fresh,
cooling,
stale,
cold
예시:
scopes
enum<string>[]

시장 진입 범위로 필터링합니다.

사용 가능한 옵션:
entering_new_market,
expanding_within_presence,
established_only
예시:
ahead_of_pace
boolean

해당 시장의 일반적인 속도보다 빠르게 움직이는 회사/시장 쌍으로 제한합니다.

예시:

false

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

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[]

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

예시:
transitioned_dates
string<date>[]

표시 윈도우(지도, 흐름, 관심 목록 타임라인)의 ISO 날짜 범위 [start, end]입니다. 기본값은 최근 90일입니다. new_transitions_30d KPI는 이 범위와 무관하게 항상 자체 고정 30일 윈도우를 사용합니다.

예시:
window_days
integer

선택 사항. 롤링 윈도우의 일수입니다. 명시적인 transitioned_dates 범위가 제공되지 않을 때 사용되며, 둘 다 생략하면 기본 윈도우가 사용됩니다.

예시:

90

min_markets
integer

해당 기간 내에 회사가 진입해야 하는 신규 시장의 최소 개수입니다(광범위 확장 기업).

예시:

3

home_country_code
string[]

회사의 본국으로 필터링합니다(ISO 3166-1 alpha-2). froms와 함께 제공되면 교집합이 적용됩니다.

예시:
industries
string[]

산업 이름으로 필터링합니다(자유 텍스트 매칭).

예시:
exclude_industries
string[]

제외할 산업입니다(자유 텍스트 매칭).

예시:
select_size
integer

반환할 시장의 최대 개수입니다(플랜별 상한 적용).

예시:

250

flows_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
object

대시보드 컨테이너: 순위가 매겨진 시장과 상위 코리도 흐름입니다. 더 이상 사용되지 않는 레거시 미러입니다. data 안의 각 컨테이너는 구형 클라이언트를 위해 최상위에도 함께 출력됩니다(countries, top_flows, picks_aggregate, watchlist_markets, watchlist_timeline). data에서 읽으세요. 최상위 복사본은 제거될 예정입니다.