Perplexity Answer Reader

live$0.01/answerSignal Detection

Last updated November 20, 2026

Ask Perplexity your questions on your own Perplexity API key. One row per answer with the full text, every source and which ones are cited, the searches it ran, and an optional brand check. You pay Perplexity directly and this actor per answer.

Features

  • Works with your own Perplexity API key; the key is never stored or logged.
  • One row per answer with the text, every source, which sources are cited, and the searches Perplexity ran.
  • Optional brand and competitor check: named, cited, and at what position.
  • Refused, failed, and unfinished answers are free, and the run never sends a prompt it could not charge.
  • Pay per event: Answer returned at $0.01.

Input

promptsarrayoptional

The questions to ask Perplexity, one per line. Each is sent as written. As text, one prompt per line; a comma does not split a prompt.

api_keystringoptional

Your own Perplexity API key, from console.perplexity.ai. It is sent only to api.perplexity.ai and is never stored, logged, or written to a row. With no key, the run checks up to 3 prompts for free and asks nothing.

effortstringoptional

Perplexity's Agent API effort level: fast (default; quick answers with numbered citations), low, medium, or high. Higher levels search more and cost more on your Perplexity bill. Ignored when you name a model.

modelstringoptional

Optional. An Agent API model ID, for example perplexity/sonar or openai/gpt-5.6-sol. When set, the actor asks that model with Perplexity's web search tool on instead of using an effort level.

brandstringoptional

Optional. A brand name, a domain, or both as Name|domain.com. Each row then says whether the answer names the brand and cites its domain, and at what position.

competitorsarrayoptional

Optional. Competitor names or Name|domain.com, one per line. Used for the brand mention rank and the competitors named column.

samples_per_promptstringoptional

How many times to ask each prompt, 1 to 5 (default 1). Answers change between calls, so more samples give a steadier read. Each sample is one Perplexity call and one charged answer.

search_domain_filterarrayoptional

Optional. Domains for Perplexity's web search to use, or to skip with a leading minus, for example -pinterest.com. Up to 20.

search_recency_filterstringoptional

Optional. Limit web search results to the last hour, day, week, month, or year.

countrystringoptional

Optional. Two letter country code, for example US or DE. Perplexity uses it as the searcher's location.

concurrencystringoptional

How many prompts to ask at the same time, 1 to 10 (default 3). Lower it if your Perplexity account hits its rate limit.

max_charge_usdstringoptional

Optional. The run stops before a charge that would pass this amount. Summary rows are always returned. It does not cap your Perplexity bill.

Output schema

json
{
  "row_type": "string",
  "prompt": "string",
  "sample": "integer",
  "effort": "string",
  "model": "string",
  "answer_text": "string",
  "sources": "array",
  "source_count": "integer",
  "cited_urls": "array",
  "cited_domains": "array",
  "search_queries": "array",
  "brand": "string",
  "brand_named": "boolean",
  "brand_cited": "boolean",
  "brand_citation_rank": "integer",
  "brand_mention_rank": "integer",
  "competitors_named": "array",
  "input_tokens": "integer",
  "output_tokens": "integer",
  "search_calls": "integer",
  "perplexity_cost_usd": "number",
  "response_id": "string",
  "row_status": "string",
  "error_reason": "string",
  "billable_events_json": "string",
  "scraped_at": "string"
}

Pricing

$0.01per answer
EventFree plan price
Answer returned$0.01
Actor Start$0.002

Pay per event on the Apify platform. Paid Apify plans pay less per event. No subscription, no seat license.

On the Apify free plan the actor stops at $1.50 of charges a month, about 150 answers. Any paid Apify plan removes the cap.

Limits

  • Tested on Perplexity's documented response shapes and on the live refused key path. Answer rows were not seen live before release, because no Mamba Labs key is used in this actor; the first buyer's key is the live test.
  • The answer is what the Agent API returns. It can differ from what a person sees on the perplexity.ai website or app.
  • Citation markers are matched to sources by their number. If one answer returns two search results with the same number, the row says so in error_reason.
  • Each prompt is one Perplexity call with no conversation history. Higher effort levels search more and take longer; one call may take up to 4 minutes before it ends as a free timeout row.
  • Your Perplexity rate limit and credit balance apply. Lower concurrency if your account hits its rate limit.

Available on