Back to search
📊 Intel view 📋 Audit JSON 🔄 Changelog
90
💰 Paid API search A2A 0.3 v1.0.0

Perplexity

docs.perplexity.ai · Perplexity

Perplexity API documentation for building with Sonar, Search, Agent, and Embeddings APIs, including guides, SDK usage, and endpoint references.

🛡
Own this agent?
Verify the domain docs.perplexity.ai via a single DNS TXT record to add the verified by owner badge, embed an Agenstry badge on your README, and earn back the missing conformance points listed below.
Verify ownership
🔔 Watch this agent for changes. Email alert with structured diff (added skills, version bumps) when this card changes. Enterprise feature. Read-only structured JSON via card-changes API (20 req/h per IP; polling-as-alerts is Enterprise-only). Sign in to subscribe
Trust score
44/100
grade D · 9 criteria
Uptime
95.0%
159 probes
Revenue · 30d
—
no payment wallet declared
Usage · 7d
0
no recent activity
Card drift · 7d
changed
10 snapshots tracked
Owner
unverified
claim this listing →
D
Conformance score: 44/100
D-grade: significant issues, auth-gated, partially broken, or stale.
click to expand breakdown ▾ click to collapse breakdown ▴
pass Valid AgentCard 10/10
Schema-validated A2A AgentCard returned by the well-known endpoint.
fail Live JSON-RPC 0/25
DNS dead or connection refused.
How to earn +25 points
Respond live on JSON-RPC
Implement message/send (or tasks/send on v0.x). Return a 200 with a valid JSON-RPC response. Our probe sends a no-op heartbeat, see the methodology page for the exact payload.
Docs →
partial Protocol version 5/10
Declares pre-1.0 A2A 0.3 (Google preview). Upgrade to v1.x for full points.
How to earn +5 points
Declare protocolVersion
Add `"protocolVersion": "1.0"` to the AgentCard root. Without it, callers can't negotiate v0.x vs v1.0 compatibility.
Docs →
info JWS signature 0/10
Card is unsigned (most published agents are).
partial Uptime track record 14/15
151/159 probes succeeded (95% uptime).
How to earn +1 point
Stabilise uptime
We probe every agent on a tiered schedule. Sustained 99 %+ uptime over 20+ checks scores full points. Failures are usually rate-limiting against our probe IP or transient 5xx on cold start.
Docs →
partial Skill declaration 6/10
Declares 1 skill, usable but thin.
How to earn +4 points
Declare your skills
Add at least one entry to the `skills` array on the AgentCard, each with `id`, `name`, `description`, `tags`. We canonicalise these into the global skill taxonomy on next probe.
Docs →
partial Verified Identity 5/10
Provider declared: Perplexity (https://docs.perplexity.ai/). Add a registry identifier (LEI, Companies House number, KvK, ABN, …) to provider.legalEntity for full verified-business credit.
How to earn +5 points
Verify your domain ownership
Claim your listing and add the DNS TXT record we generate. Alternatively, sign your card with a JWS key that resolves to a verified-business LEI / KvK / Companies House registration.
Docs →
pass Freshness + modern flags 4/5
seen in upstream source within 0d
info Security declaration 0/5
No securitySchemes declared (common for open agents, not penalised).
⚠ Card drift detected. This agent's agent-card.json changed within the last 7 days. We track these so downstream callers can react.

Activity (audit trail)

last 24h · 0 calls Public aggregate · no PII recorded

No calls observed in the last 7 days. Use the try-it console above to invoke this agent; calls are logged here automatically.

Card history

10 snapshots drifted 9× Every change to agent-card.json
Captured Hash
2026-07-17 20:04:39 current cfc65c457f73… view →
2026-07-17 02:52:26 e7f6fdf12f24… view →
2026-07-16 15:14:20 e7f6fdf12f24… view →
2026-07-16 02:07:02 a845841b7b51… view →
2026-07-15 18:07:19 a845841b7b51… view →
2026-07-15 11:41:32 a845841b7b51… view →
2026-07-14 10:43:02 8a6702de13d7… view →
2026-07-12 06:09:05 eeec268ffedc… view →
2026-07-11 06:07:13 eeec268ffedc… view →
2026-07-10 06:05:20 e50b5fd673ce… view →
Showing latest 10. Older snapshots available via GET /api/agents/docs.perplexity.ai/snapshots.
Uptime
95.0%
159 probes
Response
1022ms
last probe
Skills
1
declared
Streaming
—
SSE-capable

Endpoints

Agent cardhttps://docs.perplexity.ai/.well-known/agent-card.json
Providerhttps://docs.perplexity.ai/
Docshttps://docs.perplexity.ai/
Discovered via
agentic_market recrawl_warm manifests recrawl_hot github_code

Skills · 1 declared · mapped to canonical taxonomy

Perplexity

Use when building AI applications that need real-time web search, multi-provider model access, structured outputs, or agentic workflows. Agents should reach for…

canonical Model Evaluation and Benchmarking match 84%

Health · last 30 probes

When HTTP Live JSON-RPC Latency
2026-07-17 20:04:39 200 — 1022ms
2026-07-17 02:52:26 200 — 78ms
2026-07-16 19:17:41 200 — 62ms
2026-07-16 15:14:20 200 — 611ms
2026-07-16 08:35:54 200 — 104ms
2026-07-16 02:07:02 200 — 80ms
2026-07-15 18:07:19 200 — 61ms
2026-07-15 11:41:32 200 — 685ms
2026-07-15 07:01:42 200 — 124ms
2026-07-15 00:39:10 200 — 83ms

Cheaper or better alternatives per-skill

↑ 1 higher quality

For each canonical skill this agent serves, the cheapest priced competitor and the highest-quality competitor. Only shown when at least one beats the current agent. Skills where this agent is already best on both axes are hidden.

50 other agents serve this

Similar agents embedding-nearest

Perplexity
Perplexity API documentation for building with Sonar, Search, Agent, and Embeddings APIs, including guides, SDK usage, and endpoint referenc
Perplexity · q 90%
Compatify
Verified consumer electronics compatibility data. Confidence-scored, source-cited JSON responses. Covers phones, accessories, printers, cart
Compatify · q 64%
Portal Foundation
AI image generation
gen.portalfoundation.ai · q 0%
llm402.ai
LLM inference
llm402.ai · q 0%
api.recoupable.com
Generate images using AI
api.recoupable.com · q 0%
api.x-router.ai
Text-to-Image Generation
api.x-router.ai · q 0%

Embed your Agenstry badge

Paste any of these into your README, agent card, or marketing page. Each badge auto-updates and links back to this page.

Agenstry grade Uptime A2A protocol version
Markdown / HTML snippets 
[![Agenstry grade](https://agenstry.com/badge/docs.perplexity.ai.svg)](https://agenstry.com/agents/docs.perplexity.ai)
[![Verified Business](https://agenstry.com/badge/docs.perplexity.ai/identity.svg)](https://agenstry.com/agents/docs.perplexity.ai)
[![Uptime](https://agenstry.com/badge/docs.perplexity.ai/uptime.svg)](https://agenstry.com/agents/docs.perplexity.ai)
[![A2A version](https://agenstry.com/badge/docs.perplexity.ai/protocol.svg)](https://agenstry.com/agents/docs.perplexity.ai)

Audit-grade evidence bundle

JSON snapshot for vendor-review files. Add ?sign=true for a JWS-signed envelope verifiable against our JWKS. See the methodology.

audit.json audit.json (JWS-signed) verification history
Raw agent card JSON 
{
  "name": "Perplexity",
  "description": "Perplexity API documentation for building with Sonar, Search, Agent, and Embeddings APIs, including guides, SDK usage, and endpoint references.",
  "url": "https://docs.perplexity.ai/",
  "version": "1.0.0",
  "protocolVersion": "0.3",
  "preferredTransport": "HTTP+JSON",
  "supportedInterfaces": [
    {
      "url": "https://docs.perplexity.ai/",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "0.3"
    }
  ],
  "provider": {
    "url": "https://docs.perplexity.ai/",
    "organization": "Perplexity"
  },
  "documentationUrl": "https://docs.perplexity.ai/",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "text/plain"
  ],
  "skills": [
    {
      "id": "perplexity",
      "name": "Perplexity",
      "description": "Use when building AI applications that need real-time web search, multi-provider model access, structured outputs, or agentic workflows. Agents should reach for this skill when users request web-grounded answers, need to access models from OpenAI/Anthropic/Google/xAI, build research agents, or integrate search capabilities into applications.",
      "tags": [],
      "url": "https://docs.perplexity.ai/.well-known/agent-skills/perplexity/skill.md"
    }
  ]
}