{"uid":"cap_-ThpeAolYHXFQPPApeWx4","slug":"agents-pubrio-com-expansion-overview-dashboard-23ab06b6","name":"Expansion Overview Dashboard","description":"Market-level expansion KPIs — per-market stage counts and top cross-border flows. Aggregated, not paginated. Answers `408` when the request cannot finish in time.","url":"https://agents.pubrio.com/expansions/dashboard?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tos":{"type":"array","items":{"type":"string"},"example":["US","GB"],"description":"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."},"froms":{"type":"array","items":{"type":"string"},"example":["US","GB"],"description":"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."},"scopes":{"type":"array","items":{"enum":["entering_new_market","expanding_within_presence","established_only"],"type":"string"},"example":["entering_new_market"],"description":"Filter by market-entry scope."},"stages":{"type":"array","allOf":[{"type":"array","items":{"enum":["exploring","committing","expanding","scaling"],"type":"string"},"example":["committing","expanding"],"description":"Filter to one or more expansion stages. See the Expansion Signals knowledge base for stage definitions."}],"items":{"type":"string","description":"Allowed values: exploring, committing, expanding, scaling."},"example":["committing","expanding"],"description":"Values are case-sensitive and are **not validated**. An unrecognised value is silently discarded rather than rejected: on `stages`, `freshness`, `scopes` and `momentum` the whole filter is dropped and you get *unfiltered* results, while on `signal_types` and `signal_strengths` the filter is applied and matches *nothing*. Either way the response looks normal. Resolve valid slugs from [Expansion Reference](/en/api-reference/endpoint/expansions/types) and compare `data.pagination.total_entries` against an unfiltered call if a result set looks wrong."},"keywords":{"type":"array","items":{"type":"string"},"example":["ecommerce","ai","fintech"],"description":"A list of keywords to filter companies by relevance, specialties, or descriptions."},"momentum":{"type":"array","allOf":[{"type":"array","items":{"enum":["advancing","steady","pulling_back"],"type":"string"},"example":["advancing","steady"],"description":"Trajectory to filter by. Only `advancing`, `steady` and `pulling_back` are accepted; the `directions` values in [Expansion Reference](/en/api-reference/endpoint/expansions/types) are response-side only."}],"items":{"type":"string","description":"Allowed values: advancing, steady, pulling_back."},"example":["advancing","steady"],"description":"Trajectory of the company's movement in the market. `advancing` is gaining ground, `steady` is holding, `pulling_back` covers retreat and contraction.\n\nDo **not** use the values from `directions` in [Expansion Reference](/en/api-reference/endpoint/expansions/types) here. Those (`advancing`, `steady`, `retreating`, `new`) are the *response* values you get back on `stage.direction`; only the three listed above are accepted as a *filter*. Sending `retreating` or `new` silently disables the filter and returns unfiltered results."},"revenues":{"type":"array","items":{"type":"integer"},"example":[0,100000],"description":"Minimum and maximum range of company revenue."},"companies":{"type":"array","items":{"type":"string"},"example":["stripe.com","https://www.linkedin.com/company/airbnb","b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"],"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."},"employees":{"type":"array","items":{"type":"array","items":{"type":"string"}},"example":[[1,10],[11,20],[10001]],"description":"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. \n\n Check out `company size` endpoints under the Filters tab for more information."},"freshness":{"type":"array","allOf":[{"type":"array","items":{"enum":["fresh","cooling","stale","cold"],"type":"string"},"example":["fresh","cooling"],"description":"Filter by evidence recency: fresh (~30d), cooling (~30-60d), stale (~60-90d), cold (>90d)."}],"items":{"type":"string","description":"Allowed values: fresh, cooling, stale, cold."},"example":["fresh","cooling"],"description":"Values are case-sensitive and are **not validated**. An unrecognised value is silently discarded rather than rejected: on `stages`, `freshness`, `scopes` and `momentum` the whole filter is dropped and you get *unfiltered* results, while on `signal_types` and `signal_strengths` the filter is applied and matches *nothing*. Either way the response looks normal. Resolve valid slugs from [Expansion Reference](/en/api-reference/endpoint/expansions/types) and compare `data.pagination.total_entries` against an unfiltered call if a result set looks wrong."},"verticals":{"type":"array","items":{"type":"integer"},"description":"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.\n\nThis filter supports `is_enable_similarity_search`, once enabled you can enter any free text, e.g. `[\"AI\"]`."},"flows_size":{"type":"integer","example":50,"description":"Max cross-border flows to return (plan-capped)."},"industries":{"type":"array","items":{"type":"string"},"example":["software","financial services"],"description":"Filter by industry name (free-text match)."},"job_titles":{"type":"array","items":{"type":"string"},"example":["sales manager","marketing manager"],"description":"Job titles associated with the individuals you aim to locate. \n\n 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`."},"exclude_tos":{"type":"array","items":{"type":"string"},"example":["US","GB"],"description":"Target markets to exclude (ISO 3166-1 alpha-2)."},"min_markets":{"type":"integer","example":3,"description":"Minimum number of new markets a company must have entered in the window (wide expanders)."},"select_size":{"type":"integer","example":250,"description":"Max markets to return (plan-capped)."},"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."},"signal_types":{"type":"array","allOf":[{"type":"array","items":{"enum":["AD","AUDIENCE","DNS","ENTITY","EVENT","EVENT_PLUS","EXEC","HIRE","INFRA","IP","NEWS","OFFICE","PARTNER","PRODUCT","REG","SCALE","TECH"],"type":"string"},"example":["EXEC","HIRE"],"description":"Filter to specific signal types. See the Signal Types catalog in the knowledge base for definitions and tiers (`DNS` and `INFRA` are Premier-tier signals)."}],"items":{"type":"string","description":"Allowed values: AD, AUDIENCE, DNS, ENTITY, EVENT, EVENT_PLUS, EXEC, HIRE, INFRA, IP, NEWS, OFFICE, PARTNER, PRODUCT, REG, SCALE, TECH."},"example":["EXEC","HIRE"],"description":"Values are case-sensitive and are **not validated**. An unrecognised value is silently discarded rather than rejected: on `stages`, `freshness`, `scopes` and `momentum` the whole filter is dropped and you get *unfiltered* results, while on `signal_types` and `signal_strengths` the filter is applied and matches *nothing*. Either way the response looks normal. Resolve valid slugs from [Expansion Reference](/en/api-reference/endpoint/expansions/types) and compare `data.pagination.total_entries` against an unfiltered call if a result set looks wrong."},"technologies":{"type":"array","items":{"type":"integer"},"description":"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.\n\nThis filter supports `is_enable_similarity_search`, once enabled you can enter any free text, e.g. `[\"Shopify\"]`.\n\nA product name the technology list knows matches that product and its own products (`\"Salesforce\"` also matches Salesforce Desk and Salesforce Service Cloud), never look-alikes; other text matches by similarity."},"ahead_of_pace":{"type":"boolean","example":false,"description":"Limit to company/market pairs moving faster than the typical pace for that market."},"exclude_froms":{"type":"array","items":{"type":"string"},"example":["US","GB"],"description":"Origin markets to exclude (ISO 3166-1 alpha-2)."},"founded_dates":{"type":"array","items":{"type":"integer"},"example":[2018,2024],"description":"Years of company founded range. The maximum value founded is the current year."},"job_locations":{"type":"array","items":{"type":"string"},"example":["US","SG","CN"],"description":"ISO 3166-1 alpha-2 (cca2) is used for filtering locations. Check out `location` endpoints under the Filters tab for more information."},"news_categories":{"type":"array","items":{"type":"string"},"example":["launches"],"description":"List of `category slugs` for searching for specific news categories. To find a slug, call the `news categories` endpoint under the Filters tab."},"job_posted_dates":{"type":"array","items":{"type":"string"},"example":["2025-01-01","2025-01-10"],"description":"Date range of the posted date. The maximum value is the current day. Day boundaries follow your workspace timezone."},"min_signal_count":{"type":"integer","example":3,"description":"Minimum number of expansion signals a company must have in the window — \"very active / heavy footprint\"."},"only_contraction":{"type":"boolean","example":false,"description":"When true, return only contraction-flagged expansions (companies scaling back)."},"signal_strengths":{"type":"array","allOf":[{"type":"array","items":{"enum":["low","medium","high","very_high"],"type":"string"},"example":["high"],"description":"Filter by evidence-confidence bucket: `low`, `medium`, or `high`. Note this is distinct from the per-signal `signal_strength_slug` returned on signal records (which ranges `low` to `very_high`); any other value here matches nothing."}],"items":{"type":"string","description":"Allowed values: low, medium, high, very_high."},"example":["high"],"description":"Values are case-sensitive and are **not validated**. An unrecognised value is silently discarded rather than rejected: on `stages`, `freshness`, `scopes` and `momentum` the whole filter is dropped and you get *unfiltered* results, while on `signal_types` and `signal_strengths` the filter is applied and matches *nothing*. Either way the response looks normal. Resolve valid slugs from [Expansion Reference](/en/api-reference/endpoint/expansions/types) and compare `data.pagination.total_entries` against an unfiltered call if a result set looks wrong."},"home_country_code":{"type":"array","items":{"type":"string"},"example":["SG"],"description":"Filter by company home country (ISO 3166-1 alpha-2). Intersects with `froms` when both are supplied."},"exclude_industries":{"type":"array","items":{"type":"string"},"example":["tobacco"],"description":"Industries to exclude (free-text match)."},"transitioned_dates":{"type":"array","items":{"type":"string","format":"date"},"example":["2026-06-01","2026-06-29"],"description":"ISO date range [start, end] for the display window (map, flows, and watchlist timeline). Defaults to the last 90 days. The `new_transitions_30d` KPI always uses its own fixed 30-day window regardless of this range."},"is_include_metadata":{"type":"boolean","allOf":[{"type":"boolean","example":true,"description":"API-key responses are lean by default. Set true to include the full `metadata` block (aggregates, top origins/destinations, top industries, timeline) and per-company model detail."}],"example":true,"description":"Return the full detail payload. API-key traffic is lean by default: the `model` block, the confidence figures (`stage.confidence` on Company Expansion Detail, `confidence_score` on `other_markets[]` and on Rankings `markers[]`) and the `established_min` / `share_of_detected` / `has_known_office` fields are all omitted unless this is `true`."},"vertical_categories":{"type":"array","items":{"type":"integer"},"description":"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.\n\nThis filter supports `is_enable_similarity_search`, once enabled you can enter any free text, e.g. `[\"Information Technology\"]`."},"news_published_dates":{"type":"array","items":{"type":"string"},"example":["2025-01-01","2025-01-10"],"description":"Date range of the published date. The maximum value is the current day. Day boundaries follow your workspace timezone."},"job_exclude_locations":{"allOf":[{"type":"array","items":{"type":"string"},"example":["CN","US","RU","CA"],"description":"ISO 3166-1 alpha-2 (cca2) is used to filter out locations that does not need to be returned. Check out `location` endpoints under the Filters tab for more information."}],"description":"Geographic locations to exclude from job posting results."},"advertisement_end_dates":{"type":"array","items":{"type":"string","format":"date"},"example":["2025-12-25","2025-12-25"],"description":"End date range for advertisement filtering."},"vertical_sub_categories":{"type":"array","items":{"type":"integer"},"description":"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.\n\nThis filter supports `is_enable_similarity_search`, once enabled you can enter any free text, e.g. `[\"Software\"]`."},"advertisement_start_dates":{"type":"array","items":{"type":"string","format":"date"},"example":["2025-12-25","2025-12-25"],"description":"Start date range for advertisement filtering."},"advertisement_search_terms":{"type":"array","items":{"type":"string"},"example":["asus"],"description":"Keywords used to search within advertisement content or titles."},"is_enable_similarity_search":{"type":"boolean","example":true,"description":"Enable free-text matching for `verticals`, `vertical_categories`, `vertical_sub_categories` and `technologies`; those filters are dropped unless this is `true`."},"advertisement_target_locations":{"allOf":[{"type":"array","items":{"type":"string"},"example":["TW","AE","NO"],"description":"Country codes the results must target. Combines with `filter_conditions` as OR by default — a result matches if it targets any of them."}],"description":"Target geographic locations for advertisements."},"advertisement_exclude_target_locations":{"allOf":[{"type":"array","items":{"type":"string"},"example":["IS","GB","FR","IE","ES"],"description":"Country codes the results must not target. Combines with `filter_conditions` as OR by default — a result matches if it targets any of them."}],"description":"Geographic locations to exclude from advertisement targeting."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"countries":{"type":"array","items":{"type":"object"},"description":"Ranked markets with per-market signal counts."},"top_flows":{"type":"array","items":{"type":"object"},"description":"Largest cross-border expansion flows, busiest first."},"picks_aggregate":{"type":"array","items":{"type":"object"},"description":"Aggregate roll-up across the markets matched by the current filters."},"watchlist_markets":{"type":"array","items":{"type":"object"},"description":"Per-market stage counts limited to the companies saved in your workspace."},"watchlist_timeline":{"type":"array","items":{"type":"object"},"description":"Stage-transition events for the companies saved in your workspace, newest first."}},"description":"Dashboard container: ranked markets plus the top corridor flows. Deprecated legacy mirror. Every container inside `data` is also emitted at the top level (`countries`, `top_flows`, `picks_aggregate`, `watchlist_markets`, `watchlist_timeline`) for older clients. Read them from `data` — the top-level copies will be removed."},"metadata":{"type":"object"}},"x-legacy-root-keys":["countries","top_flows","picks_aggregate","watchlist_markets","watchlist_timeline"]},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unknown_unparsed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_pBSHNCa3bv6fHHHsehBM4","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.pubrio.com","brandSlug":"agents-pubrio-com-x402","brandBaseUrl":"https://agents.pubrio.com","brandDocsUrl":null,"whatItDoes":"Returns aggregated market-level expansion KPIs including per-market stage counts and top cross-border expansion flows for a filtered set of markets and companies.","exampleAgentPrompt":"Give me a dashboard overview of expansion activity — show which markets companies are expanding into most aggressively, the top cross-border corridors, and break it down by companies in the 'committing' and 'expanding' stages, filtering to US and GB as origin markets.","exampleUseCases":[{"title":"Identifying hot destination markets for outbound sales","prompt":"Which markets are companies most actively entering right now? Show me the top destination markets ranked by expansion signal volume, focusing on companies currently in the committing or expanding stage."},{"title":"Mapping cross-border corridor activity for a region","prompt":"What are the biggest cross-border expansion flows involving the US and UK as origin countries? I want to see where companies headquartered there are expanding to, ranked by how many are making the move."},{"title":"Tracking fintech expansion signals across Asia-Pacific","prompt":"Give me a market-level expansion overview for fintech companies, filtering to Asia-Pacific target markets — I need stage counts per market and the busiest expansion corridors into that region."}],"resultDescription":"Returns a dashboard object containing: ranked destination markets with per-market signal counts by stage, top cross-border expansion flow pairs sorted by volume, an aggregate roll-up across matched markets, and optionally watchlist-specific per-market stage counts and stage-transition timelines for workspace-saved companies. All data is aggregated and returned in a single non-paginated response.","failureModes":["408 timeout when the aggregation query cannot complete within the time limit — retry with narrower filters","Silently discarded filters when unrecognized enum values are passed for stages, freshness, scopes, or momentum — results appear normal but are unfiltered; validate slugs against the Expansion Reference endpoint","No error returned for invalid signal_types or signal_strengths values — filter is applied and matches nothing, returning empty results","Overly broad queries with no filters may trigger 408 due to aggregation volume"],"whenToPreferThis":"Choose this endpoint when you need a high-level, aggregated market dashboard rather than paginated rows of individual companies or signals. It is ideal for generating heatmaps, ranked market lists, corridor flow visualizations, or KPI summaries across many markets at once. Prefer the Expansion Search endpoint when you need paginated company-level results, or Expansion Signal Search when you need the raw dated evidence behind signals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:46:51.258Z","isFirstParty":false,"canonicalSlug":"agents-pubrio-com-expansion-overview-dashboard-23ab06b6"}