Web API reference

Observed Perplexity REST and GraphQL behavior used by pplx-export and pplx-ask.

Observed interface, not a stability guarantee

These pages describe behavior the project observed from the web application, archived responses, frontend bundles, and the current implementation. They are not an official Perplexity API contract. Dated observations should be revalidated before changing network-facing code.

1. Reading order

1. Authentication model — session cookies, tokens, linked accounts, and identity.
2. GraphQL — persisted queries, APQ identifiers, and operations in use.
3. REST endpoints — observed endpoints grouped by purpose.
4. Responses and error semantics — response shapes, parsing rules, terminal states, and risk-control behavior.
5. Discovery methods and roadmap — how endpoints are found and which uncertainties remain.

2. Related implementation documents

• pplx-ask and accounts
• Rate limiting and error handling
• Troubleshooting