> ## 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. # 회사 확장 상세 > 단일 회사의 심층 확장 프로파일(현재 단계, 신호, 시장 내 활동, 단계 전환 이력)로, 단일 시장 또는 전체 시장 통합 기준으로 조회합니다. ## OpenAPI ````yaml ko-openapi POST /expansions/companies/lookup openapi: 3.0.0 info: description: >- Pubrio API는 마켓 확장 인텔리전스를 제공합니다——기업의 신규 시장 진입을 포착하는 실시간 시그널과 그 기반이 되는 기업·인물 데이터. 계정과 연락처를 검색·조회·보강하고, 200+ 시장에 걸친 유형·날짜가 있는 움직임 시그널을 구독하세요. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ko/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ko/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: 워크스페이스 프로필 정보 및 사용량 통계 - name: Enrichment description: 상세한 B2B 데이터로 인물 및 기업 레코드를 보강 - name: Lookalike description: 지정된 기업과 유사한 기업 검색 - name: Search description: 필터를 사용하여 인물, 기업, 채용, 뉴스 및 광고 검색 - name: Lookup description: 특정 인물, 기업, 채용, 뉴스, 광고 및 기술의 상세 정보 조회 - name: LinkedIn description: LinkedIn 프로필 URL을 통한 인물 및 기업 데이터 조회 - name: Redeem description: 크레딧을 사용하여 인물 연락처 정보 잠금 해제 (단건 및 배치) - name: Channels description: 아웃리치 채널 템플릿 관리 (생성, 수정, 삭제, 목록) - name: Monitor description: 웹훅, 통계 및 처리를 포함한 데이터 모니터 생성 및 관리 - name: Filters description: 검색 매개변수에 사용 가능한 필터 값 조회 (기술, 지역, 버티컬 등) - name: API Keys description: API 키의 요청 로그 및 사용량 분석 조회 - name: Insights description: 회사의 신호 집계 인사이트(채용, 뉴스, 광고). - name: Export description: 대량 데이터 내보내기(크레딧 차감). - name: Expansion description: '회사 시장 확장 인텔리전스: 신호, 단계, 시장, 내보내기.' externalDocs: description: >- Pubrio API는 연락처와 계정 정보를 검색, 미리보기, 그리고 보강하는 데 사용됩니다. Pubrio 데이터베이스는 풍부한 B2B 연락처 및 영업 인텔리전스 데이터를 제공합니다. url: https://docs.pubrio.com paths: /expansions/companies/lookup: post: tags: - Expansion summary: 회사 확장 상세 description: >- 단일 회사의 심층 확장 프로파일(현재 단계, 신호, 시장 내 활동, 단계 전환 이력)로, 단일 시장 또는 전체 시장 통합 기준으로 조회합니다. operationId: expansions_company_lookup requestBody: required: true content: application/json: schema: type: object properties: country_code: $ref: '#/components/schemas/expansion_country_code' is_all_markets: $ref: '#/components/schemas/expansion_is_all_markets' signal_type: type: string enum: - AD - NEWS - INFRA - PARTNER - EXEC - OFFICE - HIRE - SCALE - PRODUCT example: EXEC description: 반환되는 신호를 단일 유형으로 필터링합니다. query: type: string example: >- We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity. description: >- 판매하는 제품이나 이 회사를 평가하는 기준이 되는 이상적인 구매자 프로필을 자연어로 설명합니다. AI `summary`의 근거로만 사용되며(`is_explain_match` 참고), 회사 검색과 달리 여기서는 필터 조건으로 해석되지 않습니다. is_explain_match: type: boolean example: true description: >- true이고 `query`가 제공되면, `summary`는 현재 범위(선택한 시장, 또는 `is_all_markets`가 true일 때 모든 해외 시장)에서 이 회사의 확장 활동을 당신의 `query`에 비추어 하나의 AI 요약으로 반환합니다. 회사의 실제 시그널에 근거하며 `[n]` 인용을 포함합니다. window_days: type: integer example: 90 default: 90 description: >- 선택 사항. AI `summary` 피드를 제한하는 롤링 윈도우(일). 본 파라미터와 `transitioned_dates`를 모두 생략하면 기본값 **90**. 페이지네이션된 `signals` 목록(전체 이력)에는 영향을 주지 않습니다. transitioned_dates: type: array items: type: string format: date example: - '2026-04-01' - '2026-06-29' description: >- 신호/전환 윈도우에 대한 ISO `[from, to]` 날짜 범위입니다. `window_days`가 함께 제공된 경우 이 값이 우선합니다. domain: $ref: '#/components/schemas/domain' linkedin_url: $ref: '#/components/schemas/company_linkedin_url' domain_search_id: $ref: '#/components/schemas/domain_search_id' is_include_established: $ref: '#/components/schemas/expansion_is_include_established' page: $ref: '#/components/schemas/page' per_page: $ref: '#/components/schemas/per_page' profile_id: $ref: '#/components/schemas/profile_id' anyOf: - title: Domain Search ID required: - domain_search_id - title: 도메인 required: - domain - title: LinkedIn URL required: - linkedin_url responses: '200': description: 특정 시장 내 회사 상세 정보입니다. content: application/json: schema: type: object properties: metadata: type: object data: {} example: metadata: filters: domain_search_id: 550e8400-e29b-41d4-a716-446655440002 country_code: US country_code_auto_picked: false pagination: page: 1 per_page: 25 total_entries: 12 total_pages: 1 total_display_pages: 1 is_timeout: false data: domain_search_id: 550e8400-e29b-41d4-a716-446655440002 country_code: US country_name: United States stage_rank: 3 stage_name: Expanding stage: slug: expanding expansion_score: 0.721 scope: entering_new_market direction: advancing freshness: fresh signal_count: 5 first_signal_at: '2026-05-30T09:00:00.000Z' latest_signal_at: '2026-06-20T14:00:00.000Z' last_transition_at: '2026-06-15T09:30:00.000Z' signals: - signal_type_slug: EXEC signal_subtype_slug: country_manager signal_strength_slug: high polarity: expansion event_date: '2026-06-20T14:00:00.000Z' source_type: linkedin display_label: Hired Regional VP for North America evidence_url: https://linkedin.com/company/example-corp source_published_at: '2026-06-20T14:00:00.000Z' lead_time_days: 0 presence: - presence_type: office presence_strength: high address: 123 Market St, San Francisco, CA known_since: '2026-03-15T00:00:00.000Z' timeline: - stage_slug: expanding transitioned_at: '2026-06-15T09:30:00.000Z' transition_kind: advance other_markets: - country_code: CA stage_slug: committing signal_count: 8 first_signal_at: '2026-04-10T00:00:00.000Z' latest_signal_at: '2026-06-22T16:45:00.000Z' last_transition_at: '2026-06-18T00:00:00.000Z' components: schemas: expansion_country_code: type: string example: US description: >- ISO 3166-1 alpha-2(cca2) 국가 코드로 표현된 타깃 시장. 생략하면 해당 회사의 가장 활발한 단일 시장이 자동으로 선택됩니다. 모든 시장에 대한 시장 통합 뷰가 필요하면 `is_all_markets`를 설정하세요. expansion_is_all_markets: type: boolean example: false description: >- 단일 시장이 아니라 한 번의 호출로 회사의 모든 시장에 걸친 확장 현황 전체를 반환합니다. `true`인 경우 `country_code`는 무시되고, 본국 시장을 식별할 수 있는 경우 신호 집계에서 제외되며, `data`는 회사 수준 요약(주도 단계, 총 신호 수, 기간, 최고 확장 점수)이 되고 `markets_summary`에 모든 시장이 나열됩니다. 기본값은 false입니다. domain: type: string example: pubrio.com description: >- 회사 조회 작업에 사용되는 회사 도메인입니다. 입력된 주소가 `www.pubrio.com` 또는 `https://docs.pubrio.com/`인 경우, 시스템은 이를 자동으로 `pubrio.com`으로 변환하여 처리합니다. company_linkedin_url: type: string example: https://www.linkedin.com/company/pubrio description: >- LinkedIn 회사 페이지의 전체 URL입니다. `http`로 시작하며 `linkedin.com/company/`를 포함해야 합니다. domain_search_id: type: string format: uuid description: 회사 조회 작업의 고유 식별자. expansion_is_include_established: type: boolean example: false description: '`established` 단계(활성 확장 신호가 없는 오랜 기간 운영해 온 기업)를 포함합니다. 기본값은 false입니다.' page: type: integer example: 1 description: 조회할 데이터 페이지 번호입니다. per_page: type: integer example: 25 description: 페이지당 반환할 검색 결과 수입니다. 결과 수를 제한하면 API 성능이 향상됩니다. profile_id: type: integer description: >- 선택 사항. 요청을 수행하는 팀 식별자입니다. API 키에 이미 워크스페이스 정보가 포함되어 있으므로 이 매개변수는 더 이상 필수가 아닙니다. 제공되면 조회 및 사용 크레딧 추적을 위해 특정 팀(작업 공간)과 연계됩니다. 자세한 내용은 팀 탭의 `user details` 엔드포인트를 참고하세요. securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- API에서 수행하는 작업 및 해당 권한을 식별하는 고유한 API 토큰입니다. 이 토큰은 [설정](https://dashboard.pubrio.com/#/settings/) 섹션에서 생성할 수 있습니다. in: header ````