ChatGPT citation pills schema

ChatGPT cites sources inline as it answers. The ChatGPT endpoint exposes those citations denormalized in result.citationPills — no separate API call. For use cases, pricing context, and copy-paste examples, see the ChatGPT sources API page on the product site. Each entry is one (pill, source) pair. When a chip cites N sources, the array contains N entries sharing the same citationPillId but carrying different per-source label, url, and domain. Group by citationPillId to recover the pill-level structure. The markdown field carries the same citations as inline [label](url) links; text carries plain text without them. The citationPills field is omitted from result when the answer has no pills.

Example request

{
  "prompt": "What is the best AI software?",
  "model": "CHATGPT",
  "country": "US"
}

Citation pill structure

Field	Type	Description
`label`	string	Per-source title of the citation. Always present; may be an empty string when the citation event ships no title — read `domain` / `url` for source identity in that case.
`citationPillId`	integer	0-based identifier shared by all entries from the same chip. Note: unlike the other providers (Google AIO, AI Mode, Copilot, Perplexity, Gemini) which use 1-based `citationPillId`, ChatGPT’s IDs start at 0 for historical reasons.
`url`	string	The URL of the citation source
`domain`	string	Domain of the citation source (e.g., `"example.com"`)
`description`	string, optional	Description of the citation content. The key is omitted when ChatGPT provides no snippet — see `type`.
`position`	integer	1-based position of this source in the sibling `result.sources` array.
`type`	string	ChatGPT-only. Discriminator: `"searchResult"` or `"groupedWebpage"`. See below for what this signals about `description`.
`datePublished`	string, optional	ChatGPT-only. ISO 8601 date string of when the source was published. Omitted when the citation event ships no publish date — never emitted as `null`.

`type` values

type reflects the structure of the underlying citation event in ChatGPT’s response:

"searchResult" — a regular web search hit. ChatGPT provides a snippet, so description is populated.
"groupedWebpage" — a citation rendered in the ChatGPT UI as a multi-source card (commonly used for community references like Reddit, Wikipedia, and ArXiv). ChatGPT does not provide a per-source snippet for these, so the description key is omitted entirely from the pill object.

When the same source URL appears as both a search result and inside a grouped card, the search-result form (with description) is preferred.

Response example

{
  "success": true,
  "result": {
    "text": "**ChatGPT** — Most versatile for writing, reasoning, and general problem-solving.\n**Claude** — Strong focus on safety and ethical reasoning.",
    "markdown": "**ChatGPT** — Most versatile for writing, reasoning, and general problem-solving. [Top 10 Best AI Apps in 2025](https://www.top10.com/best-lists/best-ai-apps)\n**Claude** — Strong focus on safety and ethical reasoning. [Best AI Platforms Compared](https://www.godofprompt.ai/blog/best-ai)",
    "citationPills": [
      {
        "label": "Top 10 Best AI Apps in 2025",
        "citationPillId": 0,
        "url": "https://www.top10.com/best-lists/best-ai-apps",
        "domain": "top10.com",
        "description": "A guide to AI applications available today",
        "position": 1,
        "type": "searchResult",
        "datePublished": "2025-01-15"
      },
      {
        "label": "Artificial intelligence — Wikipedia",
        "citationPillId": 1,
        "url": "https://en.wikipedia.org/wiki/Artificial_intelligence",
        "domain": "en.wikipedia.org",
        "position": 2,
        "type": "groupedWebpage"
      }
    ]
  }
}

Overview

ChatGPT

Google

Perplexity

Copilot

AI Mode

Grok

Gemini

Google News

Utilities

ChatGPT citation pills schema

Example request

Citation pill structure

`type` values

Response example

​Example request

​Citation pill structure

​type values

​Response example

Example request

Citation pill structure

`type` values

Response example