Skip to main content
POST
기업 검색

인증

pubrio-api-key
string
header
필수

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

본문

application/json
company_name
string

검색 결과를 지정된 회사 이름으로 필터링합니다.

입력값이 회사명과 일치하지 않으면, 다른 조건이 맞더라도 결과에 표시되지 않습니다. 부분 일치를 지원합니다.

예시:

"pubrio"

companies
string<uuid>[]

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

company_groups
integer[]

이 회사 그룹(ID)의 구성원으로 제한합니다. 예: 모니터의 source_group_id 또는 excluded_group_id. 다른 검색처럼 페이지로 나뉩니다.

domains
string[]

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

예시:
linkedin_urls
string[]

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

예시:
company_filters
object

회사 수준 필터의 래퍼 객체. 권장 그룹화 — 어떤 키가 인물 을 필터하고(최상위) 어떤 키가 회사 를 필터하는지를 시각적으로 분리합니다. 최상위 회사 필터와 동일한 키를 받습니다(예: technologies、verticals、vertical_categories、vertical_sub_categories、categories、keywords、founded_dates、employees、revenues、company_locations、company_exclude_locations、company_places、company_exclude_places、companies、domains、company_linkedin_urls、is_enable_similarity_search、similarity_score 그리고 filter_conditions). 엔진은 처리 전에 이 객체를 최상위로 평탄화합니다 — 동일 키가 있으면 최상위 키가 우선합니다. Monitor company_filters 와 같은 형태입니다. 예시는 필터 개요 개발자 가이드를 참조하세요.

예시:
locations
string[]

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

예시:
exclude_locations
string[]

반환하지 않을 지역을 ISO 3166-1 alpha-2(cca2) 코드로 지정합니다. 자세한 내용은 필터 탭의 location 엔드포인트를 참조하세요.

예시:
places
string[]

결과를 필터링하는 데 사용되는 장소 이름(도시, 지역)입니다. 현지화되거나 영어 장소 이름을 허용합니다.

예시:
exclude_places
string[]

결과에서 제외할 장소 이름(도시, 지역)입니다. 현지화되거나 영어 장소 이름을 허용합니다.

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

예시:
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"]와 같은 자유 텍스트 검색이 가능합니다.

categories
integer[]

category_id 목록으로, 특정 기술 카테고리를 사용하는 회사를 검색합니다. ID를 얻으려면 필터 탭의 category 엔드포인트를 호출하세요.

이 필터는 is_enable_similarity_search를 지원하며, 활성화 시 ["CDN"]처럼 자유 텍스트를 입력할 수 있습니다.

technologies
integer[]

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

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

기술 목록에 있는 제품 이름은 해당 제품과 그 자사 제품에 일치합니다("Salesforce"는 Salesforce Desk와 Salesforce Service Cloud에도 일치). 비슷한 다른 제품에는 일치하지 않으며, 그 밖의 텍스트는 유사도로 일치합니다.

exclude_technologies
string[]

회사가 사용하지 않아야 하는 기술로, tag_id 또는 is_enable_similarity_search를 켠 경우 ["Shopify"] 같은 이름으로 지정합니다. 알려진 기술이 없는 회사는 유지됩니다.

예시:
employees
string[][]

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

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

예시:
revenues
integer[]

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

예시:
founded_dates
integer[]

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

예시:
keywords
string[]

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

예시:
social_media
enum<string>[]

다음 중 하나에 프로필이 있는 회사: linkedin, facebook, instagram, tiktok, twitter, x, github, wantedly, rocketpunch. filter_conditions로 AND로 승격할 수 있습니다.

사용 가능한 옵션:
linkedin,
facebook,
instagram,
tiktok,
twitter,
x,
github,
wantedly,
rocketpunch
예시:
news_categories
string[]

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

예시:
news_published_dates
string[]

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

예시:
advertisement_search_terms
string[]

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

예시:
advertisement_target_locations
string[]

광고의 대상 지리적 위치.

예시:
advertisement_exclude_target_locations
string[]

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

