메인 콘텐츠로 건너뛰기
POST
/
expansions
/
companies
/
rankings
확장 순위
curl --request POST \
  --url https://api.pubrio.com/expansions/companies/rankings \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "froms": [
    "US",
    "GB"
  ],
  "tos": [
    "US",
    "GB"
  ],
  "exclude_froms": [
    "US",
    "GB"
  ],
  "exclude_tos": [
    "US",
    "GB"
  ],
  "stages": [
    "committing",
    "expanding"
  ],
  "signal_types": [
    "EXEC",
    "HIRE"
  ],
  "signal_strengths": [
    "high",
    "very_high"
  ],
  "min_signal_count": 3,
  "only_contraction": false,
  "domain_search_id_list": [
    "550e8400-e29b-41d4-a716-446655440002"
  ],
  "verticals": [
    123
  ],
  "vertical_categories": [
    123
  ],
  "vertical_sub_categories": [
    123
  ],
  "technologies": [
    123
  ],
  "employees": [
    [
      1,
      10
    ],
    [
      11,
      20
    ],
    [
      10001
    ]
  ],
  "revenues": [
    0,
    100000
  ],
  "founded_dates": [
    2018,
    2024
  ],
  "keywords": [
    "ecommerce",
    "ai",
    "fintech"
  ],
  "companies": [
    "stripe.com",
    "https://www.linkedin.com/company/airbnb",
    "550e8400-e29b-41d4-a716-446655440000"
  ],
  "job_locations": [
    "US",
    "SG",
    "CN"
  ],
  "job_exclude_locations": [
    "CN",
    "US",
    "RU",
    "CA"
  ],
  "job_posted_dates": [
    "2025-01-01",
    "2025-01-10"
  ],
  "job_titles": [
    "sales manager",
    "marketing manager"
  ],
  "advertisement_target_locations": [
    "TW",
    "AE",
    "NO"
  ],
  "advertisement_exclude_target_locations": [
    "IS",
    "GB",
    "FR",
    "IE",
    "ES"
  ],
  "advertisement_search_terms": [
    "asus"
  ],
  "advertisement_start_dates": [
    "2025-12-25",
    "2025-12-25"
  ],
  "advertisement_end_dates": [
    "2025-12-25",
    "2025-12-25"
  ],
  "news_categories": [
    "launches"
  ],
  "news_published_dates": [
    "2025-01-01",
    "2025-01-10"
  ],
  "is_include_established": false,
  "select_size": 50,
  "profile_id": 123
}
'
import requests

url = "https://api.pubrio.com/expansions/companies/rankings"

payload = {
    "froms": ["US", "GB"],
    "tos": ["US", "GB"],
    "exclude_froms": ["US", "GB"],
    "exclude_tos": ["US", "GB"],
    "stages": ["committing", "expanding"],
    "signal_types": ["EXEC", "HIRE"],
    "signal_strengths": ["high", "very_high"],
    "min_signal_count": 3,
    "only_contraction": False,
    "domain_search_id_list": ["550e8400-e29b-41d4-a716-446655440002"],
    "verticals": [123],
    "vertical_categories": [123],
    "vertical_sub_categories": [123],
    "technologies": [123],
    "employees": [[1, 10], [11, 20], [10001]],
    "revenues": [0, 100000],
    "founded_dates": [2018, 2024],
    "keywords": ["ecommerce", "ai", "fintech"],
    "companies": ["stripe.com", "https://www.linkedin.com/company/airbnb", "550e8400-e29b-41d4-a716-446655440000"],
    "job_locations": ["US", "SG", "CN"],
    "job_exclude_locations": ["CN", "US", "RU", "CA"],
    "job_posted_dates": ["2025-01-01", "2025-01-10"],
    "job_titles": ["sales manager", "marketing manager"],
    "advertisement_target_locations": ["TW", "AE", "NO"],
    "advertisement_exclude_target_locations": ["IS", "GB", "FR", "IE", "ES"],
    "advertisement_search_terms": ["asus"],
    "advertisement_start_dates": ["2025-12-25", "2025-12-25"],
    "advertisement_end_dates": ["2025-12-25", "2025-12-25"],
    "news_categories": ["launches"],
    "news_published_dates": ["2025-01-01", "2025-01-10"],
    "is_include_established": False,
    "select_size": 50,
    "profile_id": 123
}
headers = {
    "pubrio-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {'pubrio-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    froms: ['US', 'GB'],
    tos: ['US', 'GB'],
    exclude_froms: ['US', 'GB'],
    exclude_tos: ['US', 'GB'],
    stages: ['committing', 'expanding'],
    signal_types: ['EXEC', 'HIRE'],
    signal_strengths: ['high', 'very_high'],
    min_signal_count: 3,
    only_contraction: false,
    domain_search_id_list: ['550e8400-e29b-41d4-a716-446655440002'],
    verticals: [123],
    vertical_categories: [123],
    vertical_sub_categories: [123],
    technologies: [123],
    employees: [[1, 10], [11, 20], [10001]],
    revenues: [0, 100000],
    founded_dates: [2018, 2024],
    keywords: ['ecommerce', 'ai', 'fintech'],
    companies: [
      'stripe.com',
      'https://www.linkedin.com/company/airbnb',
      '550e8400-e29b-41d4-a716-446655440000'
    ],
    job_locations: ['US', 'SG', 'CN'],
    job_exclude_locations: ['CN', 'US', 'RU', 'CA'],
    job_posted_dates: ['2025-01-01', '2025-01-10'],
    job_titles: ['sales manager', 'marketing manager'],
    advertisement_target_locations: ['TW', 'AE', 'NO'],
    advertisement_exclude_target_locations: ['IS', 'GB', 'FR', 'IE', 'ES'],
    advertisement_search_terms: ['asus'],
    advertisement_start_dates: ['2025-12-25', '2025-12-25'],
    advertisement_end_dates: ['2025-12-25', '2025-12-25'],
    news_categories: ['launches'],
    news_published_dates: ['2025-01-01', '2025-01-10'],
    is_include_established: false,
    select_size: 50,
    profile_id: 123
  })
};

