Perplexity Answer Reader avatar

Perplexity Answer Reader

Pricing

from $8.50 / 1,000 answer returneds

Go to Apify Store
Perplexity Answer Reader

Perplexity Answer Reader

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.

Pricing

from $8.50 / 1,000 answer returneds

Rating

0.0

(0)

Developer

Mamba Labs

Mamba Labs

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

an hour ago

Last modified

Features

Limited permissions

Share

Give your questions and your own Perplexity API key. The actor asks each question through Perplexity's Agent API with web search on and returns one row per answer: the answer text, every source Perplexity found and which of them the answer cites, the cited domains in order, and the searches Perplexity ran. Name a brand and each row also says whether the answer names it, cites its domain, and at what position. You pay Perplexity directly for each call, and you pay this actor per completed answer.

Features

  • Works on your own Perplexity API key. The key is sent only to api.perplexity.ai, and it is never stored, logged, or written to a row.
  • One row per answer with the answer text, every source (URL, title, domain, date), which sources are cited, the cited domains in order, and the searches Perplexity ran.
  • Brand check: give brand as a name, a domain, or Name|domain.com, and optional competitors. Each row says whether the answer names the brand, whether a cited source is on its domain, the citation rank, and the mention rank against your competitors.
  • Samples: ask each prompt up to 5 times, because Perplexity's answers change between calls.
  • Search controls: Perplexity effort level (fast, low, medium, high) or a named Agent API model, domain allow or deny list, recency window, and searcher country.
  • Token counts and the cost Perplexity reports for each call, so you can match rows to your Perplexity bill.
  • Refused, failed, and unfinished answers are free, and the run never sends a prompt it could not charge.

How the data is read

The actor calls Perplexity's official Agent API, POST https://api.perplexity.ai/v1/agent, with your key, from the Apify platform. It uses no proxy, no browser, no login, and no other developer's actor, and it does not read the perplexity.ai website. Perplexity ended support for the older Sonar Chat Completions API on 2026-09-27, so this actor uses the Agent API. With an effort level, Perplexity picks the model and search settings for that level; with a named model, the actor turns Perplexity's web_search tool on for it.

Your use of the answers falls under your own agreement with Perplexity. Perplexity's API terms (last updated 2026-01-23) let a customer receive output and display it within the customer's own applications.

Input

FieldTypeDefaultWhat it does
promptsarrayThe 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_keystringYour 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.
effortstringfastPerplexity'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. 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. 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. Competitor names or Name/domain.com, one per line. Used for the brand mention rank and the competitors named column.
samples_per_promptstring1How 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. 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. Limit web search results to the last hour, day, week, month, or year.
countrystringOptional. Two letter country code, for example US or DE. Perplexity uses it as the searcher's location.
concurrencystring3How 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. The run stops before a charge that would pass this amount. Summary rows are always returned. It does not cap your Perplexity bill.

Output

FieldTypeWhat it holds
row_typestringOne of: answer, run_summary. run_summary is the one free row written when the input is refused.
promptstringThe question as you gave it, sent to Perplexity unchanged.
sampleintegerWhich repeat of this prompt the row is, from 1. Set samples_per_prompt to ask the same prompt more than once.
effortstringThe Agent API effort level used, or null when you named a model.
modelstringThe model Perplexity reports it answered with.
answer_textstringThe answer text as Perplexity returned it, with its inline citation markers such as [1] or [web:1].
sourcesarrayEvery search result Perplexity returned for this answer: id, url, title, domain, date, last_updated, and cited (true when the answer text points to it).
source_countintegerSearch results Perplexity returned for this answer.
cited_urlsarraySource URLs the answer text points to with a citation marker, in order of first citation.
cited_domainsarrayDomains of the cited URLs, in order of first citation, without repeats.
search_queriesarrayThe web searches Perplexity ran to write this answer.
brandstringThe brand name or domain you asked to check, as read.
brand_namedbooleanTrue when the answer text names the brand or its domain.
brand_citedbooleanTrue when a cited source is on the brand's domain, or on a subdomain of it.
brand_citation_rankintegerPosition of the first cited source on the brand's domain among the cited URLs, from 1. Null when not cited.
brand_mention_rankinteger1 when the brand is the first of the brand and its listed competitors to be named in the answer, 2 when one competitor is named before it, and so on. Null when the brand is not named.
competitors_namedarrayCompetitors from your list that the answer names, in order of first mention.
input_tokensintegerInput tokens Perplexity counted for this answer.
output_tokensintegerOutput tokens Perplexity counted for this answer.
search_callsintegerWeb search tool calls Perplexity ran for this answer.
perplexity_cost_usdnumberThe cost Perplexity reports for this call at its list price. It is billed to your Perplexity account, not by this actor.
response_idstringPerplexity's ID for this response.
row_statusstringok, or why this row carries no data: no_results, no_change, partial, blocked, or error.
error_reasonstringWhy the row is not ok. A refused input reads input_invalid: followed by what to fix.
billable_events_jsonstringWhat this row was billed as, for example {"answer-row":1}. {} means free.
scraped_atstringWhen the row was written, UTC.