예시:
advertisement_start_dates
string<date>[]

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

예시:
advertisement_end_dates
string<date>[]

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

예시:
advertisement_active_dates
string<date>[]

이 날짜 범위 중 한 시점이라도 게재 중이었던 광고를 찾습니다(중첩 기준 — 범위 시작 전에 게재를 시작해 계속 게재 중인 광고도 포함되며, 범위 안에서 시작한 광고만 포함하는 것이 아닙니다).

예시:
advertisement_status
enum<string>[]

currently_running: 광고 기록이 있는 회사. active_last_30_min: 최근 30분 내 광고에 변화가 있는 회사.

사용 가능한 옵션:
currently_running,
active_last_30_min
예시:
advertisement_headlines
string[]

광고 헤드라인 텍스트 내에서 검색할 키워드입니다.

예시:
advertisement_platforms
enum<string>[]

광고의 출처가 된 광고 라이브러리를 기준으로 필터링합니다. 소문자이며 대소문자를 구분하지 않습니다. meta는 facebook의 별칭으로 허용됩니다.

사용 가능한 옵션:
linkedin,
facebook,
google,
tiktok,
apple
예시:
advertisement_publisher_platforms
enum<string>[]

게재된 플랫폼 노출 위치로 Facebook/Meta 광고를 필터링합니다. 소문자이며 대소문자를 구분하지 않습니다. facebook 소스에만 적용됩니다(다른 소스는 단일 플랫폼).

사용 가능한 옵션:
facebook,
instagram,
messenger,
threads,
audience_network
예시:
advertisement_exclude_publisher_platforms
enum<string>[]

이 플랫폼 노출 위치에서 게재된 Facebook/Meta 광고를 제외합니다.

사용 가능한 옵션:
facebook,
instagram,
messenger,
threads,
audience_network
예시:
advertisement_formats
enum<string>[]

이 크리에이티브 형식 중 하나 이상으로 광고를 집행한 회사를 찾습니다.

사용 가능한 옵션:
image,
video,
text,
carousel,
dynamic_product,
document,
message,
event,
article,
spotlight,
follow,
job,
engagement
예시:
advertisement_active_ads
(integer | null)[]

모든 국가를 통틀어 회사의 현재 활성 광고 수의 최소 및 최대값입니다. 상한 또는 하한을 열어두려면 null을 사용하세요. 예를 들어 [1, null]은 "활성 광고가 하나 이상"을 의미합니다.

Required array length: 2 elements
예시:
advertisement_running_ads
(integer | null)[]

종료일이 없거나 종료일이 미래인, 즉 아직 게재 중인 회사 광고 수의 최소 및 최대값입니다. 현재는 LinkedIn 광고에 대해서만 값이 채워집니다.

Required array length: 2 elements
예시:
advertisement_total_ads
(integer | null)[]

모든 국가를 통틀어 지금까지 기록된 회사의 전체 광고 수의 최소 및 최대값입니다.

Required array length: 2 elements
예시:
advertisement_platform_count
(integer | null)[]

회사가 현재 광고를 집행 중인 서로 다른 광고 플랫폼(linkedin, facebook, google, tiktok, apple) 수의 최소 및 최대값입니다.

Required array length: 2 elements
예시:
advertisement_format_count
(integer | null)[]

회사가 현재 게재 중인 서로 다른 광고 크리에이티브 형식 수의 최소 및 최대값입니다.

Required array length: 2 elements
예시:
advertisement_impressions_estimate
(integer | null)[]

모든 국가를 합산한 예상 광고 노출수의 최소 및 최대값입니다. 노출 범위가 보고된 광고만 집계됩니다.

Required array length: 2 elements
예시:
advertisement_country_activity
object

특정 국가 하나에 대한 광고 활동입니다. country는 필수이며, 그 외 필드 중 최소 하나는 설정해야 합니다(국가만 지정하면 아무것도 매치되지 않습니다). 전체 국가 합계가 필요하다면 최상위의 advertisement_active_ads / advertisement_total_ads / advertisement_impressions_estimate 필터를 대신 사용하세요.

