# Company Changelog (`company.changelog`)

Returns a product's latest changelog or release-note entries with date, title, summary and link, from its RSS or Atom feed, GitHub releases, or the changelog page itself.

Docs: https://primaryapi.com/docs/api-reference/company/changelog

- Endpoint: `POST https://api.primaryapi.com/v1/run/company.changelog`
- Category: Web Intelligence · Platform: `company` · Kind: list · Status: live
- Price: 1 credit per call; up to 8 credits if a call is retried elsewhere. A quote’s `maxCredits` is the most a given call can cost.
- Billing unit: per successful call
- Reliability: routed to a healthy upstream and retried automatically when an attempt fails; live 30-day status: `GET https://api.primaryapi.com/v1/status/apis?sku=company.changelog`
- Execution: durable: may answer 202 and finish in the background; poll `GET /v1/requests/{id}`

## Input

| Field | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| `url` | string | no |  | max 2048 chars; format: uri | Changelog page, RSS/Atom feed, or GitHub repository URL. |
| `domain` | string | no |  | max 2048 chars | Company domain; the changelog is looked for at /changelog, /releases, /release-notes and home-page links. |
| `limit` | integer | no | 20 | 1–50 | Maximum number of results to return (1-50, default 20). |

Unknown fields are rejected with `400 invalid_input`. The routing controls `preferLatencyUnderMs` and `maxCredits` may be sent in the same JSON body.

## Output

When `output.found` is `true`, `output.data` has this shape:

| Field | Type | Description |
|---|---|---|
| `entries` | object[] | Newest first; entries without a date last. |
| `entries[].date` | string \| null | Release date, ISO 8601 (YYYY-MM-DD, or a full timestamp when the source has one). |
| `entries[].title` | string |  |
| `entries[].summary` | string \| null | Plain-text summary, at most 500 characters. |
| `entries[].url` | string \| null | Link to the entry. |
| `entries[].version` | string \| null | Version or tag when the source gives one. |
| `sourceUrl` | string | Page, feed or repository the entries come from. |
| `feedUrl` | string \| null |  |
| `source` | enum |  |
| `truncated` | boolean | More entries exist than `limit`, or the page was too long to read in full. |
| `nextCursor` | string \| null |  |

When the thing you asked about does not exist (or a search matches nothing) the call still succeeds: `output.found` is `false`, `output.data` is `null` and `output.reason` says why (`not_found`, `private`, `no_results`, …). Misses are free unless the notes below say misses are billed.

## Example request

```bash
curl -sS -X POST "https://api.primaryapi.com/v1/run/company.changelog" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://github.blog/changelog/","limit":1}'
```

## Example response

_Values are placeholders that follow the output schema; `credits` is what this call would cost at the usual price._

```json
{
  "output": {
    "found": true,
    "data": {
      "entries": [
        {
          "date": "2026-11-13T20:40:05.000Z",
          "title": "Upcoming deprecation of selected GitHub Copilot models in December",
          "summary": "We will deprecate the following models…",
          "url": "https://github.blog/changelog/2026-11-13-upcoming-deprecation-of-selected-github-copilot-models-in-december",
          "version": null
        }
      ],
      "sourceUrl": "https://github.blog/changelog/",
      "feedUrl": "https://github.blog/changelog/feed/",
      "source": "rss",
      "truncated": true,
      "nextCursor": null
    }
  },
  "provider": "PrimaryAPI",
  "credits": 1,
  "items": 1,
  "requestId": "req_01JBXK6Y2N9V8T4R3Q2P1M0A7Z",
  "nextCursor": null
}
```

## Pricing and reliability

- Usual price: 1 credit per call
- Price ceiling: up to 8 credits if a call is retried elsewhere. A quote’s `maxCredits` is the most a given call can cost; the `maxCredits` routing control caps it per call
- Live 30-day status, success rate, uptime and latency: `GET https://api.primaryapi.com/v1/status/apis?sku=company.changelog`

## Errors to handle

`invalid_input`, `unauthorized`, `insufficient_balance`, `key_limit_reached`, `trial_cap_reached`, `forbidden`, `not_found`, `idempotency_conflict`, `rate_limited`, `all_sources_failed`, `service_unavailable`, `timeout`. See https://primaryapi.com/docs/errors.

## Notes

Feeds are read directly (1 credit); a changelog page without a feed is read with AI. Nothing found is a free miss (reason no_changelog). Pagination is not offered: the newest `limit` entries are returned. Text read with AI is checked against the page: names and quotes that do not appear in it are dropped. Treat extracted facts as a starting point and confirm them in the source before relying on them. Pages are read the way a polite crawler would: robots.txt is honoured (a disallowed page is a free miss with reason robots_disallowed), requests are paced per site, and only facts, short quotes and source links are returned. Outputs are stable between runs of an unchanged page (sorted lists, normalised whitespace, no timestamps), so the API can be scheduled as a monitor that fires only when the content changes.

