> For the complete documentation index, see [llms.txt](https://developer.parvenu.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.parvenu.io/enrichments/company-news/individual-lookup.md).

# Individual Lookup

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

<mark style="color:green;">`POST`</mark> `/company_news`

{% hint style="info" %}
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.
{% endhint %}

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](/enrichments/research-with-ai.md) 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**

{% tabs %}
{% tab title="Input" %}

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

{% endtab %}

{% tab title="Output" %}

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

{% endtab %}

{% tab title="No news" %}

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

{% endtab %}

{% tab title="Error" %}

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

{% endtab %}
{% endtabs %}

**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](/getting-started/response-format.md) for the fields every endpoint returns.

To run this against every row of a list in one call instead, use [List Lookup](/enrichments/company-news/list-lookup.md).