예시:
sort_by
enum<string>

결과 정렬 방식입니다. 생략하면 기본 관련성 순서가 적용됩니다. advertisement_country_rank는 advertisement_country_activity에 지정한 국가 내에서의 회사 광고 순위 기준으로 정렬하며(순위 1 = 해당 시장에서 가장 큰 광고주), 그 필터가 없으면 무시됩니다. is_ascending_order: false와 함께 사용하면 가장 작은 광고주부터 나열됩니다. 아직 지원되지 않음: name(오름차순·내림차순 모두)과 is_ascending_order: false를 지정한 relevance — 해당 요청은 시간이 초과됩니다. 기본 관련성 순서, number_of_employees 또는 founded_year를 사용하세요.

사용 가능한 옵션:
relevance,
name,
number_of_employees,
founded_year,
advertisement_country_rank
예시:

"advertisement_country_rank"

is_ascending_order
boolean

sort_by의 정렬 방향입니다. 기본값은 오름차순이며, advertisement_country_rank의 경우 가장 큰 광고주가 먼저 표시됩니다.

예시:

true

filter_conditions
object[]

회사 검색을 위한 고급 필터링 옵션입니다. 키와 논리 연산자를 결합한 조건을 지정하여 검색 결과를 세분화하세요.

활성화 시, 유사도 검색을 지원하는 필터에서 자유 텍스트로 특정 ID를 조회할 수 있습니다.

similarity_score
number<float>

is_enable_similarity_search와 함께 사용됩니다. 이 값은 특정 slug(예: 산업, 기술)와 사용자 입력 간의 유사도를 분석하며, 값이 높을수록 일치율이 더 정확합니다.

예시:

0.7

query
string

자연어 검색. 제공하면 Pubrio가 아래 회사 필터로 해석합니다: 산업(및 제외할 산업), 전문 분야, 기술(및 사용하지 않는 도구), 소셜 프로필, 본사 국가·지역·도시, 직원 수, 매출, 설립 연도, 채용 중인 직무와 근무지, "최근 확장" 같은 뉴스 이벤트, 광고(플랫폼, 형식, 타깃 국가, 광고 수, 노출 수, 날짜, 특정 국가 내 순위), 클라우드 호스팅(제공업체, 서버 국가와 도시, 호스트·서버 수, 전체 또는 특정 국가 기준). "또는"으로 연결된 값은 그중 하나만 일치하면 되고, "와/과"로 연결된 도구나 프로필("Salesforce와 HubSpot을 모두 사용")은 모두 일치해야 합니다. 함께 전달한 명시적 필터가 해석된 필터보다 우선합니다. 어떤 필터로도 표현할 수 없는 문장 부분(예: 소유 구조)은 버려지지 않고 metadata.unmatched_criteria로 반환되며, 검색할 내용이 없는 문장은 metadata.nl_no_intent: true와 함께 결과 없이 반환됩니다.

예시:

"Food & Beverage companies in Singapore that recently expanded"

exclude_fields
string[]

응답 페이로드에서 제외할 필드 목록입니다.

예시:
is_parameter_metadata_available
boolean

요청에 매개변수 메타데이터가 사용 가능한지 여부를 나타냅니다.

is_profile_metadata_available
boolean

요청에 프로필 메타데이터가 사용 가능한지 여부를 나타냅니다.

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

cloud_footprint_providers
string[]

이 제공업체 중 하나라도 어딘가에서 사용하는 기업. 접두사 없는 providers는 반환 행을, 이것은 기업을 좁힙니다.

예시:
cloud_footprint_exclude_providers
string[]

이 클라우드·호스팅 제공업체과(와) 일치하는 풋프린트 행을 제외합니다. 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다.

예시:
cloud_footprint_target_locations
string[]

풋프린트 어디에서든 이 국가들에 존재하는 기업.

예시:
cloud_footprint_exclude_target_locations
string[]

