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

# `company_linkedin_enrich` — Orange Slice capability

> Outcome-priced capability. One price for the answer, whichever providers it took.
> Everything we expose, with prices: https://orangeslice.ai/llms.txt

Reads a company's record from the B2B database — size, industry, description, location — in one indexed lookup. One credit, billed only when the company is found.

## Price

**$0.002, charged per hit**

Billed only when the answer is found. A miss costs nothing.

The price is a property of the outcome, not of the work behind it. Whichever
vendor serves this call, and whatever it costs us, the number above is the number
quoted before the run and charged after it.


## Measured reliability

- **Hit rate:** 76% of runs resolve an answer.
- **Sample:** 751 runs, measured 2026-09-01.

Use these to choose between entries that both fit. Do not use them to rule
one out — a low hit rate is a fact about the world's data, not about whether the
call is worth making, and under this pricing a miss is free.


## Call it

**CLI**

```bash
orangeslice enrich company_linkedin_enrich --company-slug stripe

# company name to a full record in two hops:
echo '{"companyName":"Anthropic"}' \
  | orangeslice enrich company_linkedin \
  | orangeslice enrich company_linkedin_enrich
```

**HTTP**

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

**SDK**

```ts
await services.company.linkedin.enrich({ companyLinkedinUrl: "…", companySlug: "…", domain: "…" });
```

## Inputs

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `companyLinkedinUrl` | string | No | LinkedIn company URL |
| `companySlug` | string | No | LinkedIn company slug (e.g., 'stripe') |
| `domain` | string | No | Company website domain, e.g. 'stripe.com' |
| `extended` | boolean | No | Include growth metrics, funding, posts and more (default: false) |

Inputs may also be piped as NDJSON, one JSON object per line.

## Output

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "companySlug": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "domain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "website": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "industry": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "employeeCount": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "followerCount": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "foundedYear": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "locality": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "countryCode": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "countryName": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "companyType": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "companySize": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "ticker": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "logo": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "twitterHandle": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "companyLinkedinUrl": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "name",
    "companySlug",
    "domain",
    "website",
    "description",
    "industry",
    "employeeCount",
    "followerCount",
    "foundedYear",
    "locality",
    "region",
    "countryCode",
    "countryName",
    "companyType",
    "companySize",
    "ticker",
    "logo",
    "twitterHandle",
    "companyLinkedinUrl"
  ],
  "additionalProperties": false
}
```

The field that carries the answer is `name`. It is
`null` — or empty — when nothing was found, which is how a miss is told from a
hit without knowing anything else about this entry.

## Before you run

- **Price it first.** `orangeslice enrich company_linkedin_enrich --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