{"slug":"agents-pubrio-com-expansions-companies-lookup-e62755","title":"Returns one company's expansion profile by domain, LinkedIn URL or Pubrio id","host":"agents.pubrio.com","method":"POST","resource":"https://agents.pubrio.com/expansions/companies/lookup","category":"company","description":"Returns one company's expansion profile by domain, LinkedIn URL or Pubrio id: stage per market, signals, market presence, stage history and expansion score, for one market or all markets, with an optional AI summary against your query. Each call is 5 credits.","price_listed":0.05,"price_asked":0.05,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":576,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"domain":"stripe.com","is_all_markets":true,"summary_only":true},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"anyOf":[{"required":["domain_search_id"]},{"required":["domain"]},{"required":["linkedin_url"]}],"example":{"domain":"stripe.com","is_all_markets":true,"summary_only":true},"properties":{"country_code":{"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.","example":"US","type":"string"},"domain":{"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.","example":"pubrio.com","type":"string"},"domain_search_id":{"description":"A unique identifier for the company search operation.","format":"uuid","type":"string"},"is_all_markets":{"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.","example":false,"type":"boolean"},"is_explain_match":{"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.","example":true,"type":"boolean"},"is_include_established":{"description":"Include the established stage (long-standing operators with no active expansion signals). Defaults to false.","example":false,"type":"boolean"},"is_include_metadata":{"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.","example":true,"type":"boolean"},"linkedin_url":{"description":"The fully formed URL of the LinkedIn company profile. URL begin with http and contain linkedin.com/company/","example":"https://www.linkedin.com/company/pubrio","type":"string"},"markets_summary_full":{"description":"Include the full ranked market set as markets_summary alongside the capped other_markets list.","example":true,"type":"boolean"},"page":{"default":1,"description":"Page number, starting at 1.","example":1,"type":"integer"},"per_page":{"default":25,"description":"Records per page, 1 to 25. Defaults to 25.","example":25,"maximum":25,"type":"integer"},"query":{"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.","example":"We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.","type":"string"},"signal_type":{"description":"Filter the returned signals to a single type.","enum":["AD","AUDIENCE","DNS","ENTITY","EVENT","EVENT_PLUS","EXEC","HIRE","INFRA","IP","NEWS","OFFICE","PARTNER","PRODUCT","REG","SCALE","TECH"],"example":"EXEC","type":"string"},"summary_only":{"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.","example":true,"type":"boolean"},"transitioned_dates":{"description":"ISO [from, to] date range for the signal/transition window. Takes precedence over window_days when both are supplied.","example":["2026-04-01","2026-06-29"],"items":{"format":"date","type":"string"},"type":"array"},"window_days":{"default":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).","example":90,"type":"integer"}},"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-18","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.05,"price_match":true,"latency_ms":576,"error":null}],"description_full":"Returns one company's expansion profile by domain, LinkedIn URL or Pubrio id: stage per market, signals, market presence, stage history and expansion score, for one market or all markets, with an optional AI summary against your query. Each call is 5 credits.","last_updated":"2026-10-11T23:26:23.939Z","schemes":["exact"]}