Individual Lookup

Find one company's recent news from its domain and get it back directly. Synchronous.

POST /company_news

Costs 1 credit, charged only when news is found — the same rate a row of List Lookup costs, so the price does not change with how you call it. Returns the answer directly in the response, no list and no polling.

Pass a company domain. There is no prompt on this endpoint: Company News asks a fixed question, so you supply the company and the API supplies the question. To ask something in your own words, use Research with AI instead.

A full URL is accepted. The scheme, www. and any path or query string are stripped before the search, so https://www.stripe.com/pricing?x=1 and stripe.com behave identically.

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
api_key	string	Your API Key.
domain	string	Company domain, e.g. acme.com. A full URL is also accepted.

Outcomes

Three responses, kept distinct so you never have to guess which one you got:

status	HTTP	Meaning	Charged
success	200	News found, in data.company_news.	1
not_found	200	A real company with no dated news in the last 12 months.	No
error	400	The domain does not resolve. Check it for a typo.	No

A quiet quarter and a domain that does not exist read identically in the model's answer, so the domain is checked before the model is called and the two are reported differently.

Only dated, substantive events from the last 12 months count — funding, launches, partnerships, acquisitions, expansion, awards, leadership hires. Website updates, routine blog posts, directory listings and undated items are deliberately excluded, and a company with none of the former returns not_found rather than filler.

Example

Input

{
  "api_key": "your_api_key",
  "domain": "automationintellect.com"
}

Output

{
  "status": "success",
  "data": {
    "domain": "automationintellect.com",
    "company_news": "2026-05 — Automation Intellect acquires DECIDE4ACTION. The acquisition adds DECIDE4ACTION's manufacturing decision-support platform to Automation Intellect's plant-floor analytics suite."
  },
  "credits_used": 1,
  "credits_remaining": 4823,
  "success": true
}

No news

{
  "status": "not_found",
  "data": {
    "domain": "acme.com",
    "company_news": null
  },
  "credits_used": 0,
  "credits_remaining": 4823,
  "message": "No recent news found for this company.",
  "success": true
}

Error

{
  "status": "error",
  "error": {
    "code": "domain_not_found",
    "message": "'notarealdomain12345.xyz' does not resolve — check the domain. No credits were charged."
  },
  "data": {
    "domain": "notarealdomain12345.xyz",
    "company_news": null
  },
  "success": false
}

Response

Field	Type	Description
domain	string	The bare domain that was searched, with scheme, www. and any path removed.
company_news	string	The news prose, or null when nothing dated was found in the window.

The record is under data. See Response Format for the fields every endpoint returns.

To run this against every row of a list in one call instead, use List Lookup.