---
title: "Score Google Knowledge Panel readiness"
method: POST
path: "/api/agent/v1/check/knowledge-panel-readiness"
---

# Score Google Knowledge Panel readiness

`POST /api/agent/v1/check/knowledge-panel-readiness`

## Request

- Base URL: `https://essentras.com`
- URL: `https://essentras.com/api/agent/v1/check/knowledge-panel-readiness`
- Auth: none declared

Free and read-only. Scores how ready a person or business is for a Google Knowledge Panel, the same score as the free Entity Readiness Check on essentras.com. Ask the person 11 multiple-choice questions about their sources and what Google shows today (never their name or links): the subject, the panel state, and coverage, quality, wikipedia, wikidata, home, profiles, records, demand, unique. With every answer it returns the score out of 100, the band, each gap with points to gain and the next action, the right next step (claim, edit or fix an existing panel for free, build sources, or the Essentras service with its current price for a strong candidate), and Google sources with read dates. With answers missing it returns the questions still to ask. The score is an Essentras rule of thumb, not a Google metric. Google decides whether to show a panel, and paid placements are paid editorial, not independent coverage. The same checker as the MCP tool check_knowledge_panel_readiness.

## Request body

- object
  - `subject` 'person' | 'business': Who is the panel for? person = A person (Founder, executive, author, creator, artist or expert); business = A business or organization (Company, brand, nonprofit or product).
  - `state` 'none' | 'unclaimed' | 'claimed' | 'wrong': What does Google show today when you search your exact name? none = No panel for me; unclaimed = A panel about me that I have not claimed; claimed = A panel I already manage; wrong = A panel with wrong facts, or mixed up with someone else.
  - `coverage` 'c0' | 'c1' | 'c3' | 'c6': How many independent articles are mainly about you, on sites you do not control? Count articles where you are the main subject. Leave out your own site, your profiles, press releases and anything you paid for. c0 = None yet; c1 = 1 to 2; c3 = 3 to 5; c6 = 6 or more.
  - `quality` 'q0' | 'q1' | 'q2' | 'q3': What is the strongest coverage you have? q0 = Nothing yet; q1 = Press releases, sponsored or paid articles, or my own posts; q2 = Trade, local or niche outlets with editorial staff; q3 = National or international outlets with editorial staff.
  - `wikipedia` 'w1' | 'w0': Is there a Wikipedia article about you? w1 = Yes; w0 = No.
  - `wikidata` 'd2' | 'd1' | 'd0': Is there a Wikidata item about you? d2 = Yes, with references to independent sources; d1 = Yes, but with few or no references; d0 = No, or I do not know.
  - `home` 'h2' | 'h1' | 'h0': Do you have an official page that is only about you, with Person or Organization structured data? h2 = Yes, with structured data and sameAs links to my profiles; h1 = A page exists, but without structured data; h0 = No dedicated page.
  - `profiles` 'p2' | 'p1' | 'p0': Do your main profiles use the same name, title and description, and link to that page? LinkedIn, X, Instagram, YouTube, Facebook, Crunchbase, author or artist profiles. p2 = Yes, all of them; p1 = Some of them; p0 = No, they differ.
  - `records` 'r2' | 'r1' | 'r0': Are you listed in the reference databases of your field? Business: company registry, Crunchbase. Author: ISBN or library records. Musician: MusicBrainz, Discogs. Film: IMDb. Researcher: ORCID, Google Scholar. r2 = Yes, in 2 or more; r1 = Yes, in 1; r0 = Not yet.
  - `demand` 's2' | 's1' | 's0': Do people search for your name? Check Search Console for queries that contain your name, or see whether Google suggests your name as you type it. s2 = Yes, regularly; s1 = A little; s0 = No, or I do not know.
  - `unique` 'u2' | 'u1' | 'u0': When you search your exact name, whose results dominate? u2 = Mostly mine; u1 = Mixed with other people or things; u0 = Mostly someone or something else.
  - `client` string: Optional: the agent’s name, used only to attribute an order to it.

## Response `200`

The checker result

- object: Fields every checker returns. Each checker adds its own (verdict, score, rules, plan); its description lists them.
  - `object` 'checker_result'
  - `checker` string: The MCP tool name.
  - `checked` string, date: The day the official pages behind the rules were read.
  - `status` 'complete' | 'needs_answers'
  - `summary` string
  - `needs` object[]: With status needs_answers: the questions still to ask, with their allowed answers.
    - `field` string
    - `question` string
    - `options` object[]
      - `id` string
      - `label` string
  - `do_it_yourself` object: What the person can do themselves, for free, through the official channels.
  - `service` object, nullable: The matching Essentras service, priced from the same constants as the website. Null where the website offers no paid service for this result.
    - `name` string
    - `url` string, uri
    - `start_url` string, uri, nullable: Where the buyer reviews the service and pays. This API takes no payment.
    - `price` object
      - `currency` 'USD'
      - `amount` number, nullable: The amount charged, or the starting amount for a ladder. Null when priced per case.
      - `label` string
      - `basis` 'flat' | 'from' | 'per_case'
      - `tiers` object[]
    - `terms` string, nullable
    - `note` string, nullable
    - `offered_as` 'main_next_step' | 'alternative_to_diy'
  - `free_tool` object
    - `name` string
    - `url` string, uri
  - `sources` object[]: Official pages behind the answer, with the day each was read.
  - `warnings` string[]: Input fields that were ignored or renamed.
  - `privacy` string

## Other responses

- `400`: Input the checker could not read; details lists each problem and the allowed values
- `429`: Rate limited

---

[API](https://skmtc.dev/essentras/apis/essentras-agent-api.md) · [All operations](https://skmtc.dev/essentras/apis/essentras-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/essentras/apis/essentras-agent-api/revisions/17a4d739e1b1?raw)