Skip to main content
POST
/
companies
/
news
/
search
Search for company news
curl --request POST \
  --url https://api.pubrio.com/companies/news/search \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "locations": [
    "US",
    "SG",
    "CN"
  ],
  "company_locations": [
    "US",
    "SG",
    "CN"
  ],
  "companies": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "domains": [
    "pubrio.com"
  ],
  "linkedin_urls": [
    "https://www.linkedin.com/company/pubrio"
  ],
  "search_term": "pubrio",
  "search_terms": [
    "Trump"
  ],
  "categories": [
    "launches"
  ],
  "news_gallery_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "published_dates": [
    "2025-01-01",
    "2025-01-10"
  ],
  "per_page": 25,
  "page": 1,
  "news_galleries": [
    "electronic-commerce"
  ],
  "news_languages": [
    "en"
  ],
  "profile_id": 123,
  "is_expansion_signal_available": true,
  "expansion_signal_types": [
    "HIRE",
    "PARTNER"
  ],
  "expansion_signal_polarities": [
    "expansion"
  ]
}
'
import requests

url = "https://api.pubrio.com/companies/news/search"

payload = {
    "locations": ["US", "SG", "CN"],
    "company_locations": ["US", "SG", "CN"],
    "companies": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "domains": ["pubrio.com"],
    "linkedin_urls": ["https://www.linkedin.com/company/pubrio"],
    "search_term": "pubrio",
    "search_terms": ["Trump"],
    "categories": ["launches"],
    "news_gallery_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "published_dates": ["2025-01-01", "2025-01-10"],
    "per_page": 25,
    "page": 1,
    "news_galleries": ["electronic-commerce"],
    "news_languages": ["en"],
    "profile_id": 123,
    "is_expansion_signal_available": True,
    "expansion_signal_types": ["HIRE", "PARTNER"],
    "expansion_signal_polarities": ["expansion"]
}
headers = {
    "pubrio-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {'pubrio-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    locations: ['US', 'SG', 'CN'],
    company_locations: ['US', 'SG', 'CN'],
    companies: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    domains: ['pubrio.com'],
    linkedin_urls: ['https://www.linkedin.com/company/pubrio'],
    search_term: 'pubrio',
    search_terms: ['Trump'],
    categories: ['launches'],
    news_gallery_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    published_dates: ['2025-01-01', '2025-01-10'],
    per_page: 25,
    page: 1,
    news_galleries: ['electronic-commerce'],
    news_languages: ['en'],
    profile_id: 123,
    is_expansion_signal_available: true,
    expansion_signal_types: ['HIRE', 'PARTNER'],
    expansion_signal_polarities: ['expansion']
  })
};

