Sources
The citations ChatGPT surfaces alongside a web-grounded answer, normalized into a predictable array with publication dates and footnote flags.
Overview
Sources are the reference links ChatGPT exposes in its sources panel when a prompt triggers web search. cloro reads that panel and returns each citation as an entry in the sources array on the ChatGPT result. Because the citations travel with the answer itself, you do not issue a separate request — run the ChatGPT extraction and read result.sources from the same response.
Each entry follows cloro's shared source shape (position, url, label, description) and adds two fields that are specific to how ChatGPT presents its citations.
ChatGPT-specific fields
| Field | Type | Description |
|---|---|---|
| footnote | boolean | Marks a citation that ChatGPT lists as a trailing footnote rather than an inline reference within the sources panel. |
| datePublished | string | Human-readable publish date of the referenced page, such as "May 22, 2025". The key is left out entirely when ChatGPT reports no date; it is never returned as null. |
Common source fields
| Field | Type | Description |
|---|---|---|
| position | integer | One-based ordering of the citation as it appears in the sources panel. |
| url | string | Destination link for the cited page, including any tracking parameters ChatGPT appends. |
| label | string | Title text shown for the citation. |
| description | string | Short summary or snippet describing the referenced page. |
Example request
{
"prompt": "What are the best AI recruiting tools?",
"model": "CHATGPT",
"country": "US"
}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 help HR teams streamline hiring...",
"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 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 for AI recruiting software solutions...",
"footnote": true
}
]
}
}Notes
Not every prompt yields citations. When ChatGPT runs a web search but attaches no references, sources comes back as an empty array rather than being omitted, so you can safely iterate over it without a null check. Questions about the field shape can go to [email protected].