> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 변경 로그

> Pubrio 플랫폼의 최신 업데이트 및 출시 내역.

Pubrio 데이터 레이어의 진화를 추적하세요.

## 2026년 릴리스 (Releases)

<AccordionGroup>
  <Accordion title="v2.4.6 - 인물 검색: 부서를 쓰인 그대로 읽기 (2026년 10월)" defaultOpen>
    * **수정:** [인물 검색](/ko/api-reference/endpoint/people/search)의 `departments`와 `department_functions`에 카탈로그에 없는 값을 보내면 `management_levels`와 마찬가지로 아무도 반환하지 않습니다. 이전에는 필터가 버려져 모든 부서의 인물이 정상적인 `200`으로 반환되었습니다.
    * **API:** [인물 검색](/ko/api-reference/endpoint/people/search)과 [채용 공고 검색](/ko/developer-guides/search/job-search)에서 부서, 직무, 관리 레벨 값은 대소문자, 공백, 구두점을 구분하지 않습니다. `information_technology`는 `master_information_technology`로 읽힙니다. 어떤 항목과도 전체가 일치하지 않는 값은 그 단어를 모두 포함하는 단 하나의 항목으로 읽힙니다. `engineering`은 `master_engineering_technical`로 읽힙니다.
    * **API:** [인물 검색](/ko/api-reference/endpoint/people/search)은 `people_locations`의 다른 이름으로 `person_locations`를 받습니다. 이름 변경은 `metadata.renamed_fields`에 표시됩니다.
  </Accordion>

  <Accordion title="v2.4.5 - 연락처 조회: 스위치 없이 이름으로 검색 (2026년 10월)">
    * **API:** [연락처 조회 - 단일](/ko/api-reference/endpoint/redeem/people/contact/lookup)과 [연락처 조회 - 일괄 처리](/ko/api-reference/endpoint/redeem/people/contact/lookup/batch)는 행에 `email`이나 `phone`이 없으면 항상 `first_name` + `last_name` + `domain` 또는 `company`로 검색합니다. 이러한 행에는 더 이상 `is_enable_similarity_search`가 필요하지 않으며, 이 설정은 이제 이메일이나 전화번호로 아무도 찾지 못한 행을 이름으로도 검색할지만 결정합니다.
    * **API:** `domain`에 `https://www.stripe.com/` 같은 웹사이트를 넣을 수 있으며, `stripe.com`으로 읽힙니다.
    * **수정:** `is_enable_similarity_search` 없이 보낸 이름 + 도메인 행의 일괄 조회가 아무도 매칭되지 않은 것처럼 빈 `peoples` 목록을 반환했습니다. 이제 이메일, 전화번호, 또는 이름 + 도메인/회사명을 가진 항목이 하나도 없는 일괄 요청은 단일 조회와 마찬가지로 `400`으로 거부됩니다.
    * **수정:** 한 일괄 요청에서 두 번 보낸 같은 이름 + 회사명은 `is_duplicate_input`으로 표시되고, 이메일이나 전화번호와 마찬가지로 한 번만 청구됩니다.
    * **API:** 각 매칭에 `match.input_index`(응답하는 `peoples` 항목의 위치)가 포함되어, 일부 행이 매칭되지 않아도 매칭을 원래 행과 연결할 수 있습니다.
    * **수정:** 이름으로 조회할 때 해당 도메인의 모든 회사 레코드를 검색하므로, 같은 회사의 다른 레코드에 연결된 인물도 찾을 수 있고 응답 속도는 약 2배 빨라졌습니다.
  </Accordion>

  <Accordion title="v2.4.4 - 유사 인물 검색: 점수, 필터, 페이징 (2026년 9월)">
    * **API:** [유사 인물 검색](/ko/api-reference/endpoint/people/search_similar)이 각 인물에 0에서 1 사이의 `similarity_score`를 반환하며, `per_page`가 페이지 크기를 정합니다.
    * **수정:** 참조 인물 또는 직함은 유사함의 기준만 정합니다. `people_locations`나 `domains` 같은 그 외 모든 필터는 결과를 좁힙니다. 이전에는 참조 자체가 반환되고 다른 필터는 무시되었습니다.
    * **수정:** [확장 개요](/ko/api-reference/endpoint/expansions/dashboard)가 제시간에 완료되지 못하면 빈 `countries` 목록 대신 `408`을 반환합니다.
    * **수정:** 채용 공고 검색의 `functions`와 광고 검색의 `reach_tiers`는 존재하지 않는 값에 대해 즉시 0건을 반환합니다. 이전에는 시간 초과까지 실행되었습니다.
  </Accordion>

  <Accordion title="v2.3.2 - 검색 필터 레퍼런스 정비 (2026년 9월)">
    * **신규:** [열거값 및 상수](/ko/api-reference/enums) — API가 허용하거나 반환하는 모든 고정값을 한 페이지에: 직급 계층, 직무, 광고 소스와 형식, 도달 구간, 게시 플랫폼, 시그널 유형, 관리 레벨.
    * **신규:** [채용 공고 검색](/ko/developer-guides/search/job-search), [뉴스 검색](/ko/developer-guides/search/news-search), [광고 검색](/ko/developer-guides/search/advertisement-search) 가이드 — 필터 표, 응답 해설, 바로 복사해 쓰는 레시피.
    * **API:** 채용 공고 검색에 `functions`, `seniority_ranks`, `launch_dates`, `location_ids`, `created_at`, `is_ascending_order`를 문서화. 응답 행에 `functions`, `seniority_rank`, `source_type`, `base_salary`, `experience_requirement`, `education_requirement`, `employment_type`를 선언.
    * **API:** 광고 검색에 `active_dates`, `reach_tiers`, `exclude_source_types`, `created_at`, `advertisement_search_id`, `is_ascending_order`를 문서화. `source_types` 수정 — 보강뿐 아니라 결과를 필터링하며, `tiktok`과 `apple`도 허용합니다. 행에 `advertisement_format_normalized`, `advertiser`, `advertisement_url`, `is_company_matched`, `total_impressions` 3종을 선언하고, `metadata`에 `applied_source_types`, `unsupported_source_types`, `coverage_notes`, `skipped_source_types`를 문서화.
    * **API:** 뉴스 검색에 `published_at`, `news_search_id`, `is_ascending_order`를 문서화하고, `expansion_signals`(`is_expansion_signal_available` 설정 시 반환 — 플래그 출시 전에 이루어진 v2.3.1의 제거를 되돌립니다)를 포함한 모든 행 필드를 선언.
    * **API:** 인물 검색에 `exclude_people_titles`, `exclude_people_locations`, `exclude_departments`, `exclude_department_functions`, `company_exclude_locations`를 문서화.
    * **API:** 회사 검색에 `social_media`와 `advertisement_status`를 문서화.
    * **API:** 모든 검색 엔드포인트가 이제 `metadata.ignored_fields`를 문서화 — 인식되지 않는 본문 키는 거부되지 않고 제거되며 여기에 나열됩니다. 채용·뉴스·광고 검색은 자유 형식 객체 대신 `pagination`과 타입이 지정된 `metadata` 블록도 선언합니다.
    * **문서:** 네 개의 스키마(`job_exclude_locations`, `advertisement_target_locations`, `advertisement_exclude_target_locations`, 확장 랭킹의 `domain_search_ids`)가 `$ref` 옆에 설명을 두어 OpenAPI 3.0에서 조용히 버려지고 있었습니다. 이제 정상적으로 표시됩니다.
  </Accordion>

  <Accordion title="v2.3.1 - 확장 API 레퍼런스 정비 (2026년 8월)">
    * **API:** **확장 신호 검색**(`POST /expansions/signals/search`)을 새로 수록했습니다. 집계된 회사 단위가 아니라 회사의 단계를 뒷받침하는 원본 날짜별 신호 행을 직접 조회할 수 있습니다.
    * **API:** **확장 조회**(`POST /expansions/lookup`)를 새로 수록했습니다. 확장 검색의 결정적 대응 엔드포인트로 필터를 자동 완화하지 않아 재현 가능한 결과가 필요한 대시보드와 예약 작업에 적합합니다.
    * **API:** `expansions`를 감시하는 모니터의 필터 어휘와 웹훅 페이로드를 명시했습니다. [웹훅 설정 참조](/ko/developer-guides/setting-up-webhooks).
    * **API:** 기업 확장 상세, 비교, 요약, 순위 엔드포인트에 `is_include_metadata`를 문서화했습니다. API 키 트래픽은 기본적으로 경량 응답이며, `true`로 설정하면 `confidence_score`와 전체 모델 상세를 받습니다.
    * **API:** 확장 관련 오류 코드(`40043`, `40360`, `40435`, `40436`)를 [상태 코드](/ko/api-reference/status-codes)에 추가했습니다.
    * **삭제:** `/companies/{jobs,news,advertisements}/export` 레퍼런스 페이지. 내보내기는 CSV 첨부를 반환하고 별도의 `data_export_credit`를 소모하지만, 대응하는 검색 엔드포인트가 JSON으로 이미 반환하는 것 이상을 제공하지 않습니다. 페이지네이션과 함께 검색을 사용하세요.
    * **삭제:** `/people/enrichment` 레퍼런스 페이지. 이 엔드포인트는 출시된 적이 없습니다. 인물 데이터를 보강하려면 [People Lookup](/ko/api-reference/endpoint/people/lookup)을 `is_enrichment_available: true`와 함께 호출하세요.
    * **문서:** 모든 요청 본문에서 `profile_id`를 제거했습니다. API 키 자체가 워크스페이스를 식별하며, API 키 요청에서 이 매개변수는 무시되었습니다.
    * **API:** 유사 기업 및 유사 인물 검색에 필요한 참조 식별자를 문서화했습니다. 이전에는 `/companies/search/similar`가 문서화된 모든 매개변수 조합에 대해 `41847 Missing parameter`를 반환했습니다.
    * **API:** [기업 보강](/ko/api-reference/endpoint/companies/enrichment)이 기업 레코드와 함께 반환하는 `jobs`, `news`, `advertisements`, `similar_companies` 배열을 문서화하고, 이 호출이 보통 30\~60초 걸린다는 점을 안내했습니다.
    * **API:** 여덟 개 엔드포인트가 반환하는 최상위 `metadata`를 선언했으며, 여기에는 `credit`, `topup_credit`, `total_credit_cost`를 담은 `profile` 블록이 포함됩니다.
    * **API:** 기업 식별자 엔드포인트에 허용되는 아홉 가지 식별자를 모두 문서화했습니다(`tiktok_url`, `wantedly_url`, `tw104_url`, `rocketpunch_url`, `remember_url`, `youtrust_url` 추가).
    * **문서:** API에서 가장 흔한 오류인 `41847 Missing parameter`를 [상태 코드](/ko/api-reference/status-codes)에 추가했습니다.
    * **문서:** [인증](/ko/api-reference/authentication)에 `User-Agent` 요구 사항을 추가했습니다. 일반적인 user agent를 사용하는 클라이언트는 엣지에서 차단되어 `HTTP 403`과 `error code: 1010`을 받으며, 이는 잘못된 API 키로 오인되기 쉽습니다.
    * **문서:** [요청 빈도 제한](/ko/api-reference/rate-limits)에 Profile Usage가 반환하는 사용량·할당량 필드와 `total_max_*`에 라이선스 배수가 적용되는 방식을 문서화했습니다.
    * **API:** 확장 필터(`stages`, `signal_types`, `signal_strengths`, `freshness`, `momentum`, `polarity`)에 허용 값을 명시하고, 인식되지 않는 값은 거부되지 않고 조용히 버려진다는 점(일부 매개변수에서는 필터가 사라지고 다른 매개변수에서는 아무것도 일치하지 않음)을 경고로 추가했습니다.
    * **API:** `momentum`은 `advancing`, `steady`, `pulling_back`을 허용합니다. Expansion Reference의 `directions` 값(`retreating`, `new`)은 `stage.direction`으로 반환되는 응답 값이며 필터로 유효했던 적이 없습니다.
    * **API:** 뉴스 인사이트를 수정했습니다 — `mentions`, `topics`, `sources`, `top_source`는 최상위 배열이 아니라 `data.totals` 안의 정수/문자열 필드입니다. `topics`와 `sources`는 중복을 제외한 개수이며, 항목별 목록은 `category_breakdown`과 `market_breakdown`에 있습니다.
    * **API:** 광고 인사이트를 수정했습니다 — `postings[]`는 축약 키 `r`, `m`, `ch`, `fo`, `n`을 사용하고, `reach_tiers[]`는 개수가 없는 `{slug, label}` 카탈로그입니다. `creatives[]`는 `image_url`, `cta`, `has_video`를 포함한 전체 열 개 필드를 문서화했습니다.
    * **API:** 채널 템플릿의 `parameters` 키는 `channel_type_slug`에 따라 달라집니다. 이메일, LinkedIn, Twilio 템플릿이 각각 다른 키 집합을 가집니다.
    * **문서:** API가 반환하지 않는 응답 필드를 제거했습니다: User의 `referral_code`, 유사 인물 검색의 `similarity_score`, LinkedIn 기업 조회의 `funding_status`와 `crunchbase_url`, 뉴스 검색의 `expansion_signals`, 확장 신호 검색의 `occurs_at` / `occurs_until`.
    * **문서:** 상태 코드 표를 API의 오류 테이블에서 다시 만들었습니다. 아홉 개 코드가 잘못되어 있었습니다. `40075`, `40076`, `40091`, `40092`, `40095`는 페이지네이션·할당량 오류로 기재되어 있었지만 실제로는 **HTTP 416**의 `41675`, `41676`, `41691`, `41692`, `41695`이며, 기재되어 있던 번호들은 각각 전혀 다른 의미의 실제 코드였습니다. `40003`, `40602`, `40603`은 실제로 `40303`, `40632`, `40633`이고 `40099`는 존재하지 않습니다.
    * **문서:** **HTTP 416**을 문서화했습니다. 페이지네이션과 할당량 초과는 416과 `416xx` 코드를 반환하며 결과가 잘리지 않습니다.
    * **문서:** 모니터 오류 코드군(`40020`\~`40035`)을 추가했습니다. `40021`은 모니터 생성 후 `detection_mode`를 변경할 수 없음을 의미합니다.
    * **API:** `per_page`의 상한은 플랜의 `max_search_per_page`(대부분 25)이며 `26`을 보내면 HTTP 416이 반환됩니다. `page`의 상한은 `max_search_page`입니다. 이 한도들과 그 밖의 모든 플랜 상한은 [Profile](/ko/api-reference/endpoint/profile/profile)이 반환하며 [요청 빈도 제한](/ko/api-reference/rate-limits)에 정리했습니다.
    * **API:** `people_contact_types`는 `email-work`, `email-personal`, `phone`만 허용합니다. 인식되지 않는 값은 거부되지 **않고** HTTP 200과 `emails: null`, 크레딧 0으로 반환되어 해당 인물에게 실제로 연락처가 없는 경우와 구분되지 않습니다.
    * **API:** 조회 결과가 없을 때 응답의 `emails`와 `phones`는 `[]`가 아니라 `null`을 반환합니다.
    * **API:** 채널 템플릿 `create` 매개변수를 문서화했습니다. `channel_node_id`는 Channel Template Types에서 얻는 UUID이며 `parameters`에 유효한 키를 결정합니다. `delete`는 숫자형 `channel_template_id`를 받고 한 번에 한 버전만 삭제합니다.
    * **API:** 모니터 웹훅 검증은 실제 서명된 전송을 수행합니다. `GET`에만 응답하는 URL은 실패하며 `details`에 상류 응답 본문이 반환됩니다.
  </Accordion>

  <Accordion title="v2.3.0 - 확장 릴리스 (2026년 7월)">
    * **새로운 기능:** **시장 확장 API (Market Expansion API).** 어떤 회사가 어떤 시장에 진입하고 있는지, 그리고 얼마나 진척되었는지를 추적합니다 — 실제 채용, 뉴스, 광고, 클라우드 인프라, 행사 신호로 구축된 4단계 사다리(Exploring → Committing → Expanding → Scaling)입니다. `froms` / `tos`로 코리도어별 검색, 단일 회사의 시장 진입 심층 조회, 동종 기업 비교를 지원합니다. [퀵스타트로 시작하세요](/ko/knowledge-base/concepts/expansion-api-quickstart).
    * **새로운 기능:** **자연어 검색.** 확장 검색에 일반 문장 `query`("영국으로 확장 중인 핀테크 회사")를 전달하면 Pubrio가 이를 필터로 해석합니다 — `is_explain_match`를 통해 각 회사의 실제 신호에 기반한 AI 매칭 설명도 선택적으로 제공합니다.
    * **API:** 결과가 이제 기본적으로 상호 검증된 무버(여러 독립 신호 유형)를 먼저 보여주는 관련성 순서로 정렬됩니다. 순수 최신순은 `sort_by: "recent"`를 전달하세요.
    * **API:** 모니터가 이제 채용, 뉴스, 광고와 함께 **확장 신호**(`signal_types: ["expansions"]`)를 감시할 수 있으며, [모니터 해석](/ko/api-reference/endpoint/monitors/interpret)을 통해 일반 문장으로 모니터 초안을 만들 수 있습니다.
    * **API:** 모니터 라이프사이클이 이제 단일 `status` 필드(`draft` / `active` / `paused` / `inactive`)로 통합되어, 요청과 응답에서 기존 `is_active` / `is_paused` 불리언을 대체합니다.
  </Accordion>

  <Accordion title="v2.2.0 - 모니터 릴리스 (2026년 4월)">
    * **새로운 기능:** **모니터 (Monitors).** 실시간 자동 시그널 감지 및 전달 — 자체 폴링 파이프라인을 구축할 필요 없이 수백만 기업의 채용 공고, 기업 뉴스, 광고 캠페인을 추적할 수 있습니다. 필터를 한 번만 정의하면 Pubrio가 스캔, 데이터 보강 후 매칭된 시그널을 웹훅, 이메일 또는 아웃리치 시퀀스로 전달합니다.
    * **새로운 기능:** **두 가지 감지 모드.** **시그널 퍼스트** (Signal First, 광범위한 시장 스캐닝)와 **컴퍼니 퍼스트** (Company First, 특정 계정 추적) 중 선택하여 영업 워크플로우에 맞출 수 있습니다.
    * **새로운 기능:** **자동 인물 보강.** 각 모니터 트리거가 매칭된 기업의 연락처를 자동으로 검색하고 교환합니다 — 관리 직급, 부서, 직함별 필터를 설정할 수 있는 다층 보강을 지원합니다.
    * **API:** 15개의 새로운 모니터 엔드포인트 추가 — 전체 CRUD, 통계, 차트, 감지 로그, 웹훅 검증 및 테스트 처리. [모니터 API 레퍼런스 보기](/ko/api-reference/endpoint/monitors/create).
    * **API:** 요청 본문에 `profile_id`가 더 이상 필수가 아닙니다. API 키에 워크스페이스 정보가 포함됩니다. 이전 버전과의 호환성을 위해 해당 매개변수는 여전히 사용할 수 있습니다.
    * **API:** AI 에이전트 및 MCP 도구 호환성 향상을 위해 모든 59개 API 엔드포인트에 `operationId`, `summary`, `description`, `tags`를 추가했습니다.
    * **문서:** AI 크롤러 검색을 위한 `llms.txt`를 활성화했습니다.
  </Accordion>

  <Accordion title="v2.1.0 - 스마트 리스트 베타 (2026년 2월)">
    * **새로운 기능:** **AI 스마트 리스트 (베타).** 사용자는 이제 CSV를 업로드하고 스프레드시트 인터페이스에서 볼 수 있으며, Pubrio가 누락된 열을 자동으로 채워줍니다.
    * **데이터:** DACH 지역(독일, 오스트리아, 스위스)에서 300만 개의 검증된 신규 엔티티를 추가했습니다.
    * **API:** `/enrich/company` 엔드포인트의 응답 시간이 빨라졌습니다(지연 시간 200ms 단축).
  </Accordion>

  <Accordion title="v2.0.0 - 새해 업데이트 (2026년 1월)">
    * **새로운 기능:** **광고 검색 인텔리전스.** 이제 광고 투명성 센터와 유료 검색 저장소를 인덱싱합니다. 기업이 광고를 집행하고 *있는지*, *어디에* 비용을 쓰는지, *어떤* 키워드를 타겟팅하는지 확인할 수 있습니다.
    * **개선 사항:** LATAM(중남미) 지역에서 비표준 로컬 소프트웨어를 사용하는 기업에 대한 "기술 스택" 감지 기능을 강화했습니다.
  </Accordion>