fetch('https://api.pubrio.com/companies/news/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.pubrio.com/companies/news/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'locations' => [
        'US',
        'SG',
        'CN'
    ],
    'company_locations' => [
        'US',
        'SG',
        'CN'
    ],
    'companies' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'domains' => [
        'pubrio.com'
    ],
    'linkedin_urls' => [
        'https://www.linkedin.com/company/pubrio'
    ],
    'search_term' => 'pubrio',
    'search_terms' => [
        'Trump'
    ],
    'categories' => [
        'launches'
    ],
    'news_gallery_ids' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'published_dates' => [
        '2025-01-01',
        '2025-01-10'
    ],
    'per_page' => 25,
    'page' => 1,
    'news_galleries' => [
        'electronic-commerce'
    ],
    'news_languages' => [
        'en'
    ],
    'profile_id' => 123,
    'is_expansion_signal_available' => true,
    'expansion_signal_types' => [
        'HIRE',
        'PARTNER'
    ],
    'expansion_signal_polarities' => [
        'expansion'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "pubrio-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pubrio.com/companies/news/search"

	payload := strings.NewReader("{\n  \"locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"company_locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"companies\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"domains\": [\n    \"pubrio.com\"\n  ],\n  \"linkedin_urls\": [\n    \"https://www.linkedin.com/company/pubrio\"\n  ],\n  \"search_term\": \"pubrio\",\n  \"search_terms\": [\n    \"Trump\"\n  ],\n  \"categories\": [\n    \"launches\"\n  ],\n  \"news_gallery_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"published_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"per_page\": 25,\n  \"page\": 1,\n  \"news_galleries\": [\n    \"electronic-commerce\"\n  ],\n  \"news_languages\": [\n    \"en\"\n  ],\n  \"profile_id\": 123,\n  \"is_expansion_signal_available\": true,\n  \"expansion_signal_types\": [\n    \"HIRE\",\n    \"PARTNER\"\n  ],\n  \"expansion_signal_polarities\": [\n    \"expansion\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("pubrio-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.pubrio.com/companies/news/search")
  .header("pubrio-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"company_locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"companies\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"domains\": [\n    \"pubrio.com\"\n  ],\n  \"linkedin_urls\": [\n    \"https://www.linkedin.com/company/pubrio\"\n  ],\n  \"search_term\": \"pubrio\",\n  \"search_terms\": [\n    \"Trump\"\n  ],\n  \"categories\": [\n    \"launches\"\n  ],\n  \"news_gallery_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"published_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"per_page\": 25,\n  \"page\": 1,\n  \"news_galleries\": [\n    \"electronic-commerce\"\n  ],\n  \"news_languages\": [\n    \"en\"\n  ],\n  \"profile_id\": 123,\n  \"is_expansion_signal_available\": true,\n  \"expansion_signal_types\": [\n    \"HIRE\",\n    \"PARTNER\"\n  ],\n  \"expansion_signal_polarities\": [\n    \"expansion\"\n  ]\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.pubrio.com/companies/news/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["pubrio-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"company_locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"companies\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"domains\": [\n    \"pubrio.com\"\n  ],\n  \"linkedin_urls\": [\n    \"https://www.linkedin.com/company/pubrio\"\n  ],\n  \"search_term\": \"pubrio\",\n  \"search_terms\": [\n    \"Trump\"\n  ],\n  \"categories\": [\n    \"launches\"\n  ],\n  \"news_gallery_ids\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"published_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"per_page\": 25,\n  \"page\": 1,\n  \"news_galleries\": [\n    \"electronic-commerce\"\n  ],\n  \"news_languages\": [\n    \"en\"\n  ],\n  \"profile_id\": 123,\n  \"is_expansion_signal_available\": true,\n  \"expansion_signal_types\": [\n    \"HIRE\",\n    \"PARTNER\"\n  ],\n  \"expansion_signal_polarities\": [\n    \"expansion\"\n  ]\n}"

response = http.request(request)
puts response.read_body
{
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_entries": 351800,
      "total_pages": 14072,
      "is_timeout": false
    },
    "news": [
      {
        "news_id": "0b0f1c53-7a04-4a46-b5bc-3b17a7c4cfbd",
        "news_search_id": "4110b929-17cd-42aa-a159-906ead0c9b56",
        "country_codes": [
          "CN",
          "SG"
        ],
        "company_country_codes": [
          "CN",
          "FR"
        ],
        "domains": [
          "insead.edu",
          "digitalchina.com"
        ],
        "companies": [
          {
            "logo_url": "https://buckets.pubrio.com/company-logo/MjY5OTY5NDJpbnNlYWQuZWR1bGlua2VkaW5fcF9sb2dvMTU=.jpg",
            "domain_search_id": "dfbe6797-5311-46f9-9518-bf1a7c3d09bc",
            "country_code": "FR",
            "company_name": "Insead",
            "linkedin_name": "insead",
            "domain": "insead.edu"
          },
          {
            "logo_url": "https://buckets.pubrio.com/company-logo/NDA2NTQ5NTFkaWdpdGFsY2hpbmEuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg",
            "domain_search_id": "e13a9e24-a07d-4630-9b47-fceb778df74e",
            "country_code": "CN",
            "company_name": "Digital China",
            "linkedin_name": "digital-china",
            "domain": "digitalchina.com"
          }
        ],
        "news_galleries": [
          {
            "slug": "banking-financial-service",
            "news_gallery_id": "7c8ec9cc-66c5-4153-82da-9c8f356c6c99",
            "name": "Banking/Financial Service"
          }
        ],
        "locations": [
          "Singapore",
          "China"
        ],
        "expansion_signals": [
          {
            "signal_type_slug": "HIRE",
            "signal_subtype_slug": null,
            "signal_strength_slug": "confirmed",
            "polarity": "expansion",
            "country_code": "SG",
            "domain_search_id": "bca54309-b804-48ac-b4f7-ff4d3796570c",
            "event_date": "2025-06-01T08:00:00.000Z"
          }
        ],
        "last_modified": "2025-06-01T08:15:23.945Z",
        "image_url": null,
        "url": "http://enold.prnasia.com/p/asia-story-125304015-0.shtml",
        "published_at": "2025-06-01T08:00:00.000Z",
        "language": "id",
        "source": "prnasia.com",
        "category": "launches",
        "title": "Digital China's AI-driven transformation showcased at INSEAD",
        "summary": "Guo Wei, Chairman of Digital China, presented on AI-era corporate management at INSEAD 2025 Asia AI Conference, launching a case study on Digital China's AI transformation journey.",
        "news_category_name": "Launches"
      },
      "..."
    ]
  }
}
{
  "code": 40001,
  "message": "Errors and codes will vary depending on the scenario, please see the documentation for information.",
  "details": {}
}
{
  "error": "Request rate limit exceeded. Please wait and try again later."
}
{
  "error": "An unexpected error occurred on the server."
}

Authorizations

​
pubrio-api-key
string
header
required

A unique API token that represents the actions you perform through the API and the corresponding permissions and operations. You can create it through the Settings section.

Body

application/json
​
locations
string[]

ISO 3166-1 alpha-2 (cca2) is used for filtering locations. Check out location endpoints under the Filters tab for more information.

Example:
["US", "SG", "CN"]
​
company_locations
string[]

The location of the company headquarters. Check out location endpoints under the Filters tab for more information.

Example:
["US", "SG", "CN"]
​
companies
string<uuid>[]

A list of unique identifiers (domain_search_id) used for company and people search operations.

​
domains
string[]

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"]
​
linkedin_urls
string[]

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"]
​
search_term
string

A string of words over which we want to filter the results.

Example:

"pubrio"

​
search_terms
string[]

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"]
​
categories
string[]

List of category slugs for searching for specific news categories. To find a slug, call the news categories endpoint under the Filters tab.

Example:
["launches"]
​
news_gallery_ids
string<uuid>[]

A list of news_gallery_id used to search for specific news galleries. To find the ID, call the news galleries endpoint under the Filters tab.

​
published_dates
string[]

Date range of the published date. The maximum value is the current day.

Example:
["2025-01-01", "2025-01-10"]
​
per_page
integer

The number of search results that should be returned for each page. Limited the number of results per page improves the endpoint's performance.

Example:

25

​
page
integer

The page number of the Pubrio data that you want to retrieve.

Example:

1

​
news_galleries
string[]

List of gallery slugs for filtering news by gallery. To find a slug, call the news galleries endpoint under the Filters tab.

Example:
["electronic-commerce"]
​
news_languages
string[]

List of locale_code values for filtering news by language. To find available codes, call the news languages endpoint under the Filters tab.

Example:
["en"]
​
profile_id
integer

Optional. An identifier for the user profile (workspace) making the request. This is no longer required as the API key already includes your workspace information. If provided, it helps in associating the lookup with a specific user, allowing for data retrieval and credit tracking.

Check out user details endpoints under the Profile tab for more information.

​
is_expansion_signal_available
boolean

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.

​
expansion_signal_types
enum<string>[]

Return only news that produced an expansion signal of one of these types (uppercase slugs). Requires is_expansion_signal_available: true. Unknown slugs are ignored.

Available options:
AD,
EVENT,
NEWS,
DNS,
TECH,
INFRA,
IP,
PARTNER,
EVENT_PLUS,
REG,
ENTITY,
EXEC,
OFFICE,
HIRE,
SCALE,
PRODUCT
Example:
["HIRE", "PARTNER"]
​
expansion_signal_polarities
enum<string>[]

Return only news whose expansion signal carries one of these polarities. Requires is_expansion_signal_available: true. Combined with expansion_signal_types as AND.

Available options:
expansion,
contraction_leading,
contraction_confirming,
contraction_lagging
Example:
["expansion"]

Response

Successful response containing company news search details.

​
data
object | null

Response info depends on specific endpoint.