Api Endpoint

Pubrio

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.

Open interactive test console

Offering

Provider
agents.pubrio.com
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Web Search Research
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://agents.pubrio.com/companies/news/search
MIME type
Not provided
First seen
2026-10-16T01:52:52.778Z
Last seen
Tags
market expansion, sales intelligence, company data, people data, lead enrichment

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.03 USDC
Atomic price: 30000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "30000",
    "payTo": "0xa330fbe0cdcf75e09b2f1c94c108be5aba31e322"
  }
]

Observed health

Status
Reachable
Latest latency
136 ms
Average latency
414 ms
HTTP status
400
Last checked
Reachability
100% over 10 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "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"
}

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"
}