</AccordionGroup>

***

## 2025 아카이브: 파트너의 해

2025년은 주요 생태계 연동으로 정의되며, 여러분이 매일 사용하는 플랫폼에 Pubrio 데이터를 제공했습니다.

<AccordionGroup>
  <Accordion title="2025년 4분기 - 자동화 연동">
    * **연동:** **Ottokit.** 자율 에이전트 워크플로우를 위한 네이티브 커넥터를 출시했습니다.
    * **연동:** **Databar.** 노코드(No-code) 리서치를 위한 Databar 마켓플레이스에 Pubrio를 검증된 제공업체로 추가했습니다.
  </Accordion>

  <Accordion title="2025년 3분기 - 디자인-투-시퀀스(Design-to-Sequence) 동기화">
    * **연동:** **Stripo.** "시퀀스로 푸시(Push to Sequence)" 기능을 활성화하여, 디자인 팀이 HTML 템플릿을 Pubrio 워크플로우에 직접 동기화할 수 있게 되었습니다.
    * **기능:** **동적 변수 주입.** 템플릿의 일반적인 자리 표시자(placeholder)가 발송 시 실시간 Pubrio 데이터로 변환되도록 허용했습니다.
  </Accordion>

  <Accordion title="2025년 2분기 - Clay 파트너십">
    * **연동:** **Clay 네이티브 연동.** Clay 데이터 강화 메뉴의 기본 제공업체가 되었습니다.
    * **데이터:** "보이지 않는 70%" 커버리지를 확장하여 아시아 태평양 전역의 15개 신규 로컬 등록부를 포함했습니다.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.