fetch('https://api.pubrio.com/expansions/companies/rankings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.pubrio.com/expansions/companies/rankings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'froms' => [
        'US',
        'GB'
    ],
    'tos' => [
        'US',
        'GB'
    ],
    'exclude_froms' => [
        'US',
        'GB'
    ],
    'exclude_tos' => [
        'US',
        'GB'
    ],
    'stages' => [
        'committing',
        'expanding'
    ],
    'signal_types' => [
        'EXEC',
        'HIRE'
    ],
    'signal_strengths' => [
        'high',
        'very_high'
    ],
    'min_signal_count' => 3,
    'only_contraction' => false,
    'domain_search_id_list' => [
        '550e8400-e29b-41d4-a716-446655440002'
    ],
    'verticals' => [
        123
    ],
    'vertical_categories' => [
        123
    ],
    'vertical_sub_categories' => [
        123
    ],
    'technologies' => [
        123
    ],
    'employees' => [
        [
                1,
                10
        ],
        [
                11,
                20
        ],
        [
                10001
        ]
    ],
    'revenues' => [
        0,
        100000
    ],
    'founded_dates' => [
        2018,
        2024
    ],
    'keywords' => [
        'ecommerce',
        'ai',
        'fintech'
    ],
    'companies' => [
        'stripe.com',
        'https://www.linkedin.com/company/airbnb',
        '550e8400-e29b-41d4-a716-446655440000'
    ],
    'job_locations' => [
        'US',
        'SG',
        'CN'
    ],
    'job_exclude_locations' => [
        'CN',
        'US',
        'RU',
        'CA'
    ],
    'job_posted_dates' => [
        '2025-01-01',
        '2025-01-10'
    ],
    'job_titles' => [
        'sales manager',
        'marketing manager'
    ],
    'advertisement_target_locations' => [
        'TW',
        'AE',
        'NO'
    ],
    'advertisement_exclude_target_locations' => [
        'IS',
        'GB',
        'FR',
        'IE',
        'ES'
    ],
    'advertisement_search_terms' => [
        'asus'
    ],
    'advertisement_start_dates' => [
        '2025-12-25',
        '2025-12-25'
    ],
    'advertisement_end_dates' => [
        '2025-12-25',
        '2025-12-25'
    ],
    'news_categories' => [
        'launches'
    ],
    'news_published_dates' => [
        '2025-01-01',
        '2025-01-10'
    ],
    'is_include_established' => false,
    'select_size' => 50,
    'profile_id' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "pubrio-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pubrio.com/expansions/companies/rankings"

	payload := strings.NewReader("{\n  \"froms\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"tos\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"exclude_froms\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"exclude_tos\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"stages\": [\n    \"committing\",\n    \"expanding\"\n  ],\n  \"signal_types\": [\n    \"EXEC\",\n    \"HIRE\"\n  ],\n  \"signal_strengths\": [\n    \"high\",\n    \"very_high\"\n  ],\n  \"min_signal_count\": 3,\n  \"only_contraction\": false,\n  \"domain_search_id_list\": [\n    \"550e8400-e29b-41d4-a716-446655440002\"\n  ],\n  \"verticals\": [\n    123\n  ],\n  \"vertical_categories\": [\n    123\n  ],\n  \"vertical_sub_categories\": [\n    123\n  ],\n  \"technologies\": [\n    123\n  ],\n  \"employees\": [\n    [\n      1,\n      10\n    ],\n    [\n      11,\n      20\n    ],\n    [\n      10001\n    ]\n  ],\n  \"revenues\": [\n    0,\n    100000\n  ],\n  \"founded_dates\": [\n    2018,\n    2024\n  ],\n  \"keywords\": [\n    \"ecommerce\",\n    \"ai\",\n    \"fintech\"\n  ],\n  \"companies\": [\n    \"stripe.com\",\n    \"https://www.linkedin.com/company/airbnb\",\n    \"550e8400-e29b-41d4-a716-446655440000\"\n  ],\n  \"job_locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"job_exclude_locations\": [\n    \"CN\",\n    \"US\",\n    \"RU\",\n    \"CA\"\n  ],\n  \"job_posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"job_titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"advertisement_target_locations\": [\n    \"TW\",\n    \"AE\",\n    \"NO\"\n  ],\n  \"advertisement_exclude_target_locations\": [\n    \"IS\",\n    \"GB\",\n    \"FR\",\n    \"IE\",\n    \"ES\"\n  ],\n  \"advertisement_search_terms\": [\n    \"asus\"\n  ],\n  \"advertisement_start_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"advertisement_end_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"news_categories\": [\n    \"launches\"\n  ],\n  \"news_published_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"is_include_established\": false,\n  \"select_size\": 50,\n  \"profile_id\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("pubrio-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.pubrio.com/expansions/companies/rankings")
  .header("pubrio-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"froms\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"tos\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"exclude_froms\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"exclude_tos\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"stages\": [\n    \"committing\",\n    \"expanding\"\n  ],\n  \"signal_types\": [\n    \"EXEC\",\n    \"HIRE\"\n  ],\n  \"signal_strengths\": [\n    \"high\",\n    \"very_high\"\n  ],\n  \"min_signal_count\": 3,\n  \"only_contraction\": false,\n  \"domain_search_id_list\": [\n    \"550e8400-e29b-41d4-a716-446655440002\"\n  ],\n  \"verticals\": [\n    123\n  ],\n  \"vertical_categories\": [\n    123\n  ],\n  \"vertical_sub_categories\": [\n    123\n  ],\n  \"technologies\": [\n    123\n  ],\n  \"employees\": [\n    [\n      1,\n      10\n    ],\n    [\n      11,\n      20\n    ],\n    [\n      10001\n    ]\n  ],\n  \"revenues\": [\n    0,\n    100000\n  ],\n  \"founded_dates\": [\n    2018,\n    2024\n  ],\n  \"keywords\": [\n    \"ecommerce\",\n    \"ai\",\n    \"fintech\"\n  ],\n  \"companies\": [\n    \"stripe.com\",\n    \"https://www.linkedin.com/company/airbnb\",\n    \"550e8400-e29b-41d4-a716-446655440000\"\n  ],\n  \"job_locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"job_exclude_locations\": [\n    \"CN\",\n    \"US\",\n    \"RU\",\n    \"CA\"\n  ],\n  \"job_posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"job_titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"advertisement_target_locations\": [\n    \"TW\",\n    \"AE\",\n    \"NO\"\n  ],\n  \"advertisement_exclude_target_locations\": [\n    \"IS\",\n    \"GB\",\n    \"FR\",\n    \"IE\",\n    \"ES\"\n  ],\n  \"advertisement_search_terms\": [\n    \"asus\"\n  ],\n  \"advertisement_start_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"advertisement_end_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"news_categories\": [\n    \"launches\"\n  ],\n  \"news_published_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"is_include_established\": false,\n  \"select_size\": 50,\n  \"profile_id\": 123\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.pubrio.com/expansions/companies/rankings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["pubrio-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"froms\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"tos\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"exclude_froms\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"exclude_tos\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"stages\": [\n    \"committing\",\n    \"expanding\"\n  ],\n  \"signal_types\": [\n    \"EXEC\",\n    \"HIRE\"\n  ],\n  \"signal_strengths\": [\n    \"high\",\n    \"very_high\"\n  ],\n  \"min_signal_count\": 3,\n  \"only_contraction\": false,\n  \"domain_search_id_list\": [\n    \"550e8400-e29b-41d4-a716-446655440002\"\n  ],\n  \"verticals\": [\n    123\n  ],\n  \"vertical_categories\": [\n    123\n  ],\n  \"vertical_sub_categories\": [\n    123\n  ],\n  \"technologies\": [\n    123\n  ],\n  \"employees\": [\n    [\n      1,\n      10\n    ],\n    [\n      11,\n      20\n    ],\n    [\n      10001\n    ]\n  ],\n  \"revenues\": [\n    0,\n    100000\n  ],\n  \"founded_dates\": [\n    2018,\n    2024\n  ],\n  \"keywords\": [\n    \"ecommerce\",\n    \"ai\",\n    \"fintech\"\n  ],\n  \"companies\": [\n    \"stripe.com\",\n    \"https://www.linkedin.com/company/airbnb\",\n    \"550e8400-e29b-41d4-a716-446655440000\"\n  ],\n  \"job_locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"job_exclude_locations\": [\n    \"CN\",\n    \"US\",\n    \"RU\",\n    \"CA\"\n  ],\n  \"job_posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"job_titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"advertisement_target_locations\": [\n    \"TW\",\n    \"AE\",\n    \"NO\"\n  ],\n  \"advertisement_exclude_target_locations\": [\n    \"IS\",\n    \"GB\",\n    \"FR\",\n    \"IE\",\n    \"ES\"\n  ],\n  \"advertisement_search_terms\": [\n    \"asus\"\n  ],\n  \"advertisement_start_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"advertisement_end_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"news_categories\": [\n    \"launches\"\n  ],\n  \"news_published_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"is_include_established\": false,\n  \"select_size\": 50,\n  \"profile_id\": 123\n}"

response = http.request(request)
puts response.read_body
{
  "metadata": {
    "filters": {
      "froms": [
        "CN"
      ],
      "tos": [
        "GB"
      ]
    },
    "select_size": 250,
    "count": 1
  },
  "data": {
    "markers": [
      {
        "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
        "country_code": "US",
        "stage_slug": "expanding",
        "expansion_score": 0.721,
        "freshness": "fresh",
        "direction": "advancing"
      }
    ]
  }
}

인증

pubrio-api-key
string
header
필수

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

본문

application/json
froms
string[]

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

예시:
["US", "GB"]
tos
string[]

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

예시:
["US", "GB"]
exclude_froms
string[]

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

예시:
["US", "GB"]
exclude_tos
string[]

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

예시:
["US", "GB"]
stages
enum<string>[]

하나 이상의 확장 단계로 필터링합니다. 단계 정의는 Expansion Signals 지식 베이스를 참고하세요.

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

특정 신호 유형으로 필터링합니다.

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

신호 강도 구간으로 필터링합니다.

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

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

예시:

3

only_contraction
boolean

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

예시:

false

domain_search_id_list
string[]

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

예시:
["550e8400-e29b-41d4-a716-446655440002"]
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 엔드포인트를 참조하세요.

예시:
[[1, 10], [11, 20], [10001]]
revenues
integer[]

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

예시:
[0, 100000]
founded_dates
integer[]

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

예시:
[2018, 2024]
keywords
string[]

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

예시:
["ecommerce", "ai", "fintech"]
companies
string[]

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

예시:
[
  "stripe.com",
  "https://www.linkedin.com/company/airbnb",
  "550e8400-e29b-41d4-a716-446655440000"
]
job_locations
string[]

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

예시:
["US", "SG", "CN"]
job_exclude_locations
string[]

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

예시:
["CN", "US", "RU", "CA"]
job_posted_dates
string[]

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

예시:
["2025-01-01", "2025-01-10"]
job_titles
string[]

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

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

예시:
["sales manager", "marketing manager"]
advertisement_target_locations
string[]

광고의 대상 지리적 위치.

예시:
["TW", "AE", "NO"]
advertisement_exclude_target_locations
string[]

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

예시:
["IS", "GB", "FR", "IE", "ES"]
advertisement_search_terms
string[]

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

예시:
["asus"]
advertisement_start_dates
string<date>[]

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

예시:
["2025-12-25", "2025-12-25"]
advertisement_end_dates
string<date>[]

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

예시:
["2025-12-25", "2025-12-25"]
news_categories
string[]

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

예시:
["launches"]
news_published_dates
string[]

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

예시:
["2025-01-01", "2025-01-10"]
is_include_established
boolean

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

예시:

false

select_size
integer

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

예시:

50

profile_id
integer

선택 사항. 요청을 수행하는 팀 식별자입니다. API 키에 이미 워크스페이스 정보가 포함되어 있으므로 이 매개변수는 더 이상 필수가 아닙니다. 제공되면 조회 및 사용 크레딧 추적을 위해 특정 팀(작업 공간)과 연계됩니다.

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

응답

200 - application/json

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

metadata
object
data
any