---
title: "Source URL prompt analytics"
method: GET
path: "/api/v1/analytics/source-urls/{source_url}/prompts"
tags: ["analytics"]
---

# Source URL prompt analytics

`GET /api/v1/analytics/source-urls/{source_url}/prompts`

## Request

- Base URL: `https://pineprompt.com`
- URL: `https://pineprompt.com/api/v1/analytics/source-urls/{source_url}/prompts`
- Auth: HTTP bearer

Returns per-prompt aggregates scoped to a single source URL: how many distinct analyzed responses on each prompt cited the URL during the window, and when the URL was most recently cited. The response is paginated. This endpoint may not be scoped by segment.

## Path parameters

- `source_url` integer, required

## Query parameters

- `start_date` string, date, required
- `end_date` string, date, required
- `platforms` string[]
- `countries` string[]
- `monitors` integer[]
- `tags` integer[]
- `page` integer
- `per_page` integer
- `sort_by` 'citation_count' | 'last_cited_on' | 'prompt' | 'monitor_name'
- `sort_order` 'asc' | 'desc'

## Headers

- `Pineprompt-Project-Id` integer, required

## Response `200`

OK

- SourceUrlPromptAnalyticsList
  - `data` SourceUrlPromptAnalytics[]
    - `prompt` Prompt: A prompt is a single question Pineprompt asks the AI platforms on your behalf. An active prompt runs with its monitor once per day; an inactive prompt keeps its history but no longer runs.
      - `id` integer: The unique ID of the prompt.
      - `monitor_id` integer: The ID of the monitor that owns this prompt.
      - `prompt` string: The question text the monitor asks each platform on every run.
      - `is_active` boolean: Whether the prompt will run on each daily run of its monitor.
      - `monitor` Monitor: A monitor is a configured daily run: a set of prompts bound to one or more AI platforms in a chosen country and language. While a monitor is active, Pineprompt runs it once per day on your behalf.
        - `id` integer: The unique ID of the monitor.
        - `project_id` integer: The ID of the project this monitor runs under.
        - `name` string: The display name of the monitor.
        - `platforms` string[]: The AI platforms the monitor runs against.
        - `country` string: The ISO 3166-1 alpha-2 country code.
        - `language` string: The language the monitor runs in.
        - `is_active` boolean: Whether the monitor will run on its next daily run.
        - `project` Project: A project represents a single brand or site you monitor. Its `brand_id` names the own brand, the brand every core metric is computed for.
          - `id` integer: The unique ID of the project.
          - `organization_id` integer: The ID of the organization that owns the project.
          - `name` string: The display name of the project.
          - `brand_id` integer, nullable: The ID of the project's own brand, or null while none has been designated.
          - `organization` Organization: An organization is the top-level billing entity and tenant boundary in Pineprompt. Every project, member, and API key belongs to exactly one organization.
            - `id` integer: The unique ID of the organization.
            - `name` string: The display name of the organization.
            - `created_at` string, date-time: When the organization was created.
            - `updated_at` string, date-time: When the organization was last updated.
          - `created_at` string, date-time: When the project was created.
          - `updated_at` string, date-time: When the project was last updated.
        - `created_at` string, date-time: When the monitor was created.
        - `updated_at` string, date-time: When the monitor was last updated.
      - `created_at` string, date-time: When the prompt was created.
      - `updated_at` string, date-time: When the prompt was last updated.
    - `citation_count` integer: The number of distinct analyzed responses on this prompt that cited the URL during the window.
    - `last_cited_on` string, date, nullable: The most recent date in the window that a response to this prompt cited the URL. `null` when the URL was never cited.
  - `links` PaginationLinks
    - `first` string, nullable
    - `last` string, nullable
    - `prev` string, nullable
    - `next` string, nullable
  - `meta` PaginationMeta
    - `current_page` integer
    - `from` integer, nullable
    - `last_page` integer
    - `path` string
    - `per_page` integer
    - `to` integer, nullable
    - `total` integer
    - `links` PaginationLink[]: The page-link rows, in display order from the first page through the last. The set always opens with a previous link and closes with a next link.
      - `url` string, nullable: The URL for this link, or `null` for the disabled previous and next boundaries.
      - `label` string: The label for this link, either a page number or a localized previous or next caption.
      - `page` integer, nullable: The page number this link points to, or `null` for the disabled previous and next boundaries.
      - `active` boolean: Whether this link is the page currently being returned.

## Other responses

- `400`: Missing project header
- `401`: Unauthorized
- `403`: Missing ability
- `404`: Not found
- `422`: Validation failed

---

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