{"slug":"agents-pubrio-com-companies-news-search-a45d00","title":"Returns news articles about companies, filtered by company, search terms, catego","host":"agents.pubrio.com","method":"POST","resource":"https://agents.pubrio.com/companies/news/search","category":"company","description":"Returns news articles about companies, filtered by company, search terms, category, source, language, publish date and expansion signal type. 25 per page. Each call is 3 credits.","price_listed":0.03,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"domains":["stripe.com"],"per_page":5},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"example":{"domains":["stripe.com"],"per_page":5},"properties":{"categories":{"description":"List of category slugs for searching for specific news categories.","example":["launches"],"items":{"type":"string"},"type":"array"},"companies":{"description":"A list of unique identifiers (domain_search_id) used for company and people search operations.","items":{"format":"uuid","type":"string"},"type":"array"},"company_locations":{"allOf":[{"description":"The location of the company headquarters.","example":["US","SG","CN"],"items":{"type":"string"},"type":"array"}],"description":"Headquarters country of the companies the article mentions (ISO 3166-1 alpha-2), not where the story happened; for that, use locations."},"domains":{"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.","example":["pubrio.com"],"items":{"type":"string"},"type":"array"},"exclude_search_terms":{"description":"Leave out articles that mention any of these words, matched the same way as search_terms. exclude_keywords is accepted as another name.","example":["layoffs"],"items":{"type":"string"},"type":"array"},"exclude_sources":{"description":"Leave out articles from these publishers. Same format as sources. Articles with no recorded publisher are kept.","example":["prnasia.com"],"items":{"type":"string"},"type":"array"},"expansion_signal_polarities":{"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.","example":["expansion"],"items":{"enum":["expansion","contraction_leading","contraction_confirming","contraction_lagging"],"type":"string"},"type":"array"},"expansion_signal_types":{"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.","example":["HIRE","PARTNER"],"items":{"enum":["AD","AUDIENCE","DNS","ENTITY","EVENT","EVENT_PLUS","EXEC","HIRE","INFRA","IP","NEWS","OFFICE","PARTNER","PRODUCT","REG","SCALE","TECH"],"type":"string"},"type":"array"},"is_ascending_order":{"default":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.","example":false,"type":"boolean"},"is_expansion_signal_available":{"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.","type":"boolean"},"linkedin_urls":{"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"],"items":{"type":"string"},"type":"array"},"locations":{"allOf":[{"description":"ISO 3166-1 alpha-2 (cca2) is used for filtering locations.","example":["US","SG","CN"],"items":{"type":"string"},"type":"array"}],"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."},"news_galleries":{"description":"List of gallery slugs for filtering news by gallery.","example":["electronic-commerce"],"items":{"type":"string"},"type":"array"},"news_gallery_ids":{"description":"A list of news_gallery_id used to search for specific news galleries.","items":{"format":"uuid","type":"string"},"type":"array"},"news_languages":{"description":"List of locale_code values for filtering news by language.","example":["en"],"items":{"type":"string"},"type":"array"},"news_search_id":{"allOf":[{"description":"A unique identifier for the company news search operation.","example":"4110b929-17cd-42aa-a159-906ead0c9b56","format":"uuid","type":"string"}],"description":"Return only this one record. Handy for re-fetching a row you stored earlier without paging."},"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"},"published_at":{"description":"Published at or after this instant (UTC). Date or ISO timestamp. published_dates is the closed-window form and uses your workspace timezone.","example":"2026-09-01T00:00:00Z","format":"date-time","type":"string"},"published_dates":{"description":"Date range of the published date. The maximum value is the current day. Day boundaries follow your workspace timezone.","example":["2025-01-01","2025-01-10"],"items":{"type":"string"},"type":"array"},"search_term":{"description":"A string of words over which we want to filter the results.","example":"pubrio","type":"string"},"search_terms":{"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.","example":["Trump"],"items":{"type":"string"},"type":"array"},"sources":{"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.","example":["bbc.co.uk"],"items":{"type":"string"},"type":"array"}},"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":[],"description_full":"Returns news articles about companies, filtered by company, search terms, category, source, language, publish date and expansion signal type. 25 per page. Each call is 3 credits.","last_updated":"2026-10-11T23:26:02.484Z","schemes":["exact"]}