---
title: "Local Decision Survival — whether a local business survives as Google's AI recommendation across a simulated near-me buyer journey (a broad \"best {category} in {locality}\" search that narrows over follow-ups into a forced pick). Per journey: the verbatim AI reply excerpt at each step, whether the business is named, competitor mentions, cited sources, and — when it drops out — which follow-up dropped it and who took the slot. Plus the survival rate (95% Wilson interval), the stage-survival curve, offramp concentration, and top displacers. Deterministic zero-LLM extraction; below the minimum-evidence floor the rate reads \"Measuring\"."
method: GET
path: "/entities/{entityId}/local-survival"
tags: ["Layer 1 — Profile"]
---

# Local Decision Survival — whether a local business survives as Google's AI recommendation across a simulated near-me buyer journey (a broad "best {category} in {locality}" search that narrows over follow-ups into a forced pick). Per journey: the verbatim AI reply excerpt at each step, whether the business is named, competitor mentions, cited sources, and — when it drops out — which follow-up dropped it and who took the slot. Plus the survival rate (95% Wilson interval), the stage-survival curve, offramp concentration, and top displacers. Deterministic zero-LLM extraction; below the minimum-evidence floor the rate reads "Measuring".

`GET /entities/{entityId}/local-survival`

## Request

- Base URL: `https://entidex.com/api/v1`
- URL: `https://entidex.com/api/v1/entities/{entityId}/local-survival`
- Auth: HTTP bearer

## Path parameters

- `entityId` string, required

## Response `200`

Local Decision Survival, or { available: false } for non-local / unmeasured entities.

- union
  - LocalSurvival: Whether a local business survives as Google's AI recommendation across a simulated near-me buyer journey (broad search → narrowing follow-ups → forced pick), with per-step AI replies, competitor mentions, and cited sources. Deterministic zero-LLM read.
    - `entityId` string, required: Canonical entx_xxxx id.
    - `available` true, required
    - `business` string, required
    - `locality` string, required
    - `category` string, required
    - `categoryLabel` string, required
    - `survivalRatePct` number, nullable, required: Share of journeys the business survived to Google's AI forced pick. Null = Measuring.
    - `wilsonLowPct` number, nullable, required
    - `wilsonHighPct` number, nullable, required
    - `sampleJourneys` integer, required
    - `measuring` boolean, required: True below the minimum-evidence floor — render "Measuring", never the numeric.
    - `stageSurvival` LocalSurvivalStagePoint[], required
      - `turn` string, required
      - `role` string, required
      - `presentPct` number, nullable, required
      - `sample` integer, required
    - `offrampConcentration` LocalSurvivalOfframp[], required
      - `label` string, required: Plain-English constraint label (which follow-up dropped the focal).
      - `count` integer, required
      - `sharePct` number, required
    - `topDisplacers` LocalSurvivalDisplacer[], required
      - `name` string, required
      - `href` string, nullable, required
      - `count` integer, required
    - `journeys` LocalSurvivalJourney[], required
      - `path` 'urgency' | 'quality', required
      - `outcome` 'survived' | 'eliminated' | 'never_surfaced' | 'measuring', required
      - `survived` boolean, required
      - `firstDropTurn` string, nullable, required
      - `offrampConstraint` string, nullable, required: The plain-English constraint that dropped the focal.
      - `neverSurfaced` boolean, required
      - `displacer` string, nullable, required: The business that took the slot the focal lost.
      - `turns` LocalSurvivalTurn[], required
        - `turn` string, required
        - `role` 'open' | 'constrain' | 'constrain_2' | 'force_pick', required
        - `query` string, required: The simulated buyer’s search at this step (a plain query, never an instruction).
        - `answered` boolean, required
        - `named` boolean, required: The focal business is named in Google's AI answer at this step.
        - `rank` integer, nullable, required
        - `totalNamed` integer, required
        - `replyExcerpt` string, required: Verbatim excerpt of Google's AI answer for this step — the evidence.
        - `droppedHere` boolean, required: true when this is the step where the focal dropped out.
        - `citations` LocalSurvivalCitation[], required
          - `source` string, nullable, required
          - `domain` string, nullable, required
          - `url` string, nullable, required
          - `title` string, nullable, required
        - `competitors` LocalSurvivalCompetitor[], required
          - `name` string, required
          - `rank` integer, required
          - `leader` boolean, required: true when this business held slot 1 (the one Google's AI led with).
          - `href` string, nullable, required: Entity page href when tracked, else null.
    - `collectedAt` string, date-time, required
    - `computationVersion` string, required
    - `methodology` string, required
    - `provenance` object, required
      - `issuer` string, required
      - `methodologyUrl` string, uri, required
      - `note` string, required
  - LocalSurvivalUnavailable
    - `entityId` string, required
    - `available` false, required
    - `reason` 'disabled' | 'entity_out_of_scope' | 'no_signal_yet', required

## Other responses

- `404`: Entity or resource not found.

---

[API](https://skmtc.dev/entidex/apis/entidex-api.md) · [All operations](https://skmtc.dev/entidex/apis/entidex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/entidex/apis/entidex-api/revisions/86b92f21a09a?raw)