> ## 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. # Batch Company Expansion Summaries > Ready-to-render expansion summaries for a batch of companies, prepared for side-by-side comparison without client-side aggregation. ## OpenAPI ````yaml en-openapi POST /expansions/companies/summaries 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/summaries: post: tags: - Expansion summary: Batch company expansion summaries description: >- Ready-to-render expansion summaries for a batch of companies, prepared for side-by-side comparison without client-side aggregation. operationId: expansions_company_summaries requestBody: required: true content: application/json: schema: type: object properties: companies: $ref: '#/components/schemas/expansion_companies' domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' 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. window_days: $ref: '#/components/schemas/window_days' is_include_established: $ref: '#/components/schemas/expansion_is_include_established' profile_id: $ref: '#/components/schemas/profile_id' description: >- Scope companies with a single `companies` array of mixed identifiers — `domain_search_id`, company domain, or LinkedIn URL — matched as a union (not intersected). The legacy `domain_search_ids`, `domains`, and `linkedin_urls` keys remain accepted for backward compatibility. Up to 25 resolved companies per request. responses: '200': description: >- Array of per-company expansion summaries. Two scores: top-level `expansion_score` is the overall current posture across all markets (stable); `summary.window_expansion_score` is the same measure scoped to the selected window. content: application/json: schema: type: object properties: metadata: type: object data: type: object properties: companies: type: array items: type: object example: metadata: {} data: companies: - domain_search_id: 550e8400-e29b-41d4-a716-446655440002 home_country_code: SG expansion_score: 82 firmographics: domain_search_id: 550e8400-e29b-41d4-a716-446655440002 company_name: Example Corp domain: example.com logo_url: https://logo.pubrio.com/example.com.png country_code: SG company_size: null employees_count: 350 company_size_printed: 351+ is_employees_locked: false founded_year: 2015 industry: Software Development publicly_traded_symbol: null estimated_revenue: 25000000 markets_summary: - country_code: US stage_slug: committing signal_count: 12 distinct_type_count: 4 first_signal_at: '2026-04-02T08:00:00.000Z' latest_signal_at: '2026-06-28T10:15:22.000Z' last_transition_at: '2026-06-25T14:30:00.000Z' expansion_score: 0.685 signals: - signal_type_slug: EXEC signal_subtype_slug: country_manager event_date: '2026-06-20T14:00:00.000Z' display_label: Hired Regional VP for North America signal_weekly_totals: - week_start: '2026-06-22' signal_type_slug: HIRE count: 5 summary: active_markets: 1 total_markets: 1 new_markets_90d: 1 momentum_pct: 22 signal_count_90d: 12 window_expansion_score: 69 scaling: 0 pipeline: 1 top_market: country_code: US country: null stage: committing newest_market: country_code: US country: null stage: committing activity_weekly: - 3 - 5 - 4 components: schemas: expansion_companies: type: array items: type: string example: - stripe.com - https://www.linkedin.com/company/airbnb - 550e8400-e29b-41d4-a716-446655440000 description: >- Scope to specific companies by any mix of `domain_search_id`, company domain, or a company social media profile URL. Domains and URLs resolve to their best-ranked company. domains: type: array items: type: string example: - pubrio.com description: >- List of company domains used for company and people 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_urls: type: array items: 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/` window_days: type: integer example: 90 description: >- Optional. Size of the rolling window in days. Used when an explicit `transitioned_dates` range is not supplied; if both are omitted, a default window is used. expansion_is_include_established: type: boolean example: false description: >- Include the `established` stage (long-standing operators with no active expansion signals). Defaults to false. 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 ````