{"uid":"cap_kp5TDSR2avwV6TiMAadDL","slug":"agents-pubrio-com-pubrio-company-news-search-911adb5d","name":"Pubrio Company News 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/companies/news/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."},"domains":{"type":"array","items":{"type":"string"},"example":["pubrio.com"],"description":"List of company domains used for company and people 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."},"sources":{"type":"array","items":{"type":"string"},"example":["bbc.co.uk"],"description":"Only articles from these publishers. Use the publisher's domain, e.g. bbc.co.uk, the same value as the source field on every article. A full URL or a www. address also works."},"per_page":{"type":"integer","default":25,"example":25,"maximum":25,"description":"Records per page, 1 to 25. Defaults to 25."},"companies":{"type":"array","items":{"type":"string","format":"uuid"},"description":"A list of unique identifiers (domain_search_id) used for company and people search operations."},"locations":{"allOf":[{"type":"array","items":{"type":"string"},"example":["US","SG","CN"],"description":"ISO 3166-1 alpha-2 (cca2) is used for filtering locations."}],"description":"Countries the story itself is about, read from the article text (ISO 3166-1 alpha-2). Empty when the article names no place. For where a mentioned company is headquartered, use company_locations."},"categories":{"type":"array","items":{"type":"string"},"example":["launches"],"description":"List of category slugs for searching for specific news categories."},"search_term":{"type":"string","example":"pubrio","description":"A string of words over which we want to filter the results."},"published_at":{"type":"string","format":"date-time","example":"2026-09-01T00:00:00Z","description":"Published at or after this instant (UTC). Date or ISO timestamp. published_dates is the closed-window form and uses your workspace timezone."},"search_terms":{"type":"array","items":{"type":"string"},"example":["Trump"],"description":"Array of keyword strings to filter news articles. Each term is matched against article content. Use search_term for a single string or search_terms for multiple keywords."},"linkedin_urls":{"type":"array","items":{"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/"},"news_galleries":{"type":"array","items":{"type":"string"},"example":["electronic-commerce"],"description":"List of gallery slugs for filtering news by gallery."},"news_languages":{"type":"array","items":{"type":"string"},"example":["en"],"description":"List of locale_code values for filtering news by language."},"news_search_id":{"allOf":[{"type":"string","format":"uuid","example":"4110b929-17cd-42aa-a159-906ead0c9b56","description":"A unique identifier for the company news search operation."}],"description":"Return only this one record. Handy for re-fetching a row you stored earlier without paging."},"exclude_sources":{"type":"array","items":{"type":"string"},"example":["prnasia.com"],"description":"Leave out articles from these publishers. Same format as sources. Articles with no recorded publisher are kept."},"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."},"news_gallery_ids":{"type":"array","items":{"type":"string","format":"uuid"},"description":"A list of news_gallery_id used to search for specific news galleries."},"company_locations":{"allOf":[{"type":"array","items":{"type":"string"},"example":["US","SG","CN"],"description":"The location of the company headquarters."}],"description":"Headquarters country of the companies the article mentions (ISO 3166-1 alpha-2), not where the story happened; for that, use locations."},"is_ascending_order":{"type":"boolean","default":false,"example":false,"description":"Sort direction. Results are returned newest-first by default; set true for oldest-first. There is no sort_by on this endpoint, the sort key is fixed and stated in the endpoint description."},"exclude_search_terms":{"type":"array","items":{"type":"string"},"example":["layoffs"],"description":"Leave out articles that mention any of these words, matched the same way as search_terms. exclude_keywords is accepted as another name."},"expansion_signal_types":{"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":["HIRE","PARTNER"],"description":"Return only news that produced an expansion signal of one of these types (uppercase slugs). Requires is_expansion_signal_available: true. A list with only unknown slugs matches nothing."},"expansion_signal_polarities":{"type":"array","items":{"enum":["expansion","contraction_leading","contraction_confirming","contraction_lagging"],"type":"string"},"example":["expansion"],"description":"Return only news whose expansion signal carries one of these polarities. Requires is_expansion_signal_available: true. Combined with expansion_signal_types as AND."},"is_expansion_signal_available":{"type":"boolean","description":"When true, attaches the resolved expansion signals (expansion_signals) to each news item and enables the expansion_signal_types / expansion_signal_polarities filters. Leave unset for the fastest search, the expansion join is only added when this flag is on."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"news":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","description":"Link to the article."},"title":{"type":"string","description":"Headline."},"source":{"type":"string","nullable":true,"description":"Publisher domain."},"domains":{"type":"array","items":{"type":"string"},"description":"Domains of every company the article mentions."},"news_id":{"type":"string","format":"uuid","description":"Article identifier."},"summary":{"type":"string","nullable":true,"description":"Short summary of the article."},"category":{"type":"string","nullable":true,"description":"News category slug. Same vocabulary as the `categories` filter and the News Categories endpoint."},"language":{"type":"string","nullable":true,"description":"ISO 639-1 language code of the article. Same vocabulary as the `news_languages` filter."},"companies":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string","description":"Company domain, normalised (`stripe.com`)."},"logo_url":{"type":"string","nullable":true,"description":"Company logo URL."},"company_url":{"type":"string","nullable":true,"description":"Company website URL."},"company_name":{"type":"string","description":"Company name."},"country_code":{"type":"string","nullable":true,"description":"ISO 3166-1 alpha-2 code of the company headquarters."},"linkedin_name":{"type":"string","nullable":true,"description":"LinkedIn company slug (the part after `linkedin.com/company/`)."},"domain_search_id":{"type":"string","format":"uuid","description":"Pubrio company identifier. Pass it to `companies` on any search, or to Company Lookup."}},"description":"The company the record is linked to."},"description":"Every company the article mentions, in the same order as `domains`."},"image_url":{"type":"string","nullable":true,"description":"Lead image, when the article has one."},"locations":{"type":"array","items":{"type":"string"},"nullable":true,"description":"Place names mentioned in the article; `null` when none."},"published_at":{"type":"string","format":"date-time","nullable":true,"description":"Publication time. This is the default sort key (undated articles sort last)."},"country_codes":{"type":"array","items":{"type":"string"},"nullable":true,"description":"Countries the article is about (ISO 3166-1 alpha-2); `null` when not detected. Same vocabulary as the `locations` filter."},"last_modified":{"type":"string","format":"date-time","description":"When the record was last updated."},"news_galleries":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"news_gallery_id":{"type":"string","format":"uuid"}}},"nullable":true,"description":"Galleries the article belongs to; `null` when none."},"news_search_id":{"type":"string","format":"uuid","description":"Search-record identifier. Pass it to News Lookup."},"expansion_signals":{"type":"array","items":{"type":"object","properties":{"polarity":{"type":"string","description":"`expansion`, `contraction_leading`, `contraction_confirming` or `contraction_lagging`."},"event_date":{"type":"string","format":"date-time","description":"When the signal occurred."},"country_code":{"type":"string","nullable":true,"description":"Market the signal points at."},"domain_search_id":{"type":"string","format":"uuid","description":"Company the signal belongs to."},"signal_type_slug":{"type":"string","description":"Signal type, e.g. `HIRE`, `PARTNER`, `PRODUCT`."},"signal_subtype_slug":{"type":"string","nullable":true,"description":"Signal subtype, when the type has one."},"signal_strength_slug":{"type":"string","description":"Signal strength: `low`, `medium`, `high`, `very_high`."}}},"description":"Only when `is_expansion_signal_available: true`: the expansion signals this article produced. Empty array when none."},"news_category_name":{"type":"string","nullable":true,"description":"Human-readable category name, localised to `language`."},"company_country_codes":{"type":"array","items":{"type":"string"},"nullable":true,"description":"Headquarters countries of the companies mentioned. Same vocabulary as the `company_locations` filter."}},"description":"One news article."}},"pagination":{"type":"object","properties":{"page":{"type":"integer","description":"Current page number."},"per_page":{"type":"integer","description":"Records per page."},"is_timeout":{"type":"boolean","description":"`true` when the search ran out of time. `total_entries` then only counts the rows returned so far, and an empty page means the search did not finish, not that nothing matched."},"total_pages":{"type":"integer","description":"`total_entries` divided by `per_page`."},"is_estimated":{"type":"boolean","description":"`true` when `total_entries` is an estimate rather than an exact count. Do not use an estimated total to decide when to stop paging; stop when a page returns fewer rows than `per_page`."},"total_entries":{"type":"integer","description":"Total matching records. An estimate when `is_estimated` is `true`."},"total_display_pages":{"type":"integer","description":"Page count for this result, capped by your plan's `max_display_search_page`."}},"description":"Pagination for the result set."}}},"metadata":{"type":"object","properties":{"filters":{"type":"object","description":"Echo of the request body as the endpoint applied it, including defaults such as `per_page` and `language`."},"profile":{"type":"object","nullable":true,"description":"Credit block (`credit`, `topup_credit`, `total_credit_cost`) when credit accounting is requested; `null` on plain API-key traffic."},"ignored_fields":{"type":"array","items":{"type":"string"},"description":"Body keys the endpoint did not recognise and dropped. Empty means every key applied — a misspelled filter widens the search instead of failing."}},"description":"Request context."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.03","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aaq6fmDuBbhcYX2g9fvZt","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_m5UeRfVtQ5xmYDBATPy2g","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","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":"Search for news articles about specific companies by keyword, domain, publisher, language, location, or topic category.","exampleAgentPrompt":"Find me the latest English-language news articles about Stripe and Adyen from sources like techcrunch.com and ft.com — search for 'fintech expansion' and show me the first 25 results.","exampleUseCases":[{"title":"Competitor press coverage monitoring","prompt":"Search for news articles mentioning Salesforce and HubSpot with the query 'CRM market share' — filter to English-language articles from the US and show me up to 25 results on page 1."},{"title":"Market entry signal detection","prompt":"Find recent news about Tesla expanding into Southeast Asian markets — filter by locations SG, TH, and MY, in English, and give me the first page of results."},{"title":"Due diligence news research","prompt":"Pull the latest news articles about OpenAI from techcrunch.com and reuters.com — use the query 'funding valuation' and return the first 25 English results so I can review their press coverage before our meeting."}],"resultDescription":"Returns a paginated list of news articles, each with the article URL, headline, publisher domain, short summary, category slug, ISO 639-1 language code, publication date, lead image URL, geographic locations the story covers, and an array of mentioned companies (with their domain, name, logo URL, country code, LinkedIn slug, and Pubrio company ID). Also returns total result count and pagination metadata.","failureModes":["HTTP 416 with code 41676 when per_page exceeds the subscription's max_search_per_page limit","HTTP 416 when page exceeds the subscription's max_search_page limit","Empty results array when no articles match the query or filters","Invalid UUID format for companies parameter returns a validation error","Unsupported language code in news_languages filter may return no results or an error","Subscription plan may restrict access to certain filter combinations or result volumes"],"whenToPreferThis":"Use this endpoint when you need to search and filter news coverage specifically tied to known companies — especially when you want to cross-reference articles with structured company data (domains, Pubrio IDs, LinkedIn slugs). Prefer this over generic news APIs when you need to filter by company domain, publisher source, geographic focus, or language, and when you want company metadata attached to each article. Particularly strong for Asia-Pacific company coverage that Western news datasets miss.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T21:42:12.676Z","isFirstParty":false,"canonicalSlug":"agents-pubrio-com-pubrio-company-news-search-911adb5d"}