# apollo.company.news

News articles about companies from their Apollo IDs

> Use the news articles search endpoint to find news articles related to specific companies.

Page: https://telipot.com/catalog/tasks/apollo.company.news · Markdown: https://telipot.com/catalog/tasks/apollo.company.news/md · JSON: https://telipot.com/catalog/tasks/apollo.company.news/json

| Field | Value |
| --- | --- |
| provider | [Apollo](https://telipot.com/catalog/providers/apollo) `apollo` |
| capability | [`company.news`](https://telipot.com/catalog/capabilities/company.news) |
| kind | data |
| tier | core |
| price | $0.0196 / call (1 credit · docs) |
| price note | 1 credit per page, up to 25 results per page; per_page does not change the charge. |
| identity | Your plan |
| auth | `api_key · in header as x-api-key` |
| scope | any_account |
| principal | organization |
| required_scopes | none |
| retention | standard |
| route | `POST https://api.apollo.io/api/v1/news_articles/search` |
| verification | Not verified yet. Not checked yet. We test with a real request before we mark it. |
| status | live |
| docs | https://docs.apollo.io/reference/news-articles-search |

## Preview the price · nothing runs

```bash
telipot run apollo.company.news \
  --input-json '{"organization_ids[]":["5e66b6381e05b4008c8331b8"],"per_page":1}' \
  --quote
```

## Run it

```bash
telipot run apollo.company.news \
  --input-json '{"organization_ids[]":["5e66b6381e05b4008c8331b8"],"per_page":1}'
```

```bash
curl https://api.telipot.com/v1/tasks/apollo.company.news/run \
  -H "Authorization: Bearer $TELIPOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"organization_ids[]":["5e66b6381e05b4008c8331b8"],"per_page":1}'
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `organization_ids[]` | queryParams | array | yes | at least 1 | Apollo IDs of the companies; company search returns them as id. |
| `categories[]` | queryParams | array | no |  | Only these news categories or sub-categories. Examples: hires; investment; contract. |
| `published_at[min]` | queryParams | string | no |  | Earliest publication date, YYYY-MM-DD; before published_at[max]. |
| `published_at[max]` | queryParams | string | no |  | Latest publication date, YYYY-MM-DD; after published_at[min]. |
| `page` | queryParams | integer | no | at least 1 | Page to return; use with per_page. Each page costs 1 credit. |
| `per_page` | queryParams | integer | no | 1 to 25 | Results per page, up to 25. |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "organization_ids[]": {
      "type": "array",
      "description": "Apollo IDs of the companies; company search returns them as id.",
      "examples": [
        [
          "5e66b6381e05b4008c8331b8"
        ]
      ],
      "minItems": 1
    },
    "categories[]": {
      "type": "array",
      "description": "Only these news categories or sub-categories. Examples: hires; investment; contract."
    },
    "published_at[min]": {
      "type": "string",
      "description": "Earliest publication date, YYYY-MM-DD; before published_at[max].",
      "examples": [
        "2025-02-15"
      ]
    },
    "published_at[max]": {
      "type": "string",
      "description": "Latest publication date, YYYY-MM-DD; after published_at[min].",
      "examples": [
        "2025-05-15"
      ]
    },
    "page": {
      "type": "integer",
      "description": "Page to return; use with per_page. Each page costs 1 credit.",
      "examples": [
        1
      ],
      "minimum": 1
    },
    "per_page": {
      "type": "integer",
      "description": "Results per page, up to 25.",
      "examples": [
        10
      ],
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "organization_ids[]"
  ],
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "properties": {
    "pagination": {
      "type": "object",
      "properties": {
        "page": {
          "type": "integer"
        },
        "per_page": {
          "type": "integer"
        },
        "total_entries": {
          "type": "integer"
        },
        "total_pages": {
          "type": "integer"
        }
      }
    },
    "news_articles": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "domain": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "snippet": {
            "type": "string"
          },
          "organization_ids": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "published_at": {
            "type": "string"
          },
          "event_categories": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```