ChatGPT sources schema

This section documents the sources data returned by the ChatGPT endpoint: the pages ChatGPT used for the answer, part of the ChatGPT response so no separate API call is needed. They follow the common sources structure with additional ChatGPT-specific fields. For use cases, pricing context, and copy-paste examples, see the ChatGPT sources API page on the product site.

Pages that the answer links in its text come first. With legacy: true the order matches ChatGPT’s Sources panel. On the default mobile-web interface it follows ChatGPT’s own list of pages, which can differ from the panel. For the order in which the answer cites them, use citationPills.

ChatGPT doesn’t search or cite sources for every prompt, even though cloro forces web search by default. A successful response can have empty sources, citationPills, and searchQueries without disableWebSearch:

ChatGPT searched but cited nothing. cloro returns the answer with empty sources and citationPills.
ChatGPT did not search. cloro retries, and from the third attempt on it keeps the answer whether ChatGPT searched or not.

See Why are sources and citationPills empty when web search is forced?

Example request

{
  "prompt": "What are the best AI recruiting tools?",
  "country": "US"
}

ChatGPT-specific source fields

Field	Type	Description
`footnote`	boolean	`false` for a page that the answer links in its text: an inline link, or a page in an inline citation. `true` for a page that ChatGPT used but does not link
`datePublished`	string	The publication date of the source (e.g., “May 22, 2025”). Omitted when the source has no publish date — never emitted as `null`.

Response example

{
  "success": true,
  "result": {
    "text": "Here's what I found about AI recruiting tools...",
    "sources": [
      {
        "position": 1,
        "url": "https://www.rippling.com/blog/ai-recruiting?utm_source=chatgpt.com",
        "label": "12 Best AI Recruiting Tools For HR in 2025",
        "description": "Top AI recruiting tools that can help HR professionals streamline their hiring process...",
        "footnote": false,
        "datePublished": "May 22, 2025"
      },
      {
        "position": 2,
        "url": "https://www.index.dev/blog/ai-recruiting-software-hiring-managers?utm_source=chatgpt.com",
        "label": "7 Best AI Recruiting Software for Hiring Managers in 2025",
        "description": "A guide to AI recruiting software options available for hiring managers...",
        "footnote": false,
        "datePublished": "April 10, 2025"
      },
      {
        "position": 3,
        "url": "https://www.selectsoftwarereviews.com/buyer-guide/ai-recruiting?utm_source=chatgpt.com",
        "label": "10+ Best AI Recruiting Software for 2025: Reviews + Pricing",
        "description": "Reviews and pricing information for AI recruiting software solutions...",
        "footnote": true
      }
    ]
  }
}

Overview

ChatGPT

Google

Google AI Mode

Bing AI Mode

Gemini

Google News

Async tasks

Utilities

ChatGPT sources schema

Example request

ChatGPT-specific source fields

Response example