# Company Pricing Plans (`company.pricing`)

Reads a company's pricing page and returns its plans with price, currency, billing interval, per-seat or usage unit, key limits and free-plan and trial flags.

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

- Endpoint: `POST https://api.primaryapi.com/v1/run/company.pricing`
- Category: Web Intelligence · Platform: `company` · Kind: scrape · 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.pricing`
- 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 | Pricing page URL. |
| `domain` | string | no |  | max 2048 chars | Company domain; the pricing page is looked for at /pricing, /plans and links on the home page. |

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 |
|---|---|---|
| `sourceUrl` | string |  |
| `plans` | object[] | Free plans first, then by price ascending, custom plans last. |
| `plans[].name` | string |  |
| `plans[].price` | number \| null | Numeric price per interval (null for custom / contact-sales plans). |
| `plans[].priceText` | string \| null | The price as the page shows it, e.g. "$10". |
| `plans[].currency` | string \| null | ISO 4217 code, e.g. "USD". |
| `plans[].interval` | enum \| null |  |
| `plans[].billedAnnually` | boolean \| null | true when the shown price assumes yearly billing. |
| `plans[].unit` | string \| null | What the price is per: "seat", "user", "1,000 requests", … |
| `plans[].isFree` | boolean |  |
| `plans[].isCustom` | boolean | Price on request / contact sales. |
| `plans[].trialDays` | integer \| null |  |
| `plans[].limits` | string[] | Key limits as stated (at most 8, sorted). |
| `planCount` | integer |  |
| `currency` | string \| null | Main currency of the page. |
| `freePlan` | boolean |  |
| `freeTrial` | boolean |  |
| `trialDays` | integer \| null |  |
| `source` | enum |  |
| `truncated` | boolean |  |

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.pricing" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://calendly.com/pricing"}'
```

## 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": {
      "sourceUrl": "https://calendly.com/pricing",
      "plans": [
        {
          "name": "Calendly Free",
          "price": 0,
          "priceText": "0 USD",
          "currency": "USD",
          "interval": null,
          "billedAnnually": null,
          "unit": null,
          "isFree": true,
          "isCustom": false,
          "trialDays": null,
          "limits": []
        },
        {
          "name": "Calendly Standard",
          "price": 10,
          "priceText": "10 USD",
          "currency": "USD",
          "interval": "month",
          "billedAnnually": true,
          "unit": "seat",
          "isFree": false,
          "isCustom": false,
          "trialDays": null,
          "limits": []
        }
      ],
      "planCount": 2,
      "currency": "USD",
      "freePlan": true,
      "freeTrial": false,
      "trialDays": null,
      "source": "structured_data",
      "truncated": false
    }
  },
  "provider": "PrimaryAPI",
  "credits": 1,
  "items": 1,
  "requestId": "req_01JBXK6Y2N9V8T4R3Q2P1M0A7Z"
}
```

## 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.pricing`

## 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

Pages that publish schema.org offers are read directly (1 credit); other pages are read with AI. No pricing page, or one whose plans appear only in a browser, is a free miss (reasons no_pricing_page, page_not_readable). 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.

