{"uid":"cap_qj6Mr-TEZ380nu2nCwucu","slug":"agents-pubrio-com-company-expansion-detail-97c3a1de","name":"Company Expansion Detail","description":"Pubrio detects when companies enter new markets and returns the company and people data behind each move. Expansion signals (local hiring, new offices and entities, localized ads, news, cloud hosting) are typed, dated and tied to evidence across 200+ markets, with strong coverage of Asia-Pacific and other markets that Western-built datasets miss. The graph covers 800M+ companies and 560M+ contacts from 50+ local data sources, refreshed daily. Search companies, people, job postings, news, ads and cloud footprints with filters or a plain-language query; look up records by domain, LinkedIn URL or Pubrio id; find lookalike companies and people; read hiring, news, advertising and cloud insights for one company; and reveal verified work emails, personal emails and phone numbers. Each call costs the number of credits listed on its endpoint. This server is a pay-per-use, transparent proxy in front of Pubrio's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. The complete verified paid surface is listed at /openapi.json, the source of truth for available operations. Each operation here carries its live price in x-payment-info. Use the operations and details here when they meet your needs. Filtered specs contain only matching operations; if you cannot find what you need here, use search or the service catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge, reserved for agents claimed by a human with a verified email.","url":"https://agents.pubrio.com/expansions/companies/lookup?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"page":{"type":"integer","default":1,"example":1,"description":"Page number, starting at 1."},"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."},"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."},"per_page":{"type":"integer","default":25,"example":25,"maximum":25,"description":"Records per page, 1 to 25. Defaults to 25."},"signal_type":{"enum":["AD","AUDIENCE","DNS","ENTITY","EVENT","EVENT_PLUS","EXEC","HIRE","INFRA","IP","NEWS","OFFICE","PARTNER","PRODUCT","REG","SCALE","TECH"],"type":"string","example":"EXEC","description":"Filter the returned signals to a single type."},"window_days":{"type":"integer","default":90,"example":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)."},"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."},"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/"},"summary_only":{"type":"boolean","example":true,"description":"Return the stage summary block (data, company, markets_summary, signal_weekly_totals, recent_signals, expansion_score, summary) and skip the paginated signal list and its aggregates."},"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_search_id":{"type":"string","format":"uuid","description":"A unique identifier for the company search operation."},"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."},"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."},"is_include_metadata":{"type":"boolean","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."},"markets_summary_full":{"type":"boolean","example":true,"description":"Include the full ranked market set as markets_summary alongside the capped other_markets list."},"is_include_established":{"type":"boolean","example":false,"description":"Include the established stage (long-standing operators with no active expansion signals). Defaults to false."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"read":{"type":"object","description":"Read status for this record."},"stage":{"type":"object","description":"Stage detail — score, scope, direction, freshness and signal counts."},"presence":{"type":"object","properties":{"level":{"enum":["established","emerging","none","no_data"],"type":"string","description":"How settled the company's footprint in this market is: `established`, `emerging`, `none`, or `no_data`. This is the footprint, not the expansion stage."},"matched_rule":{"type":"string","nullable":true,"description":"Which signal established the level — for example `office`, `headcount` or `share`. `null` when no rule matched."},"local_people_count":{"type":"integer","description":"Employees located in the target market."}},"description":"In-market footprint: how settled the company already is, independent of its expansion stage."},"stage_name":{"type":"string","description":"Display name of the stage."},"stage_rank":{"type":"integer","description":"Numeric rank of the stage, higher is further along."},"country_code":{"type":"string","description":"Target market, ISO 3166-1 alpha-2."},"country_name":{"type":"string","description":"Target market name."},"domain_search_id":{"type":"string","description":"Pubrio company identifier."},"local_people_count":{"type":"integer","description":"Employees located in the target market."},"local_people_coverage":{"type":"boolean","description":"Whether headcount coverage is sufficient to trust the count."}},"description":"Result container."},"company":{"type":"object","description":"Company chrome — name, domain, logo and social URLs. First page only."},"signals":{"type":"array","items":{"type":"object"},"description":"The paginated signal rows behind this company/market pair — the evidence list. Page size and totals come from `metadata.pagination`."},"summary":{"type":"object","description":"One-line stage summary for the pair. First page only."},"metadata":{"type":"object"},"presence":{"type":"array","items":{"type":"object"},"description":"Observed physical and digital presence for the company in this market. First page only."},"timeline":{"type":"array","items":{"type":"object"},"description":"Stage-transition history for this company/market pair. First page only."},"suppressions":{"type":"array","items":{"type":"object"},"description":"Signals suppressed from the stage calculation, with the reason for each. First page only."},"other_markets":{"type":"array","items":{"type":"object"},"description":"The company's other active markets. Capped on limited plans — see `other_markets_locked_count`. First page only."},"markets_summary":{"type":"array","items":{"type":"object"},"description":"Full ranked market set for this company. Returned only when `markets_summary_full` is `true`, on the first page."},"evidence_breakdown":{"type":"object","description":"Evidence roll-up by source type, computed from the returned (redacted) signals. First page only."},"signal_type_totals":{"type":"object","description":"All-time signal totals per signal type. First page only.","additionalProperties":{"type":"integer"}},"signal_group_totals":{"type":"object","description":"Signal counts per type, bucketed by day in your timezone. First page only.","additionalProperties":{"type":"integer"}},"signal_weekly_totals":{"type":"array","items":{"type":"object"},"description":"Weekly signal counts for the heatmap, same window as `signal_type_recent_totals`. First page only."},"signal_type_recent_totals":{"type":"object","description":"Signal totals per type over the trailing 12 weeks. First page only.","additionalProperties":{"type":"integer"}},"other_markets_locked_count":{"type":"integer","description":"How many additional markets your plan did not return in `other_markets`. `0` when nothing was withheld."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"1.00","reviews":1,"stars":"5.0","state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"5.0000","medianCents":"5.0000","p90Cents":"5.0000","minCents":"5.0000","maxCents":"5.0000","p95Cents":"5.0000","sampleCount":13,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.05","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8Q4rMY72WR0NXQ3sDAna7","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_z8_koaAKjUxrKutW_1T9m","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.pubrio.com","brandSlug":"agents-pubrio-com-x402","brandBaseUrl":"https://agents.pubrio.com","brandDocsUrl":null,"whatItDoes":"Returns an in-depth expansion profile for a single company including current market stage, expansion signals, market presence, and stage-transition history for one or all markets.","exampleAgentPrompt":"Pull Pubrio's expansion detail for shopify.com in Japan — I want to see the current stage, market presence level, and the latest expansion signals from the past 90 days.","exampleUseCases":[{"title":"Qualifying a prospect for market-entry sales","prompt":"I sell Employer-of-Record services — can you look up the expansion profile for stripe.com in Singapore and tell me what stage they're at, how many local employees they have, and what signals suggest they're entering the market?"},{"title":"Competitive intelligence on a rival's APAC push","prompt":"We're competing with Workday in Australia — pull their expansion detail for workday.com in AU and show me the stage rank, presence level, and any recent hiring or office signals from the last 90 days."},{"title":"Prioritizing outbound accounts by expansion readiness","prompt":"I'm building a target list — look up the expansion stage for hubspot.com across all markets and tell me which markets show the highest stage rank and strongest signals right now."}],"resultDescription":"Returns a structured object containing the company's expansion stage name and rank, market presence level (established/emerging/none/no_data), local employee count and coverage flag, the evidence signals behind the stage, a one-line AI summary grounded to your query, stage-transition history, and company metadata (name, domain, logo, social URLs) on the first page.","failureModes":["HTTP 416 if page exceeds subscription's max_search_page limit","HTTP 416 with code 41676 if per_page exceeds subscription ceiling","No matching company found for the provided domain, LinkedIn URL, or domain_search_id","Insufficient headcount coverage causing local_people_coverage to be false","stage or presence returning no_data when the market has insufficient signal coverage","Rate limit or credit exhaustion errors"],"whenToPreferThis":"Choose this endpoint when you need deep, evidence-backed expansion intelligence for a specific company — including the current stage, market presence footprint, and the typed signals (hiring, offices, ads, news, infra) driving the assessment. Prefer it over a company search endpoint when you already know the company identity (domain, LinkedIn URL, or Pubrio ID) and want the full expansion narrative rather than a list of companies. It is especially valuable for APAC and emerging markets where Western-built datasets have gaps, since Pubrio aggregates 50+ local data sources.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":13,"lastUsedAt":"2026-10-09T15:30:38.485Z","lastSuccessfullyRanAt":"2026-10-09T15:30:38.485Z","lastHealthCheckAt":"2026-10-12T22:49:00.780Z","isFirstParty":false,"canonicalSlug":"agents-pubrio-com-company-expansion-detail-97c3a1de"}