API Reference › Gemini › Sources

Sources

Reference for the sources array that Gemini returns alongside its generated answer — the ranked list of web pages Gemini cited while composing its response.

Overview

Sources are not fetched through a dedicated call. They are embedded directly in the payload returned by the Gemini extraction endpoint, so any successful Gemini request that triggers citations will already include them under result.sources. Each entry follows cloro's shared source schema — a stable position, the destination url, a short label, and a contextual description — which keeps parsing consistent across every AI provider cloro supports.

Keep in mind that Gemini does not cite external material for every prompt. When Gemini answers from its own reasoning without referencing the web, sources is returned as an empty array. That is expected behavior rather than a failure, so treat an empty array as "no citations available" and continue processing the rest of the response normally.

Source fields

Field	Type	Description
position	integer	One-based rank of the citation in the order Gemini surfaced it.
label	string	Human-readable name of the referenced site or publication.
url	string	Absolute link to the cited web page.
description	string	Short snippet describing why the page was referenced or what it contains.

Example request

{
  "prompt": "Explain quantum entanglement",
  "country": "US"
}

Response example

{
  "success": true,
  "result": {
    "text": "Quantum entanglement is a physical phenomenon in which two particles remain correlated...",
    "sources": [
      {
        "position": 1,
        "label": "Wikipedia",
        "url": "https://en.wikipedia.org/wiki/Quantum_entanglement",
        "description": "Overview of entanglement, its history, and its role in quantum information theory."
      },
      {
        "position": 2,
        "label": "Physics World",
        "url": "https://physicsworld.com/a/quantum-entanglement-explained",
        "description": "Plain-language explainer covering how entangled states are created and measured."
      }
    ]
  }
}

Notes

Because the sources shape is identical across cloro's providers, code written to read Gemini citations can be reused for the other AI endpoints without changes. If you consistently receive an empty array where you expect citations, verify that the prompt is one likely to prompt Gemini to browse, and reach out to [email protected] if the behavior looks wrong.