sources is a list of objects: id, url, title, domain, date, last_updated, and cited. A source is cited when the answer text carries its marker, such as [3] at the fast effort level or [web:3] at low and above.

Pricing

Pay per event. Summary rows and a refused input are free. Your Perplexity account is billed separately by Perplexity for every call, at its own rates (tokens plus a fee per web search); the perplexity_cost_usd column shows the cost Perplexity reports.

EventFree planBronzeSilverGold
answer-row, one completed answer with its sources$0.01$0.0095$0.009$0.0085
apify-actor-start, once per run (one per GB of memory; the default 128 MB is one)$0.002$0.002$0.002$0.002

Per 1,000 rows of answer-row: $10.00 on the free plan, $8.50 on Gold.

Free plan cap: 1.50 USD of evaluation a month, about 150 rows. Any paid Apify plan removes the cap, and it resets on the 1st. The run stops before a charge that passes your maximum charge per run in Apify or your max_charge_usd input.

Mamba Labs pays the platform costs of your run, Apify proxy traffic included.

Usage examples

Brand visibility. Put 20 buyer questions in prompts, set brand to YourBrand|yourbrand.com and competitors to your 3 main rivals, and set samples_per_prompt to 3. Count the rows where brand_cited is true.

Source research. Ask one question 5 times and read cited_domains to see which sites Perplexity relies on for that topic.

Clay. Number and on or off inputs are text fields, which is what Clay sends. A list input takes a JSON list, so put the column inside a one item list. Store your Perplexity key in the Clay input as api_key.

MCP. The Mamba Labs MCP server @mambalabsdev/mcp-perplexity-answer-reader exposes this actor to Claude and other MCP clients.

Error handling

CaseWhat you get
Missing or unreadable inputOne free row, row_type run_summary, error_reason starting input_invalid: with what to fix. The run ends successfully and charges nothing but the run start
No API keyUp to 3 free rows with error_reason starting no_key:. Nothing is sent to Perplexity
Perplexity refuses the key, or the account has no creditA free row with key_refused: or quota:, and the run stops
Perplexity refuses the model, effort, or filter settingsA free row with request_refused:, and the run stops, because every prompt would fail the same way
Rate limit or a Perplexity server errorUp to 3 tries per prompt, honoring Retry-After; then a free row with rate_limited: or perplexity_error:
An answer that did not finish, or no answer textA free row with row_status partial or no_results, and the text if any
max_charge_usd or the Apify charge limit is reachedThe run stops before sending the next prompt to Perplexity, and one free row with not_sent: names the first prompt not sent
The run is close to its timeoutThe actor stops starting new work 90 seconds before the timeout and delivers what it has

Limitations

  • 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.

Mamba Labs actor suite

