citations

List citations

Returns every citation collected across the active project. The response is paginated, with the newest citations returned first by default.

get/api/v1/citations

Request

  • Base URL: https://pineprompt.com
  • URL: https://pineprompt.com/api/v1/citations
  • Auth: HTTP bearer

Query parameters

pageinteger
Example:1

The page number to return. Defaults to 1.

per_pageinteger
Example:25

The number of items per page. Defaults to 25, maximum 100.

response_idinteger
Example:7842

Limit results to citations belonging to a single response.

sort_by'created_at' | 'updated_at' | 'position'

The column to sort by. Defaults to created_at.

sort_order'asc' | 'desc'

The direction to sort by. Each endpoint has its own default.

includestring
Example:source_url

A comma-separated list of related resources to include in the response. Allowed values: response, response.prompt, response.monitor, response.project, source_url, source_url.source, source_url.source.project.

Headers

Pineprompt-Project-Idinteger required

The active project's numeric ID.

Response

OK

Example response

{
  "data": [
    {
      "id": 55821,
      "response_id": 7842,
      "source_url_id": 3104,
      "url": "https://example.com/blog/comparison",
      "title": "Comparison of AI visibility tools",
      "domain": "example.com",
      "position": 1,
      "response": {
        "id": 7842,
        "prompt_id": 901,
        "monitor_id": 271,
        "prompt_text": "What are the best AI visibility monitoring tools?",
        "platform": "chatgpt",
        "model": "gpt-4",
        "country": "US",
        "language": "en",
        "prompt": {
          "id": 901,
          "monitor_id": 271,
          "prompt": "What are the best AI visibility monitoring tools?",
          "is_active": true,
          "monitor": {
            "id": 271,
            "project_id": 42,
            "name": "Brand visibility (US)",
            "platforms": [
              "chatgpt",
              "perplexity",
              "claude"
            ],
            "country": "US",
            "language": "en",
            "is_active": true,
            "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"
        },
        "monitor": {
          "id": 271,
          "project_id": 42,
          "name": "Brand visibility (US)",
          "platforms": [
            "chatgpt",
            "perplexity",
            "claude"
          ],
          "country": "US",
          "language": "en",
          "is_active": true,
          "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"
        },
        "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"
      },
      "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"
      },
      "created_at": "2026-05-15T09:11:42+00:00",
      "updated_at": "2026-05-15T09:11:42+00:00"
    }
  ],
  "links": {
    "first": "https://pineprompt.com/api/v1/monitors?page=1",
    "last": "https://pineprompt.com/api/v1/monitors?page=1"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "https://pineprompt.com/api/v1/monitors",
    "per_page": 25,
    "to": 1,
    "total": 1,
    "links": [
      {
        "url": "https://pineprompt.com/api/v1/monitors?page=2",
        "label": "2",
        "page": 2
      }
    ]
  }
}

Changes

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