analytics

Source-URL usage time-series

For each top URL, returns the percentage of analyzed responses in each bucket that cited that exact URL. The result is capped to the top top_n URLs. Source-keyed analytics cannot be scoped by segment.

get/api/v1/analytics/source-url-usage-time-series

Request

  • Base URL: https://pineprompt.com
  • URL: https://pineprompt.com/api/v1/analytics/source-url-usage-time-series
  • Auth: HTTP bearer

Query parameters

start_datestring date required
Example:2026-04-01

The inclusive UTC start of the analytics window, given as an ISO 8601 date (YYYY-MM-DD).

end_datestring date required
Example:2026-05-20

The inclusive UTC end of the analytics window. The value must be on or after start_date, and on or before today.

interval'day' | 'week' | 'month' | 'year' required
Example:day

The bucketing granularity for time-series endpoints. Accepted values: day, week, month, and year. Week buckets begin on Monday.

platformsstring[]

You may use this parameter to limit responses to one or more AI platforms. Repeat the parameter for each value, for example ?platforms[]=chatgpt&platforms[]=claude. When omitted, every platform is included. Accepted values: chatgpt, perplexity, gemini, grok, copilot, claude, google_ai_mode, and google_ai_overview.

countriesstring[]

You may use this parameter to limit responses to monitors run in the given ISO-3166-1 alpha-2 country codes.

[
  "US",
  "NL"
]
monitorsinteger[]

You may use this parameter to limit responses to specific monitors inside the active project.

[
  271,
  272
]
tagsinteger[]

You may use this parameter to limit responses to those whose prompt carries any of the given tag IDs, such as branded or non-branded.

[
  3,
  5
]
top_ninteger
Example:20

The maximum number of series to return from a time-series endpoint. Series are ranked by total mentions or citations in the window. Defaults to 20, with a maximum of 50.

Headers

Pineprompt-Project-Idinteger required

The active project's numeric ID.

Response

OK

interval'day' | 'week' | 'month' | 'year'

The bucket granularity used to compute the series.

Example response

{
  "interval": "day",
  "series": [
    {
      "source_url": {
        "id": 9912,
        "source_id": 4421,
        "url": "https://example.com/article",
        "title": "Comparison of AI visibility tools",
        "source": {
          "id": 4096,
          "project_id": 42,
          "domain": "example.com",
          "type": "blog",
          "playbook": "pitch",
          "analyzed_at": "2026-05-15T09:11:42+00:00",
          "project": {
            "id": 42,
            "organization_id": 7,
            "name": "Acme Marketing",
            "brand_id": 555,
            "organization": {
              "id": 7,
              "name": "Acme Inc.",
              "created_at": "2026-05-15T09:11:42+00:00",
              "updated_at": "2026-05-15T09:11:42+00:00"
            },
            "created_at": "2026-05-15T09:11:42+00:00",
            "updated_at": "2026-05-15T09:11:42+00:00"
          },
          "created_at": "2026-05-15T09:11:42+00:00",
          "updated_at": "2026-05-15T09:11:42+00:00"
        },
        "created_at": "2026-05-15T09:11:42+00:00",
        "updated_at": "2026-05-15T09:11:42+00:00"
      },
      "data": [
        {
          "timestamp": "2026-04-01T00:00:00+00:00",
          "value": 73
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.