<!-- AUTO-GENERATED from the capability registry — regenerate: npm run generate:registry -->

# `predictleads.followedCompanies` — PredictLeads operation

> Direct access to PredictLeads's own API, priced in dollars on your Orange Slice key.
> Everything we expose, with prices: https://orangeslice.ai/llms.txt

Retrieve followed companies

## Price

**$0.002 per result, minimum $0.01, up to $2.00 per call**

Billed per row returned, within the floor and ceiling above.

Orange Slice holds the PredictLeads contract. You never sign up for
them, hold their key, or reconcile their invoice.


## Call it

**CLI**

```bash
orangeslice predictleads followed-companies --param limit=10
```

**HTTP**

```bash
curl -X POST 'https://orangeslice.ai/api/v1/run' \
  -H 'Authorization: Bearer $ORANGESLICE_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"capability":"predictleads.followedCompanies","input":{"params":"<json>"}}'
```

## Inputs

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `params` | json | No | Query parameters passed straight to PredictLeads |

## Output

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## Before you run

- **Price it first.** `orangeslice predictleads followed-companies --dry-run` returns the
  exact dollar cost and spends nothing.
- **Large runs need approval.** Above the spend-gate threshold a run exits **7**
  until it carries a plan token, and only a dry run mints one.
- **Scopes:** enrich
- **Permitted uses:** research, outreach, export

## Exit codes

`0` ok · `2` bad input · `3` auth · `4` not found · `5` provider ·
`6` rate limited · `7` spend gate, nothing billed · `8` timeout ·
`9` a third-party account needs connecting
