---
title: "Get a post's agent reach"
method: GET
path: "/v1/posts/{postId}/agent-reach"
tags: ["Content"]
---

# Get a post's agent reach

`GET /v1/posts/{postId}/agent-reach`

## Request

- Base URL: `https://api.usenotra.com`
- URL: `https://api.usenotra.com/v1/posts/{postId}/agent-reach`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/usenotra/apis/notra-api/docs/v1/posts/:postId/agent-reach/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns AI crawler, citation and referral visits to the post's live page on its Notra Site, including its Markdown copy. Defaults to the last 30 days. agentReach is null when the post isn't live on a Site.

## Path parameters

- `postId` string, required

## Query parameters

- `days` integer: Rolling window size in days. Ignored when from/to are set.
- `from` string
- `to` string

## Response `200`

Agent reach fetched successfully

- PostAgentReachResponse
  - `organization` object, required
    - `id` string, required
    - `slug` string, required
    - `name` string, required
    - `logo` string, nullable, required
  - `agentReach` PostAgentReach, nullable, required: Null when the post isn't live on a Notra Site: never published to one, published to another branch, or the Site has no production deployment.
    - `postId` string, required
    - `siteId` string, required
    - `path` string, required: Path the post is served at on its Site. Visits to its Markdown copy (`<path>.md`) and index files are counted too.
    - `url` string, required
    - `configured` boolean, required: False when the traffic backend is not configured for this deployment; the payload is then empty rather than an error.
    - `totals` object, required
      - `crawled` integer, required: Training and search-index crawler visits.
      - `cited` integer, required: Visits from assistants reading the page while answering someone.
      - `referred` integer, required: People who clicked through from an AI answer.
      - `total` integer, required
    - `sources` object[], required
      - `source` string, required
      - `visitorType` 'crawler' | 'ai_referral' | 'human' | 'unknown', required
      - `agent` string, required
      - `category` string, required
      - `confidence` string, required
      - `visits` integer, required
      - `previousVisits` integer
      - `markdownVisits` integer, required
      - `previousMarkdownVisits` integer
      - `paths` integer, required
      - `previousPaths` integer
      - `lastSeenAt` string, required
    - `points` object[], required
      - `day` string, required
      - `visitorType` 'crawler' | 'ai_referral' | 'human' | 'unknown', required
      - `source` string, required
      - `visits` integer, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `402`: GEO plan or available AI credits required
- `403`: Forbidden
- `404`: Organization or post not found
- `409`: Conflict
- `500`: Internal server error
- `503`: Authentication or billing service unavailable

## Changes

- **2026-11-06** `6bd929e8a14b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usenotra/apis/notra-api/changes/v1/posts/:postId/agent-reach/get.md)

---

[API](https://skmtc.dev/usenotra/apis/notra-api.md) - [All operations](https://skmtc.dev/usenotra/apis/notra-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usenotra/apis/notra-api/revisions/a81c93229b54?raw)