ActorActor ID
Account Hiring WatchgRAZA5WBi1r6L0gy7
Agent Accessibility AuditoranxbRv0lKrpQ1pnua
Agent to Brokerage ResolverePRRGLxOGyaVHO4dI
AI Answer Visibility TrackerRJZvzKniYK4nswcMg
AI List Extractor for Any WebsiteD5hOdIez45M0NX5jD
AI Tooling DetectorEwkHhmqiuJgRoVEbE
Amazon Product, Price, and Stock TrackerMtJPZoyjJ3IeqTFyo
Amazon Top Reviews Scraperwh6Mq6G6BlW1CRPwx
API Deprecation and Breaking Change MonitorpHsbS3xXUK8Jqutz5
App Store and Google Play Review MonitorMaCMEhGrbchxQZ92G
B2B Reddit Conversation MonitorSoDryzzsjmY3SsiyG
B2B Social Video TranscriptsdG2UYVKE2e4zfDucK
Bluesky Brand Presence MappereLpxzP4IuXznlFVND
Bluesky Posts ScraperKldSjS7wjoeZ7vQGm
Brand Sponsor FinderPPgK6xrgOmvL7Nrys
Bulk WHOIS and RDAP Domain Age LookupMTrkG5FLU6SjqLdJY
Business PDF Field ExtractorvM7JCk0CMAx5W0oJh
Career Change Signal EnginevX2Yga1a6wGaXaP14
Company Careers Page Jobs, 17 ATS BoardsizP0rfIgf5YaRZfIh
Company Change Event FeedoX44rS0fkEJ3rXLWe
Company Discovery List Builderjch0HdaZnpbMqlcGS
Company Firmographic EnricherYlUtLWjfPpqykmB8g
Company Funding RecordOFS4Mt1gyYNtGfUbE
Company Headcount EstimatoraHC4GROnNt6kfZe5r
Company Identity Resolverlr8fTRAmZCBZmuwwh
Company Role Email, Phone and Address Finder4mMncKaJykiq94grz
Company Social Presence Mapper4k6CCemkgBDz18m2h
Competitor Price, Stock, and Changelog MonitoryxdgCbUQ4PYQWwRNU
Contact Classifier0lGSeYJmniXhGANnO
Contractor License Search, CA, TX, WA, OR, LAWBYK3CPI2kdeq4bP1
CRM Contact Job Change CheckerL8UbEmMJC1XYPSZOb
Domain Deliverability Checker0tVgxI7A6o9jMlxmc
Domain to LinkedIn URL Resolver3HtnSaqPHOg1Qg5gx
Ecommerce Platform Profiler5G2NeYjBbQTjaTn9L
Ecommerce Store DiscoveryPeHu4sLyFvQHXUUrX
Email List Verifier, Bring Your Own KeyCzVJ4NlaCKk80xpgE
Event Presence IndexWLhMy8fMDgsxdYxv5
Eventbrite Events Scrapersgc6znyrbjOy5Yk9f
Expert Witness Finder, US and AustraliaLIpwlgfE3LaQBaXd4
Facebook Posts ScraperT6jxIeq4ua0SLXnqG
Funding and Press Signal ScannerFS13X6dhQVgX3XOM6
GDPR Cookie Banner and Consent CheckerTrKyOS0KBoGC35nbr
GitHub Followers and Following ExportSGNxDmFb9v3tRDaFI
GitHub Organization Signal ScannerahF8RRpv5mzPao5CN
Google Ads Transparency Center Scraper by Domain1eOwxhBVxzvOXAm4s
Google Maps Places ScraperSuvHCNJ7pIuw6gn54
Google Trends ScraperOeDzaACKmBYJXzHZk
GTM Hiring Signal ScraperD7O1SA2EqwHGsGr1P
GTM Signals AggregatorxKdRfnfFNkdMpFuNs
Healthcare Provider NPI EnricherMrgbHzcpDq3mOv9Df
ICP Fit ScorerW161DT8W4kW55dMFh
Influencer Change Monitord2VVgahNL6UmcLkhg
Influencer Lead List BuilderKnmByszcv135yM30G
Influencer Profile ScraperEqEnklDVMIcB1V499
Influencer Search Across TikTok, Instagram and YouTubetpkedmloIIWtXx6sg
Influencer Talent Agency LookupzCuX4Mgyg6JvXgGzd
Instagram Facebook Brand Presence MapperHXh65I0JBjPsunbY8
Integration and Marketplace Presence MapperV0guNuvM85Q61f2gj
Job Board Keyword Signal Scanner4DvqpvhMR74NLcDDY
Job Posting MonitorQCfICD9kOPiOdj5iI
Journalist and Media List BuildermAfizsZC8qRoR0ecS
Launch Directory List BuildercRq3bmvEZxZtioQ7U
Lead File Import CheckerRwlGVXTf46LqZdUgt
Legal Entity ResolverKHFyPCDIx7CyqULYm
Link in Bio Scraper and Newsletter DetectorOorucdheTIgu7RFzK
LinkedIn Company Page MapperzOPm6A9JEhUGcIdFW
LinkedIn Jobs FeedSH6N0d8cz46BhCC8B
LinkedIn Post TrackeroiGLNPuaf5BRaz9K5
Local Business Lead BuilderqMN97aoHhsAS5bznV
Local Rank and Map Pack Trackergv0kyHGDIg8XscclB
Lookalike Companies from Seed Domainse2O426WBAbLLQL4Z2
Manufacturer and Supplier FinderQcsdmd0lUfPzVkonh
MCP Server Change and Health MonitorIeqjWF9U0BdDQFY08
Media URL TranscriberSyfr7Ya3EsHgWfrB6
Meta Ad Library Ads by Company, Graph APIJ1GWlSXfSGU3u8Wng
Mobile Phone Waterfall6OOgPktf7RIa5XCOP
Multi Platform Social Posts and CommentsicFuHR1EzDvUcfCQ5
Netherlands Rental ListingssGKGsbwoX18lFb6dR
New Hire FindercKuc38p4nYHNF3IW8
Newly Registered Companies, UK, Norway, Finland, Franceg2WfZhWvCtc57g2Jo
News and Media Mention Monitorgol1PPUKrsIk4QLBd
News Site Article ArchiveNjcF3UD8791raFNHh
Newsletter Sponsor TrackerqSwpqxD1TiPZpLQHv
Open Tender and RFP FinderkPTGz6t6TFoUUyfaO
Outbound Stack Detectorv43UJC8r7qW7cBSTG
Page Finder and ExtractorTpurgcOZbVnknlaiC
Partner and Member Directory ExtractorZX0XJPPUvnFJxeC1a
People Finder & Email VerifierLEgloG7tWgQl4o6TD
Person LinkedIn URL ResolverssuyPV8LnEsL8qbnb
Person Social Footprint MapperjfQXa2zW9FHCJot9K
Personal Email to Company ResolverAefT5Ye6YNPFQwJBf
Pinterest Brand Presence Mapperd1HvjZfKhgvWsoEwn
Podcast Guest and Host Findero2MGSvgbSLeeXOsIo
Private Company Funding HistoryH02K3rQIVOYpnLYc3
Product Hunt Daily Launches with Maker DomainsO4VX63drWK9Y9x641
Property Owner Records0J7ovG1iaZpQD1P0T
Prospect Engineq9rT6v64nUJdPexOQ
Public Feature Board and Roadmap MonitorrcHF5gj5r2Vqnry35
Publishing Frequency TrackerTbLwaUUATdYb6wp4N
Recent Funding Rounds FeedKueVp9MOz7iOoAgDp
Reddit Brand Presence MapperpKQZmDaT70SEb54bZ
Reddit Search and Thread Scraper4Gsth5cP2Xt9V2xDN
Reporting Window FinderuINxR7a1IW8qUTRUX
Research Topic Institutions and AuthorsOH8ANqt7bCKbo72Gk
Semrush Domain Metrics3dqa0abJrpssHtrYL
Sequencer Event PollerS6s8Rjd61tGdrMRk4
Sequencer Lead Push0Jv27VeWM5tSZQs9x
Shopify App Store and Chrome Web Store ListingsgaY0BzkLyN77mD3wI
Site Crawler for Links and TableslLLJ6JxZ4XqN8ULz0
Streaming Subscription Prices by CountrytbMroS2Zyn57bW17E
Substack Newsletter and Posts ScraperUEFsdwiPLmPNVy9xd
Team Page People Extractorj8a9zX0k4mNbvDbWK
Tech Stack Signal Detectorqyd7nNyqFPelQViBx
Tennis Match Datav3OX6zxXHZOf2yurO
Threads Posts by Keyword, Exact Match2OT8K8RiEEWtaj2MW
Ticketmaster Event PricesCrvPX4IwLXQX9bls1
TikTok Brand Presence Mapperfco8FvoJcSafbeyd1
TikTok Video Statsuz9Q3cEycRgA6NfqA
Trustpilot Reputation Enricher3lIqfCt61j4hqE1xz
US and UK Contract Award Winners by CompanyzhEtllASykOcx9hJ8
US Import Records Buyer FinderVIMafpKF5ggOw0COU
VC and Accelerator Portfolio List BuilderchH8hrfuoqqolW06m
Website Accessibility Checker, WCAG 2.2 AAP3jBj3FRghKEhX52z
Website Phrase and Business Model ClassifierCBuZ9k7sRwBeiKiCS
Website Traffic Rank EstimatorGnOFUzlNVIoXgeJjH
Work Email WaterfallOT6xqTFThC0Rjf7Zj
Workplace Program DetectorLi6pPDhqbdzFz3h7G
X Brand Presence MapperoLOgadhHUkNAyDA3w
YouTube Channel and Video List ScrapertxaAjeBqgj5MStFE4
YouTube Channel Email FinderIDgKZcmeeuunUbccN
YouTube Channel from Company Domain6hSpD3kd2s2IQ4VSs
Zillow Listing DetailsyG4zM0Enfsw2NefJ1

Built by Mamba Labs.