Expansion Search
Find companies expanding into one or more markets using firmographic and signal filters or a plain-language query, with optional AI match explanations grounded in each company’s real signals.
Authorizations
Body
Origin markets (ISO 3166-1 alpha-2). Where a company is expanding FROM — its home / HQ countries. Use alone to find companies growing out of these markets; combine with tos for a specific from→to corridor.
["US", "GB"]Target markets (ISO 3166-1 alpha-2). Where a company is expanding TO. Use alone to find every company entering these markets; combine with froms for a specific from→to corridor.
["US", "GB"]Origin markets to exclude (ISO 3166-1 alpha-2).
["US", "GB"]Target markets to exclude (ISO 3166-1 alpha-2).
["US", "GB"]Filter to one or more expansion stages. See the Expansion Signals knowledge base for stage definitions.
exploring, committing, expanding, scaling, established ["committing", "expanding"]Filter by expansion momentum (trajectory through the stages): accelerating (advancing with a mode change), advancing, steady, or pulling_back (retreating or contracting).
accelerating, advancing, steady, pulling_back ["accelerating", "advancing"]Filter by evidence recency: fresh (~30d), cooling (~30-60d), stale (~60-90d), cold (>90d).
fresh, cooling, stale, cold ["fresh", "cooling"]Filter by market-entry scope.
entering_new_market, expanding_within_presence, established_only ["entering_new_market"]Limit to pairs moving faster than the typical pace for that market.
false
Filter to specific signal types.
AD, NEWS, INFRA, PARTNER, EVENT_PLUS, EXEC, OFFICE, HIRE, SCALE, PRODUCT ["EXEC", "HIRE"]Filter by signal strength buckets.
low, medium, high, very_high ["high", "very_high"]Minimum number of expansion signals a company must have in the window — "very active / heavy footprint".
3
When true, return only contraction-flagged expansions (companies scaling back).
false
Minimum number of new markets a company must have entered in the window.
3
A list of vertical_id used to search for companies in a specific vertical or industry. To find the ID, call the vertical endpoint under the Filters tab.
This filter supports is_enable_similarity_search, once enabled you can enter any free text, e.g. ["AI"].
A list of vertical_category_id used to search for companies in a specific vertical category. To find the ID, call the vertical category endpoint under the Filters tab.
This filter supports is_enable_similarity_search, once enabled you can enter any free text, e.g. ["Information Technology"].
A list of vertical_sub_category_id used to search for companies in a specific vertical sub-category. To find the ID, call the vertical sub category endpoint under the Filters tab.
This filter supports is_enable_similarity_search, once enabled you can enter any free text, e.g. ["Software"].
A list of tag_id used to search for specific technologies used by companies. To find the ID, call the technology endpoint under the Filters tab.
This filter supports is_enable_similarity_search, once enabled you can enter any free text, e.g. ["Shopify"].
The number range of employees working for the company. This enables you to find companies based on headcount. You can add multiple ranges to expand your search results.
Check out company size endpoints under the Filters tab for more information.
[[1, 10], [11, 20], [10001]]Minimum and maximum range of company revenue.
[0, 100000]Years of company founded range. The maximum value founded is the current year.
[2018, 2024]A list of keywords to filter companies by relevance, specialties, or descriptions.
["ecommerce", "ai", "fintech"]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.
[
"stripe.com",
"https://www.linkedin.com/company/airbnb",
"550e8400-e29b-41d4-a716-446655440000"
]ISO 3166-1 alpha-2 (cca2) is used for filtering locations. Check out location endpoints under the Filters tab for more information.
["US", "SG", "CN"]Geographic locations to exclude from job posting results.
["CN", "US", "RU", "CA"]Date range of the posted date. The maximum value is the current day.
["2025-01-01", "2025-01-10"]Job titles associated with the individuals you aim to locate.
The results will also encompass job titles that include similar terminology, even if they do not match exactly. For instance, searching for software engineer may yield results for individuals with the title senior software engineer.
["sales manager", "marketing manager"]Target geographic locations for advertisements.
["TW", "AE", "NO"]Geographic locations to exclude from advertisement targeting.
["IS", "GB", "FR", "IE", "ES"]Keywords used to search within advertisement content or titles.
["asus"]Start date range for advertisement filtering.
["2025-12-25", "2025-12-25"]End date range for advertisement filtering.
["2025-12-25", "2025-12-25"]List of category slugs for searching for specific news categories. To find a slug, call the news categories endpoint under the Filters tab.
["launches"]Date range of the published date. The maximum value is the current day.
["2025-01-01", "2025-01-10"]ISO date range for the timeline window. Defaults to the last 90 days. A natural-language query may also set this from calendar phrases ("this year", "last year", "Q2 2026").
["2026-04-01", "2026-06-29"]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.
90
Natural-language query that Pubrio interprets into expansion + company filters.
"fintech companies expanding into the UK"
Include AI-generated explanations of why each company matches the search, grounded in the company's real signals. Best paired with a natural-language query. The number of signals cited and the batch size both scale with per_page; high-volume sources (job postings, ad campaigns) are summarized as a window-scoped count (e.g. "12 job postings") rather than listed individually.
true
Result ordering. Omit for the default (most recently transitioned first). expansion_score — highest expansion score first. signal_count — most signals in the pair first. company_ranking — Pubrio's overall company ranking (lower is more prominent), ascending.
expansion_score, signal_count, company_ranking "expansion_score"
The page number of the Pubrio data that you want to retrieve.
1
The number of search results that should be returned for each page. Limited the number of results per page improves the endpoint's performance.
25
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.
Response
Paginated list of companies expanding in the market(s). filters echoes the applied (or natural-language-interpreted) criteria; each company includes a match_summary when is_explain_match is true.