# UK Business Score

A UK company or domain → an outside-in score, graded and explained.

The same engine behind our free Business Score, as an API. Enriches the business, then grades it 0–100 across categories with a prioritised, plain-English action plan — every result carries an accuracy score.

Every business has an online presence; almost nobody can say, objectively, how good it is. This endpoint grades it: findability, website health, message clarity and conversion readiness, each scored from observable signals, rolled into a headline number with the findings that produced it. Because it needs no cooperation from the business being scored, it works on prospects as well as customers — which is what makes it a prioritisation engine, not just a report card.

- Price: 10 credits (20 on the free plan)
- Page: https://meetkatalis.com/apis/business-score
- OpenAPI: https://meetkatalis.com/openapi.yaml

## Endpoints

- `GET /api/v1/score?q=greggs` — Profile + outside-in score + action plan

## Call it

```bash
curl -H "x-api-key: $KATALIS_API_KEY" \
  "https://meetkatalis.com/api/v1/score?q=greggs.com"
```

```javascript
const res = await fetch("https://meetkatalis.com/api/v1/score?q=greggs.com", {
  headers: { "x-api-key": process.env.KATALIS_API_KEY },
});
if (!res.ok) throw new Error(`Katalis ${res.status}: ${await res.text()}`);
console.log(await res.json());
```

```python
import os, requests

r = requests.get(
    "https://meetkatalis.com/api/v1/score?q=greggs.com",
    headers={"x-api-key": os.environ["KATALIS_API_KEY"]},
    timeout=60,
)
r.raise_for_status()
print(r.json())
```

## Example response (a real reply)

```json
{
  "score": {
    "score": 78,
    "band": "strong",
    "categories": [
      { "key": "findability", "title": "Can customers find you?", "score": 71, "findings": [ … ] },
      { "key": "clarity",     "title": "Does your site say what you do?", "score": 88, "findings": [ … ] },
      { "key": "health",      "title": "Does your site work properly?", "score": 82, "findings": [ … ] }
    ],
    "areas": [
      { "key": "marketing", "title": "Marketing", "question": "Does your marketing win customers?", "score": 76, "categories": [ … ] },
      { "key": "site", "title": "Site", "question": "Does your site work properly?", "score": 82, "categories": [ … ] }
    ],
    "actionPlan": [
      { "category": "findability", "issue": "We couldn't find a search description (meta description)",
        "advice": "Write one 150-char description per page.", "severity": "warn" }
    ],
    "attribution": "Contains public sector information licensed under the OGL v3.0."
  },
  "profile": {
    "name": "Greggs plc",
    "whatTheyDo": "UK food-on-the-go bakery chain.",
    "accuracy": { "score": 92, "confidence": "high" },
    "attribution": "Contains public sector information licensed under the OGL v3.0."
  }
}
```

## What you'd build with it

- **Lead-list triage.** Score 200 prospects overnight; your team calls the 40 that most need help — with the specific findings as the opener.
- **Onboarding segmentation.** Route weak-presence signups to high-touch support and strong ones to self-serve, automatically, from day one.
- **Quality badges.** Directories and platforms show a grounded, explainable score next to every business — content nobody else can generate.

## Why this one

- **A score that shows its work.** Not a black-box number. Every result breaks down by category and lists the specific findings behind it, so you can act on it.
- **Outside-in, no access needed.** Grades any UK business from public signals alone — their site, Companies House, presence. No tags, logins or cooperation required.
- **Built on verified facts.** Runs on top of our Company Enrichment, so the score is anchored to a real Companies House match with an honest accuracy score.
- **Perfect for lead lists.** Score a whole prospect list to spot who most needs help — sales teams, agencies and directories use it to prioritise outreach.

## Conventions

- Auth: `x-api-key: kat_live_…` on every request (free key at https://meetkatalis.com/developers: a verified email and mobile, 100 credits a month, no card).
- One credit balance across every API; each endpoint's price is on its page and in `x-credits` in https://meetkatalis.com/openapi.yaml.
- Keys are camelCase everywhere. A registered company is `company: { name, number, status, statusDetail?, filingsOverdue? }` on the register endpoints; the enrichment family (enrich, score, assess, brand-kit, ai-visibility, tender-match) keeps `business` / `profile` with `companyNumber`.
- Every error has `code` and `requestId`; every reply an `x-request-id` header; a charged reply `x-credits-remaining`; a reply that gave credits back `x-credits-refunded`. Missing = 404 with `query`.
- Burst ceiling 60 requests a minute per key (429, `Retry-After`, no credits used). A failure on our side (5xx) gives the call's credits back.
- Company data contains public sector information licensed under the Open Government Licence v3.0.

Provided "as is"; results come from public sources and, in places, AI, and may be inaccurate or out of date; not legal, professional or credit advice. Terms: https://meetkatalis.com/apis/terms