# Company Expansion Detail > Company Expansion Detail is a paid API for AI agents from agents.pubrio.com, paid per call via MPP or x402, $0.05/call, status healthy (last checked 2026-10-12, last successful call 2026-10-09). 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. ## Facts - Endpoint: POST https://agents.pubrio.com/expansions/companies/lookup?utm_source=zero.xyz - Price: $0.05/call - Payment: MPP, x402 - Status: healthy - Last checked: 2026-10-12 - Last successful call: 2026-10-09 - Success rate: 100% of calls made through Zero - Rating: 5.0 / 5 from 1 review - Activations on Zero: 13 - Provider: agents.pubrio.com - Website: https://agents.pubrio.com - Tags: x402 - Canonical page: https://www.zero.xyz/c/agents-pubrio-com-company-expansion-detail-97c3a1de - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qj6Mr-TEZ380nu2nCwucu Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability agents-pubrio-com-company-expansion-detail-97c3a1de -d '' ``` Example prompt: 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. ## When to prefer this 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. ## Known failure modes - 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 ## How this service works 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. ## Output 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. ## Request schema (JSON Schema) ```json { "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", "e … (truncated) ``` ## Response schema (JSON Schema) ```json { "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 … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-pubrio-com-company-expansion-detail-97c3a1de/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from agents.pubrio.com](https://www.zero.xyz/host/agents.pubrio.com/llms.txt)