cloro

Perplexity Citations API

Perplexity is the most citation-forward AI engine — every claim links out. cloro returns its numbered source rail, inline citation pills, related queries, and the internal sub-queries it ran (with engine metadata) as structured JSON. Measure your citation share on the engine where citations are the product.

4.8 · 45 reviewsG2.com software review platform logo
Used daily by these awesome companies
1,000,000,000 monthly API calls

Every citation field, documented

Aggregate sources by domain for citation share; search_model_queries shows what you must rank for.

FieldTypeDescription
sources[].positionnumberPosition index of the source in the rail (the number users see).
sources[].url / label / descriptionstringCited URL, display label, and source description.
citationPills[].citationPillIdinteger1-based identifier shared by all entries from the same inline chip — group by it to reconstruct pills.
citationPills[].positioninteger1-based pointer to the matching entry in result.sources.
citationPills[].domainstringHost extracted from the URL, for grouping and display.
related_queriesstring[]Follow-up query suggestions Perplexity surfaces under the answer.
search_model_queriesobject[]Internal sub-queries Perplexity ran, with engine and limit metadata — its query fan-out.

The source rail, structured

Sources, citation pills, related queries, and search_model_queries are all included in the base request, with no add-on flags.

Request example

python
from cloro import Cloro

client = Cloro(api_key="sk_live_your_api_key_here")

response = client.monitor.perplexity(
    prompt="best email marketing platform for ecommerce",
    country="US",
)

print(response["result"]["text"])

Response example

200 OKapplication/json
{
  "success": true,
  "result": {
    "text": "For ecommerce, the platforms most often recommended are...",
    "sources": [
      {
        "position": 1,
        "url": "https://example.com/email-marketing-review",
        "label": "Email Marketing Platforms Compared",
        "description": "12 platforms tested on deliverability and automation"
      }
    ],
    "citationPills": [
      {
        "label": "Email Marketing Platforms Compared",
        "citationPillId": 1,
        "url": "https://example.com/email-marketing-review",
        "domain": "example.com",
        "position": 1
      }
    ],
    "related_queries": [
      "klaviyo vs mailchimp for shopify",
      "email marketing pricing comparison"
    ],
    "search_model_queries": [
      {
        "query": "best email marketing platform ecommerce 2026",
        "engine": "search"
      }
    ]
  }
}

Pricing that scales with you

Start free. Price per credit drops as your volume grows — see every tier below.

Free
$0/mo
500 credits / month
  • Added monthly
  • 1 concurrent job
  • 1 seat
  • Documentation assistant
Lite
$30/mo
37,500 credits
  • $0.80 per 1k credits
  • 10 concurrent jobs
  • Unlimited seats
  • Email support
Hobby
$100/mo
250,000 credits
  • $0.40 per 1k credits
  • 20 concurrent jobs
  • Unlimited seats
  • Email support
Most Popular
Starter
$250/mo
650,000 credits
  • $0.39 per 1k credits
  • 50 concurrent jobs
  • Unlimited seats
  • Email support
Scale
$500+/mo
More credits
  • Volume discounts
  • More concurrency
  • Unlimited seats
  • Faster support
Compare all 11 tiers
PlanPrice / moCreditsPer 1kConcurrencySeatsSupport
Free$050011Documentation assistant
Lite$3037,500$0.8010UnlimitedEmail
Hobby$100250,000$0.4020UnlimitedEmail
StarterPopular$250650,000$0.3950UnlimitedEmail
Growth$5001,350,000$0.3775UnlimitedPriority email
Business$1,0002,800,000$0.36100UnlimitedPriority email
Enterprise 2K$2,0005,871,025$0.34135UnlimitedSlack
Enterprise 3K$3,0009,306,606$0.32175UnlimitedSlack
Enterprise 4K$4,00012,756,261$0.31215UnlimitedSlack
Enterprise 5K$5,00016,391,783$0.31255UnlimitedSlack
Enterprise$5,000+Increased concurrency, overages on credits and credit discounts for annual contracts.Know more

Perplexity citation tracking, answered

Why is Perplexity citation data especially valuable?

Perplexity's whole UX is built on citations — users click through to sources at far higher rates than on other AI engines. A position-1 citation on a commercial prompt is real referral traffic, not just brand exposure, so citation share here converts most directly.

What do search_model_queries tell me?

The sub-queries Perplexity decomposed your prompt into before retrieval — its query fan-out, with the engine each ran against. Rank for those intermediate queries and you enter the retrieval set for the prompt itself.

How do citationPills differ from sources?

sources is the rail — the numbered list of consulted pages. citationPills are the inline chips inside the answer text; each carries a citationPillId (grouping entries from one chip) and a position pointing back into sources. Pills show which sources actually back specific claims.

What does a Perplexity request cost?

Base requests are 3 credits with sources, citation pills, related queries, fan-out, and markdown all included. US `state` targeting adds +2. See pricing for the full table.

Why not use Perplexity's own API?

The Sonar API is a developer product with its own retrieval behavior — its answers and citation sets diverge from the consumer product your buyers use. cloro samples the real perplexity.ai surface, including UI-only elements like shopping cards, videos, and places.

How do I track citation share over time?

Run your prompt set on a schedule per country, then aggregate cited domains by position. Our AI visibility tracking guide covers the methodology — the same pipeline works across ChatGPT, Gemini, and Copilot.

Win the source rail

Structured Perplexity citations from 3 credits per request.