이 인프라가 위치한 국가 코드과(와) 일치하는 풋프린트 행을 제외합니다.

예시:
cloud_footprint_cloud_regions
string[]

이 클라우드 리전과(와) 일치하는 풋프린트 행만 반환합니다. 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다.

예시:
cloud_footprint_exclude_cloud_regions
string[]

이 클라우드 리전과(와) 일치하는 풋프린트 행을 제외합니다. 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다.

예시:
cloud_footprint_cities
string[]

이 도시과(와) 일치하는 풋프린트 행만 반환합니다. 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다.

예시:
cloud_footprint_exclude_cities
string[]

이 도시과(와) 일치하는 풋프린트 행을 제외합니다. 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다.

예시:
cloud_footprint_first_seen_dates
(string | null)[]

풋프린트가 처음 확인된 시점을 한정하는 두 개의 ISO 8601 날짜(YYYY-MM-DD). 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다.

Required array length: 2 elements
예시:
cloud_footprint_last_seen_dates
(string | null)[]

풋프린트가 마지막으로 확인된 시점을 한정하는 두 개의 ISO 8601 날짜(YYYY-MM-DD). 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다.

Required array length: 2 elements
예시:
cloud_footprint_is_cross_border_only
boolean

true이면 자국 시장 밖의 풋프린트 행만 반환합니다. 본사가 확인되지 않은 기업의 행은 제외됩니다.

예시:

true

cloud_footprint_host_count
(integer | null)[]

호스트 수의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 null을 사용하세요. 모든 제공업체와 국가를 합산한 기업 전체 기준입니다.

Required array length: 2 elements
예시:
cloud_footprint_server_count
(integer | null)[]

서버 수(고유 IP)의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 null을 사용하세요. 모든 제공업체와 국가를 합산한 기업 전체 기준입니다.

Required array length: 2 elements
예시:
cloud_footprint_shared_server_count
(integer | null)[]

타사와 공유하는 서버 수의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 null을 사용하세요. 모든 제공업체와 국가를 합산한 기업 전체 기준입니다.

Required array length: 2 elements
예시:
cloud_footprint_provider_count
(integer | null)[]

기업이 사용하는 제공업체 수의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 null을 사용하세요. 모든 제공업체와 국가를 합산한 기업 전체 기준입니다.

Required array length: 2 elements
예시:
cloud_footprint_country_count
(integer | null)[]

기업이 호스팅하는 국가 수의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 null을 사용하세요. 모든 제공업체와 국가를 합산한 기업 전체 기준입니다.

Required array length: 2 elements
예시:
cloud_footprint_cross_border_country_count
(integer | null)[]

자국 시장 외 국가 수의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 null을 사용하세요. 모든 제공업체와 국가를 합산한 기업 전체 기준입니다.

Required array length: 2 elements
예시:
cloud_footprint_region_count
(integer | null)[]

클라우드 리전 수의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 null을 사용하세요. 모든 제공업체와 국가를 합산한 기업 전체 기준입니다.

Required array length: 2 elements
예시:
cloud_footprint_city_count
(integer | null)[]

도시 수의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 null을 사용하세요. 모든 제공업체와 국가를 합산한 기업 전체 기준입니다.

Required array length: 2 elements
예시:
cloud_footprint_primary_provider
string[]

가장 큰 제공업체가 이들 중 하나인 기업.

예시:
cloud_footprint_country_activity
object

한 국가로 한정한 범위 조건입니다. {"country":"DE","host_count":[100,null]}는 독일에서 호스트 100개 이상을 운영하는 기업을 찾습니다. 접두사만 있는 cloud_footprint_host_count는 전체 국가 합계이므로 둘을 조합해서는 표현할 수 없습니다. country만 주면 거부됩니다.

응답

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

metadata
object

요청 컨텍스트: recent_search_log_identifier, 반환된 parameters와 filters, 선택적 profile 크레딧 블록, ignored_fields(엔드포인트가 제거한 본문 키).

data
object | null

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

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