{"uid":"cap_Bou10nEMxvWqlDYXEF1Gy","slug":"agents-pubrio-com-expansion-signal-search-0312ced4","name":"Expansion Signal Search","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/signals/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"page":{"type":"integer","default":1,"example":1,"description":"Page number, starting at 1."},"per_page":{"type":"integer","default":25,"example":25,"maximum":25,"description":"Records per page, 1 to 25. Defaults to 25."},"is_active":{"type":"boolean","default":true,"example":true,"description":"true (the default) returns live signals only; false returns retracted signals only."},"polarities":{"type":"array","items":{"enum":["expansion","contraction_leading","contraction_confirming","contraction_lagging"],"type":"string"},"example":["expansion"],"description":"Signal directions to include. expansion marks entry and growth; the contraction_* values mark retreat."},"event_dates":{"type":"array","items":{"type":"string"},"example":["2026-06-01","2026-06-30"],"description":"Date range of the signal event date. The maximum value is the current day."},"signal_types":{"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."}],"description":"Signal types to restrict to. Unknown values match nothing."},"source_types":{"type":"array","items":{"type":"string"},"example":["jobs","ads"],"description":"Source types to restrict to: jobs, ads, linkedin, news, pubrio."},"country_codes":{"type":"array","items":{"type":"string"},"example":["US","GB"],"description":"Target markets to restrict to, as ISO 3166-1 alpha-2 codes."},"signal_subtypes":{"allOf":[{"type":"array","items":{"enum":["marketing_pullback","domain_dropped","entity_dissolution","exhibiting_booth","speaking_breakout","speaking_keynote","sponsorship","key_departure","country_manager","engineering","freelancer","hiring_freeze","job_posting_removal","legal_compliance","local_employee","operations","regional_vp","remote_sales_bd","supply_chain","ip_abandoned","office_closure","partnership_terminated","product_withdrawal","regulatory_surrender","layoffs","content_decay"],"type":"string"},"example":["country_manager","local_employee"]}],"description":"Signal subtypes to restrict to. Unknown values match nothing."},"signal_strengths":{"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."}],"description":"Signal strengths to restrict to. Unknown values match nothing."},"domain_search_ids":{"type":"array","items":{"type":"string"},"example":["8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c"],"description":"Companies to restrict to, by domain_search_id."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"signals":{"type":"array","items":{"type":"object","properties":{"audit":{"type":"object","properties":{"user_id":{"type":"string","format":"uuid","nullable":true},"import_id":{"type":"string","nullable":true},"profile_id":{"type":"integer","nullable":true},"is_backfill":{"type":"boolean"}},"description":"Provenance of the row: `profile_id` and `user_id` are set for user-imported signals, `import_id` groups a bulk import, and `is_backfill` marks rows added by a historical backfill."},"notes":{"type":"string","nullable":true,"description":"Free-text annotation. Usually `null`."},"metadata":{"type":"object","description":"Source-specific detail. Its keys vary by `source_type` — job rows carry `departments`, `seniority`, `top_titles`, `active_postings`; ad rows carry `advertisement_format`, `headline`, `share_pct`."},"polarity":{"type":"string","description":"Signal direction: `expansion`, or one of the three `contraction_*` values."},"is_active":{"type":"boolean","description":"`true` for live signals, `false` once a signal has been retracted."},"occurs_at":{"type":"string","format":"date-time","nullable":true,"description":"Start of the window the signal covers, for signals that span a period."},"created_at":{"type":"string","format":"date-time","description":"When the signal row was created."},"event_date":{"type":"string","format":"date-time","description":"When the underlying event happened. Read together with `event_date_precision`."},"source_type":{"type":"string","description":"Where the signal came from. Observed values: `jobs`, `ads`, `linkedin`, `news`, `pubrio`."},"country_code":{"type":"string","description":"Target market this signal was observed in, as an ISO 3166-1 alpha-2 code."},"evidence_url":{"type":"string","nullable":true,"description":"Link to the supporting evidence. Frequently `null` — most rows are derived from structured sources rather than a citable page."},"occurs_until":{"type":"string","format":"date-time","nullable":true,"description":"End of the window the signal covers, for signals that span a period."},"display_label":{"type":"string","description":"Human-readable one-line summary of the signal."},"last_modified":{"type":"string","format":"date-time","description":"When the signal row was last updated."},"lead_time_days":{"type":"integer","nullable":true,"description":"Days between the source being published and the event date, when both are known."},"domain_search_id":{"type":"string","format":"uuid","description":"The company this signal belongs to. Use it with [Company Expansion Detail](/en/api-reference/endpoint/expansions/company_lookup)."},"extraction_model":{"type":"string","nullable":true,"description":"Name of the extracting model, when one was used."},"signal_type_slug":{"type":"string","description":"Signal type. One of the 17 slugs returned by [Expansion Reference](/en/api-reference/endpoint/expansions/types)."},"source_record_id":{"type":"string","nullable":true,"description":"Identifier of the source record the signal was derived from, when one exists."},"expansion_signal_id":{"type":"integer","description":"Unique identifier for this signal row."},"signal_subtype_slug":{"type":"string","nullable":true,"description":"Finer-grained subtype, or `null` when the type has no subtype. About 44% of rows are `null`."},"source_published_at":{"type":"string","format":"date-time","nullable":true,"description":"Publication time of the source document, when known."},"event_date_precision":{"type":"string","description":"How precise `event_date` is: `day`, `month`, `quarter`, `year` or `unknown`."},"signal_strength_slug":{"type":"string","description":"Signal strength: `low`, `medium`, `high` or `very_high`."},"extraction_confidence":{"type":"number","nullable":true,"description":"Model confidence for signals extracted by a model, otherwise `null`."}}},"description":"The matching signal rows, newest first."},"pagination":{"type":"object","description":"Page, per-page, total entries and total pages."}},"description":"Result container."},"metadata":{"type":"object","description":"Echo of the filters applied to this request."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":"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_v-QcveioHz1ER2pvo2yE7","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_NiYHPBv8TmHmQ8_IzlOos","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 raw, paginated expansion signal rows — the dated evidence behind a company's market stage, with source type and evidence URL.","exampleAgentPrompt":"Pull the first page of live expansion signals for Grab in Southeast Asia from January 2025 to June 2025, filtering for HIRE and OFFICE signal types, 25 results per page.","exampleUseCases":[{"title":"Auditing a competitor's market entry evidence","prompt":"Show me the raw expansion signals behind Shopee's entry into new markets between March 2025 and June 2025 — I want to see the source type and any evidence URLs, just live signals, expansion polarity only, first page of 25."},{"title":"Detecting early contraction signs","prompt":"Pull the most recent contraction_leading and contraction_confirming signals for ByteDance across any market in 2025, page 1 with 25 results, so I can see what's being retracted."},{"title":"Tracking executive-hire signals for market expansion research","prompt":"Search for EXEC and HIRE expansion signals dated between January 1 2025 and June 30 2025, active only, give me page 1 with 25 results per page — I'm researching which companies are staffing up for new market pushes."}],"resultDescription":"A paginated array of signal objects, each containing the event date and precision, polarity (expansion or contraction variant), source type (jobs, ads, linkedin, news, pubrio), country code, optional evidence URL, signal-type-specific metadata (e.g. job departments or ad headlines), audit provenance fields, and active/retracted status.","failureModes":["HTTP 416 returned when requested page exceeds subscription's max_search_page limit","HTTP 416 with code 41676 when per_page exceeds subscription's max_search_per_page","Invalid signal_type enum values cause validation errors","Empty result set when no signals match the specified filters and date range","Null evidence_url on most rows since many signals are derived from structured sources without a citable page"],"whenToPreferThis":"Choose this endpoint when you need the raw, row-level evidence behind a company's expansion stage — individual dated signal rows with source provenance and evidence links — rather than aggregated summaries or ranked lists. Use it for auditing, building custom analytics pipelines, or verifying specific market-entry events. Prefer the Expansion Search endpoint for discovering which companies are expanding, and the Expansion Overview for market-level KPIs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:30:49.303Z","isFirstParty":false,"canonicalSlug":"agents-pubrio-com-expansion-signal-search-0312ced4"}