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 · 33 reviews G2.com software review platform logo
Used by the top SEO and AI SEO companies
1,000,000,000 monthly API calls

The source rail, structured

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

Request example

python
import requests

response = requests.post(
  "https://api.cloro.dev/v1/monitor/perplexity",
  headers={
    "Authorization": "Bearer sk_live_your_api_key_here",
    "Content-Type": "application/json"
  },
  json={
    "prompt": "best email marketing platform for ecommerce",
    "country": "US"
  }
)

print(response.json())

Response example

200 OK application/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"
      }
    ]
  }
}

Every citation field, documented

Field Type Description
sources[].position number Position index of the source in the rail (the number users see).
sources[].url / label / description string Cited URL, display label, and source description.
citationPills[].citationPillId integer 1-based identifier shared by all entries from the same inline chip — group by it to reconstruct pills.
citationPills[].position integer 1-based pointer to the matching entry in result.sources.
citationPills[].domain string Host extracted from the URL, for grouping and display.
related_queries string[] Follow-up query suggestions Perplexity surfaces under the answer.
search_model_queries object[] Internal sub-queries Perplexity ran, with engine and limit metadata — its query fan-out.

Pricing that scales with you

Pick a plan that fits your volume. Price per credit drops as you scale.

Hobby
$100/mo
250,000 credits
  • $0.40 per 1000 credits
  • 20 concurrent jobs
  • Email support
Starter
$250/mo
650,000 credits
  • $0.39 per 1000 credits
  • 50 concurrent jobs
  • Email support
Growth
$500/mo
1,350,000 credits
  • $0.37 per 1000 credits
  • 75 concurrent jobs
  • Priority email support
Most Popular
Business
$1,000/mo
2,800,000 credits
  • $0.36 per 1000 credits
  • 100 concurrent jobs
  • Priority email support
Enterprise
/mo
5,871,025 credits
  • $0.34 per 1000 credits
  • 135 concurrent jobs
  • Priority support
Enterprise$5,000+

Increased concurrency, overages on credits and credit discounts for annual contracts.

Know more

Credit cost per request varies by provider. The rates below apply to async/batch requests; sync requests add a +2 credit surcharge.

ChatGPT (full response) 7 credits
ChatGPT (web search) 5 credits
Perplexity 3 credits
Grok 4 credits
Copilot 5 credits
AI Mode 4 credits
AI Overview (incl. SERP) 5 credits
Gemini 4 credits
Google Search 3 credits +2/page
Google News 3 credits +2/page

ChatGPT full response includes query fan-out, ads, and shopping data. Google News uses the same pricing as Google Search.

Estimate your monthly cost and plan

7 credits each
5 credits each
3 credits each
4 credits each
5 credits each
4 credits each
4 credits each
3 credits / 1 page
3 credits / 1 page
Monthly requests
0
Credits needed
0
Recommended plan:

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.