---
title: "Get AI journey statistics"
method: GET
path: "/v1/projects/{projectId}/geo/traffic/journey-stats"
tags: ["GEO"]
---

# Get AI journey statistics

`GET /v1/projects/{projectId}/geo/traffic/journey-stats`

## Request

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

Exact journey counts per AI source and per page against the previous window: single fetches, deep crawls, entry pages and daily counts.

## Path parameters

- `projectId` string, required

## Query parameters

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

## Response `200`

Journey statistics fetched successfully

- GeoJourneyStatsResponse
  - `configured` boolean, required: False when the analytics backend is not configured for this deployment; the payload is then empty rather than an error.
  - `sources` object[], required
    - `source` string, required
    - `visitorType` 'crawler' | 'ai_referral' | 'human' | 'unknown', required
    - `journeys` integer, required
    - `previousJourneys` integer, required
    - `pages` integer, required
    - `singleFetch` integer, required
    - `deepCrawls` integer, required
    - `lastSeenAt` string, nullable, required
    - `daily` object[], required
      - `day` string, required
      - `journeys` integer, required
  - `pages` object[], required
    - `path` string, required
    - `journeys` integer, required
    - `previousJourneys` integer, required
    - `entries` integer, required: Journeys whose first fetch was this page.
    - `lastSeenAt` string, nullable, required
    - `daily` object[], required
      - `day` string, required
      - `journeys` integer, required
  - `totalPages` integer, required
  - `previousTotalPages` integer, required
  - `organization` object, required
    - `id` string, required
    - `slug` string, required
    - `name` string, required
    - `logo` string, nullable, required

## Other responses

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

## Changes

- **2026-11-08** `41d74f2b285c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usenotra/apis/notra-api/changes/v1/projects/:projectId/geo/traffic/journey-stats/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/f07268f0bc6a?raw)