> ## 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. # Company Expansion Detail > In-depth expansion profile for a single company — current stage, signals, market presence, and stage-transition history — for one market or aggregated across all markets. ## OpenAPI ````yaml en-openapi POST /expansions/companies/lookup openapi: 3.0.0 info: description: >- The Pubrio API delivers market expansion intelligence — real-time signals that flag when a company enters a new market — alongside the company and people data beneath them. Search, look up, and enrich accounts and contacts, and subscribe to typed, dated movement signals across 200+ markets. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/en/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/en/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: Workspace profile information and usage statistics - name: Enrichment description: Enrich people and company records with detailed B2B data - name: Lookalike description: Find companies similar to a given company - name: Search description: Search for people, companies, jobs, news, and advertisements with filters - name: Lookup description: >- Look up detailed information for specific people, companies, jobs, news, advertisements, and technologies - name: LinkedIn description: Look up people and company data via LinkedIn profile URLs - name: Redeem description: Redeem credits to unlock people contact details (single and batch) - name: Channels description: Manage outreach channel templates (create, update, delete, list) - name: Monitor description: Create and manage data monitors with webhooks, statistics, and processing - name: Filters description: >- Retrieve available filter values for search parameters (technologies, locations, verticals, etc.) - name: API Keys description: List and inspect API request logs and usage analytics for API keys - name: Insights description: Aggregated signal insights for companies (jobs, news, advertisements). - name: Export description: Bulk data exports (credit-gated). - name: Expansion description: >- Company market-expansion intelligence: signals, stages, markets, and exports. externalDocs: description: >- The Pubrio API is used to search, preview and enrich Contacts and Accounts. Pubrio database provides extensive B2B contacts and sales intelligence data. url: https://docs.pubrio.com paths: /expansions/companies/lookup: post: tags: - Expansion summary: Company expansion detail description: >- In-depth expansion profile for a single company — current stage, signals, market presence, and stage-transition history — for one market or aggregated across all markets. 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: Filter the returned signals to a single type. 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: >- Plain-language description of what you sell, or the buyer profile you're evaluating this company against. Used only to ground the AI `summary` (see `is_explain_match`); unlike the company search, it is NOT interpreted into filters here. is_explain_match: type: boolean example: true description: >- When true and a `query` is supplied, `summary` returns a single AI summary of this company's expansion activity in the current scope (the selected market, or all foreign markets when `is_all_markets` is true), read against your `query` and grounded in the company's real signals with `[n]` citations. window_days: type: integer example: 90 default: 90 description: >- Optional. Rolling window (in days) that bounds the AI `summary` feed. Defaults to **90** when neither this nor `transitioned_dates` is supplied. Does not affect the paginated `signals` list (full history). transitioned_dates: type: array items: type: string format: date example: - '2026-04-01' - '2026-06-29' description: >- ISO `[from, to]` date range for the signal/transition window. Takes precedence over `window_days` when both are supplied. 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: Domain required: - domain - title: LinkedIn URL required: - linkedin_url responses: '200': description: Company-in-market detail. 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: >- Target market as an ISO 3166-1 alpha-2 (cca2) country code. Omit to auto-pick the company's single most active market; set `is_all_markets` for a cross-market view of every market. expansion_is_all_markets: type: boolean example: false description: >- Return the company's entire expansion footprint across ALL markets in one call, rather than a single market. When `true`, `country_code` is ignored, the home market is excluded from the signal aggregates when it can be identified, `data` becomes a company-level rollup (dominant stage, total signals, date span, top expansion score), and `markets_summary` lists every market. Defaults to false. domain: type: string example: pubrio.com description: >- A company domain used for company search operations. If we receive a URL such as `www.pubrio.com` or `https://docs.pubrio.com/`, the system will convert it to `pubrio.com` for processing. company_linkedin_url: type: string example: https://www.linkedin.com/company/pubrio description: >- The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/` domain_search_id: type: string format: uuid description: A unique identifier for the company search operation. expansion_is_include_established: type: boolean example: false description: >- Include the `established` stage (long-standing operators with no active expansion signals). Defaults to false. page: type: integer example: 1 description: The page number of the Pubrio data that you want to retrieve. per_page: type: integer example: 25 description: >- The number of search results that should be returned for each page. Limited the number of results per page improves the endpoint's performance. profile_id: type: integer description: >- Optional. An identifier for the user profile (workspace) making the request. This is no longer required as the API key already includes your workspace information. If provided, it helps in associating the lookup with a specific user, allowing for data retrieval and credit tracking. Check out `user details` endpoints under the Profile tab for more information. securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- A unique API token that represents the actions you perform through the API and the corresponding permissions and operations. You can create it through the [Settings](https://dashboard.pubrio.com/#/settings/) section. in: header ````