{ "data": { "a": { "slug": "perplexity-search-api", "name": "Perplexity Search API", "vendor": "Perplexity", "vendorUrl": "https://www.perplexity.ai/", "kind": "http-api", "category": "search", "summary": "Perplexity's Search API returns ranked web results with extracted page text as JSON from Perplexity's own index, through `POST /search`. The same key reaches the Agent API's web_search tool for cited answers, and a hosted MCP server wraps both.", "url": "https://www.anchorterminal.com/tools/perplexity-search-api", "markdownUrl": "https://www.anchorterminal.com/tools/perplexity-search-api.md", "slimMarkdownUrl": "https://www.anchorterminal.com/tools/perplexity-search-api.min.md", "jsonUrl": "https://www.anchorterminal.com/api/v1/tools/perplexity-search-api.json", "dns": "perplexity-search-api.grade.anchorterminal.com", "repo": "https://github.com/perplexityai/modelcontextprotocol", "license": "Proprietary service under the Perplexity API Terms of Service. The MCP server is MIT and the official SDKs Apache-2.0", "transports": [ "streamable-http", "stdio" ], "remoteUrl": "https://api.perplexity.ai/mcp", "packages": [ { "registry": "pypi", "name": "perplexityai" }, { "registry": "npm", "name": "@perplexity-ai/perplexity_ai" }, { "registry": "npm", "name": "@perplexity-ai/mcp-server" } ], "auth": "mixed", "authNotes": "Bearer Perplexity API key in the `Authorization` header. Keys belong to a project in the API console, are shown once, and can be generated and revoked through `/generate_auth_token` and `/revoke_auth_token`, with a rotation guide. No per-key scopes found. The hosted MCP server also accepts Sign in with Perplexity (OAuth), where the user picks the organisation to bill.", "pricing": "usage", "pricingNotes": "$5 per 1,000 successful Search API requests, or $1 with Fast Search, with up to five queries per request billed once. Invalid, rate-limited and failed requests are not billed. Agent API web_search is $2.50 per 1,000 calls plus model tokens. Prepaid credits with a card. No free allowance found.", "priceSummary": "$5 / 1k req", "where": "both", "x402": { "level": "no", "evidence": "No x402, MPP or L402 in the Search API docs, the pricing page, the OpenAPI description or llms.txt (checked 2026-11-06). An empty balance returns 402 Payment Required with no payment requirements, per the FAQ.", "endpoints": [] }, "toolCount": 4, "popularity": { "githubStars": null, "npmWeekly": null, "pypiWeekly": null, "asOf": "2026-11-06" }, "docsUrl": "https://docs.perplexity.ai/docs/search/overview", "llmsTxt": "https://docs.perplexity.ai/llms.txt", "openapi": "https://docs.perplexity.ai/openapi.json", "registryName": "ai.perplexity/mcp-server", "capabilities": [ "web.search", "search.answer", "search.research" ], "tags": [ "hosted", "usage-priced", "prepaid", "card-required", "closed-source", "openapi", "llms-txt", "mcp", "remote-mcp", "mcp-registry", "python", "typescript", "status-page", "soc2" ], "lastRelease": "2026-10-23", "graded": true, "anchor": { "graded": true, "score": 70.2, "grade": "BB", "agentReady": true, "rank": 211, "ranked": true, "rankOf": 1510, "categoryRank": 5, "methodology": "0.7", "run": "2026-10-01", "scores": { "ergonomics": 85, "maintenance": 82, "payments": 25, "reliability": 80, "schema": 89, "security": 56, "transparency": 66 }, "pending": [ "performance", "tasks" ], "assessment": { "confidence": "medium", "date": "2026-11-06" }, "negative": 0, "verdict": "Raw ranked results with token-capped page text from Perplexity's own index, $5 per 1,000 requests or $1 with Fast Search, an OpenAPI description and a hosted MCP server with read-only annotations. Uptime is not guaranteed, there is no free allowance, keys carry no scopes, and no guidance on untrusted page text was found.", "bestFor": "Agents on any model that need raw ranked sources with extracted text at a low per-request price, and teams that want cited answers from the same key through the Agent API.", "strengths": [ "OpenAPI 3.1 description of `POST /search` with enums and limits, llms.txt and a Markdown twin of every docs page", "`max_tokens`, `max_tokens_per_page` and `max_results` cap what reaches the model, and up to five queries share one billed request", "Per-request prices published without login, and invalid, rate-limited and failed requests are not billed", "Hosted MCP server with OAuth or a key; the local server is in the official registry under the verified ai.perplexity namespace", "security.txt valid to 31 December 2027, a SOC 2 Type II report and a SECURITY.md that takes private reports" ], "weaknesses": [ "The FAQ says uptime and recovery time are not guaranteed, and the terms carry no SLA", "No free allowance and prepaid credits with a card; Stripe Projects still needs a $10 purchase", "Project keys have no scopes or spending limits, so any key can run every API on the account", "No guidance on treating returned snippets as untrusted text was found in the docs or the MCP server", "The DPA says Perplexity Search may follow different data terms, and no retention period for search queries is stated" ], "agentNotes": [ "Set `max_tokens_per_page` and `max_tokens` before calling; extracted text otherwise fills the context, and the price does not change with size", "Skip results with an empty `snippet` and dedupe by `url` when sending a `query` array; each query costs one rate-limit unit", "Use `search_type: \"fast\"` for $1 per 1,000 when latency and cost matter more than depth", "On 429 wait for Retry-After, then back off; on 402 stop and ask the user to add credits", "Use the Search API for sources and the Agent API's web_search tool for a written answer with citations" ], "metrics": { "kind": "remote", "measured": false }, "reviewCount": 0, "avgRating": 0, "history": [ { "basis": "public evidence", "confidence": "medium", "grade": "BB", "methodology": "0.7", "pending": [ "performance", "tasks" ], "run": "2026-10-01", "runLabel": "October 2026 research run", "score": 70.2 } ], "editorialScores": { "ergonomics": 85, "maintenance": 82, "payments": 25, "reliability": 80, "schema": 89, "security": 56, "transparency": 51 }, "provenanceScore": 80, "checked": { "categories": { "ergonomics": "2026-11-06", "maintenance": "2026-11-06", "payments": "2026-11-06", "reliability": "2026-11-06", "schema": "2026-11-06", "security": "2026-11-06", "transparency": "2026-11-06" }, "last": "2026-11-06", "oldest": "2026-11-06", "stale": false, "staleAfterDays": 90 } }, "connect": { "install": "pip install perplexityai", "http": "curl -X POST https://api.perplexity.ai/search \\\n -H \"Authorization: Bearer $PERPLEXITY_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"query\": \"renewable energy technologies\", \"max_results\": 10, \"max_tokens\": 50000, \"max_tokens_per_page\": 4096}'", "claudeCode": "claude mcp add --transport http perplexity https://api.perplexity.ai/mcp", "config": { "mcpServers": { "perplexity": { "url": "https://api.perplexity.ai/mcp" } } } }, "letme": { "capability": "https://letme.dev/web.search", "tool": "https://letme.dev/perplexity-search-api" }, "sameCompany": [ "perplexity-space", "pplx-decider", "pplx-decider-flash" ], "area": "web-data", "unitPrices": [ { "item": "Search API request", "unit": "1k-requests", "usd": 5, "note": "Up to five queries in one request billed once; failed and rate-limited requests not billed" }, { "item": "Search API request with Fast Search", "unit": "1k-requests", "usd": 1, "note": "`search_type: \"fast\"`" }, { "item": "Agent API web_search call", "unit": "1k-calls", "usd": 2.5, "note": "Plus model tokens; $1.00 with Fast Search" }, { "item": "Agent API fetch_url call", "unit": "1k-calls", "usd": 0.5, "note": "Plus model tokens" } ], "provenance": { "legalEntity": "Perplexity AI, Inc.", "domain": "perplexity.ai", "domainRegistered": "", "endpointOnVendorDomain": true, "terms": "https://www.perplexity.ai/hub/legal/perplexity-api-terms-of-service", "privacy": "https://www.perplexity.ai/hub/legal/privacy-notice", "statusPage": "https://status.perplexity.com/", "changelog": "https://docs.perplexity.ai/docs/resources/changelog", "securityTxt": "valid", "checked": "2026-11-06", "notes": [ "The API Terms of Service (last updated 23 January 2026) name Perplexity AI, Inc. and California law. The Data Processing Addendum (last updated 13 August 2026) deletes personal data within 30 days of the service ending and notes that Perplexity Search may follow different data terms.", "www.perplexity.ai/.well-known/security.txt is valid until 31 December 2027 and links www.perplexity.ai/security.", "The status page moved to incident.io on 10 September 2026 and has Website, App, Computer and API components, with no separate Search component.", "docs.perplexity.ai/robots.txt allows the docs and carries Content-Signal ai-train=yes, search=yes, ai-input=yes. The terms have no clause on automated access to the website.", "The changelog dates entries by month only. Domain registration was not checked." ], "score": 80 }, "pageJsonUrl": "https://www.anchorterminal.com/tools/perplexity-search-api.json", "live": { "slug": "perplexity-search-api", "probe": { "target": "https://api.perplexity.ai/mcp", "method": "get", "lastAt": "2026-11-07T19:22:25.812257306Z", "lastOk": true, "lastStatus": 401, "lastMs": 194, "lastNote": "asks for credentials", "authRequired": true, "uptime24h": 100, "uptime30d": 100, "p50ms24h": 165, "p95ms24h": 266, "samples24h": 210, "samples30d": 210, "days": [ { "date": "2026-11-06", "probes": 13, "ok": 13 }, { "date": "2026-11-07", "probes": 197, "ok": 197 } ] }, "vendorStatus": { "page": "https://status.perplexity.com", "indicator": "none", "summary": "All Systems Operational", "checkedAt": "2026-11-07T19:23:08.772447999Z" }, "versions": [ { "registry": "mcp-registry", "name": "ai.perplexity/mcp-server", "version": "1.2.1", "seenAt": "2026-11-07T18:16:28.95801333Z" }, { "registry": "npm", "name": "@perplexity-ai/mcp-server", "version": "1.3.0", "seenAt": "2026-11-06T23:55:31.394431614Z" }, { "registry": "npm", "name": "@perplexity-ai/perplexity_ai", "version": "0.41.0", "seenAt": "2026-11-06T23:55:30.575713692Z" }, { "registry": "pypi", "name": "perplexityai", "version": "0.46.1", "released": "2026-10-23", "seenAt": "2026-11-06T23:55:30.34668899Z" } ], "githubStars": 2612, "npmWeekly": 97298, "pypiWeekly": 401537, "securityTxt": { "url": "https://perplexity.ai/.well-known/security.txt", "state": "valid", "expires": "2027-12-31T00:00:00Z", "checkedAt": "2026-11-07T16:01:03.917430365Z" }, "llmsTxt": { "url": "https://docs.perplexity.ai/llms.txt", "ok": true, "status": 200, "checkedAt": "2026-11-07T15:33:36.681222085Z" }, "pages": [ { "url": "https://docs.perplexity.ai/docs/resources/changelog", "kind": "changelog", "status": 200, "checkedAt": "2026-11-07T14:07:27.675707255Z", "changedAt": "2026-11-06T13:29:48.535494355Z", "fingerprint": "a52a171e1f1f" }, { "url": "https://www.perplexity.ai/hub/legal/privacy-notice", "kind": "privacy", "status": 200, "checkedAt": "2026-11-07T14:32:54.875760985Z", "changedAt": "2026-11-06T13:53:25.792168971Z", "fingerprint": "29c9dd01613d" }, { "url": "https://www.perplexity.ai/hub/legal/perplexity-api-terms-of-service", "kind": "terms", "status": 200, "checkedAt": "2026-11-07T14:32:50.897959644Z", "changedAt": "2026-11-06T13:53:22.592031411Z", "fingerprint": "6a7e4a95f45b" } ], "mcpTools": { "url": "https://api.perplexity.ai/mcp", "checkedAt": "2026-11-07T01:46:49.011542458Z", "status": "auth", "note": "asks for credentials before listing its tools", "changedAt": "2026-11-07T01:46:49.011542458Z" }, "updatedAt": "2026-11-07T19:23:08.772447999Z" } }, "answer": "Perplexity Search API scores 70.2 (BB) on agent readiness against SERPHouse's 42.4 (E), and leads in 6 of 7 scored categories. SERPHouse leads on payments \u0026 pricing.", "b": { "slug": "serphouse", "name": "SERPHouse", "vendor": "Patoliya Infotech LLP", "vendorUrl": "https://www.serphouse.com", "kind": "http-api", "category": "search", "summary": "SERPHouse is a SERP API from Patoliya Infotech LLP in India that returns parsed Google, Bing and Yahoo results as JSON, live or scheduled, with a Scraper API for page HTML or Markdown and a hosted MCP server.", "url": "https://www.anchorterminal.com/tools/serphouse", "markdownUrl": "https://www.anchorterminal.com/tools/serphouse.md", "slimMarkdownUrl": "https://www.anchorterminal.com/tools/serphouse.min.md", "jsonUrl": "https://www.anchorterminal.com/api/v1/tools/serphouse.json", "dns": "serphouse.grade.anchorterminal.com", "repo": "https://github.com/SERPHouse/serphouse-mcp", "transports": [ "streamable-http", "stdio" ], "remoteUrl": "https://mcp.serphouse.com/YOUR_API_KEY/mcp", "packages": [ { "registry": "npm", "name": "serphouse-mcp" } ], "auth": "api-key", "authNotes": "One API key per account, shown on the dashboard after a browser signup and email confirmation. Sent as `Authorization: Bearer` or as `api_token` in the query string. The hosted MCP server takes the key in its URL path. One account per user. No scopes or rotation found.", "pricing": "paid", "pricingNotes": "Basic $29.99 a month for 400,000 credits ($0.75 per 1,000 SERP requests) and Regular $49.99 for 800,000 ($0.62). Autocomplete $0.37 and $0.31, Top 100 Google $7.50 and $6.25 per 1,000. Custom plans by email. Free trial 4,000 credits for 7 days, no card. Credits don't roll over.", "priceSummary": "$0.75 / 1k req", "where": "both", "x402": { "level": "no", "evidence": "No x402, MPP or L402 on the pricing page, the docs, llms.txt or the MCP source (checked 2026-11-06). An empty balance returns 402 'Insufficient credits'.", "endpoints": [] }, "toolCount": 23, "popularity": { "githubStars": null, "npmWeekly": null, "pypiWeekly": null, "asOf": "2026-11-06" }, "docsUrl": "https://www.serphouse.com/docs", "llmsTxt": "https://www.serphouse.com/llms.txt", "capabilities": [ "search.serp", "web.search", "search.news", "search.images", "web.fetch" ], "tags": [ "hosted", "paid", "no-card", "free-tier", "mcp", "remote-mcp", "llms-txt", "python", "india" ], "lastRelease": "2026-07-06", "graded": true, "anchor": { "graded": true, "score": 42.4, "grade": "E", "agentReady": false, "rank": 1283, "ranked": true, "rankOf": 1510, "categoryRank": 24, "methodology": "0.7", "run": "2026-10-01", "scores": { "ergonomics": 64, "maintenance": 23, "payments": 40, "reliability": 40, "schema": 66, "security": 11, "transparency": 50 }, "pending": [ "performance", "tasks" ], "assessment": { "confidence": "medium", "date": "2026-11-06" }, "negative": 0, "verdict": "SERPHouse returns parsed Google, Bing and Yahoo results at published prices from $0.62 per 1,000 requests, with a 23-tool MCP server and a 4,000-credit trial without a card. The hosted MCP puts the key in its URL, there is no status page, changelog or security contact, and the terms keep search history indefinitely.", "bestFor": "Low-cost Google, Bing and Yahoo result parsing for SEO and rank tracking, with many Google verticals.", "strengths": [ "Published prices per 1,000 requests, $0.75 on Basic and $0.62 on Regular, with failed requests not charged", "Google web, news, images, shopping, jobs, videos, forums, local and autocomplete, plus Bing and Yahoo, in one API", "Hosted and stdio MCP server with 23 tools, typed Zod inputs and routing advice between tools, MIT licensed", "llms.txt and Markdown copies of the docs pages, with a status code table and per-engine examples", "Free trial of 4,000 credits for 7 days with no card" ], "weaknesses": [ "The hosted MCP server takes the API key only in its URL path, and the REST API also accepts `api_token` in the query string", "No status page, changelog, security.txt, disclosure policy or certification found", "Terms keep search history indefinitely and advise users in the European Economic Area not to use the service", "The pricing page states a 99.99% uptime SLA and the docs 99.95%, with no SLA terms or credits found", "The home page sends readers to a playground 'on the Oxylabs dashboard', with no relationship to Oxylabs found" ], "agentNotes": [ "Send the key as `Authorization: Bearer`, not as `api_token` in the URL", "Treat a 200 with `\"status\": \"error\"` and 'Please try again' as a failure and retry later", "Pass `loc` or `loc_id` for Google and Bing tools other than `serphouse_search`; find IDs with `serphouse_location_search`", "Use `serphouse_search` for plain lookups and `serphouse_serp_google_advanced` only when ranks beyond the top 10 are needed, at ten times the price", "Keep under 60 requests a minute on self-serve plans" ], "metrics": { "kind": "remote", "measured": false }, "reviewCount": 0, "avgRating": 0, "history": [ { "basis": "public evidence", "confidence": "medium", "grade": "E", "methodology": "0.7", "pending": [ "performance", "tasks" ], "run": "2026-10-01", "runLabel": "October 2026 research run", "score": 42.4 } ], "editorialScores": { "ergonomics": 64, "maintenance": 23, "payments": 40, "reliability": 40, "schema": 66, "security": 11, "transparency": 39 }, "provenanceScore": 61, "checked": { "categories": { "ergonomics": "2026-11-06", "maintenance": "2026-11-06", "payments": "2026-11-06", "reliability": "2026-11-06", "schema": "2026-11-06", "security": "2026-11-06", "transparency": "2026-11-06" }, "last": "2026-11-06", "oldest": "2026-11-06", "stale": false, "staleAfterDays": 90 } }, "connect": { "install": "npx serphouse-mcp", "http": "curl -X POST https://api.serphouse.com/serp/live \\\n -H 'accept: application/json' \\\n -H 'authorization: Bearer API_TOKEN' \\\n -H 'content-type: application/json' \\\n -d '{\"data\": {\"domain\": \"google.com\", \"lang\": \"en\", \"q\": \"Coffee\", \"loc\": \"Texas,United States\", \"device\": \"desktop\", \"serp_type\": \"web\"}}'", "config": { "mcpServers": { "serphouse": { "url": "https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp" } } } }, "letme": { "capability": "https://letme.dev/search.serp", "tool": "https://letme.dev/serphouse" }, "area": "web-data", "unitPrices": [ { "item": "SERP request, Basic", "unit": "1k-requests", "usd": 0.75, "note": "$29.99 a month for 400,000 credits" }, { "item": "SERP request, Regular", "unit": "1k-requests", "usd": 0.62, "note": "$49.99 a month for 800,000 credits" }, { "item": "Autocomplete request, Basic", "unit": "1k-requests", "usd": 0.37, "note": "$0.31 on Regular" }, { "item": "Top 100 Google SERP, Basic", "unit": "1k-requests", "usd": 7.5, "note": "$6.25 on Regular" }, { "item": "Basic plan", "unit": "month", "usd": 29.99, "note": "400,000 credits, no rollover" }, { "item": "Regular plan", "unit": "month", "usd": 49.99, "note": "800,000 credits, no rollover" } ], "provenance": { "legalEntity": "Patoliya Infotech LLP", "domain": "serphouse.com", "domainRegistered": "2019-08-20", "endpointOnVendorDomain": true, "terms": "https://www.serphouse.com/terms-of-service", "privacy": "https://www.serphouse.com/privacy-policy", "statusPage": "", "changelog": "", "securityTxt": "none", "checked": "2026-11-06", "notes": [ "The terms name Patoliya Infotech LLP, a limited liability partnership incorporated in India, under Indian law with courts in Surat. The contact page gives an address in Utran, Surat, Gujarat.", "No effective or updated date was found on the terms or the privacy policy.", "www.serphouse.com/robots.txt allows all agents except /data/.", "The trial terms forbid 'scraping at scale or performing automated bulk data extraction' with trial credits. No clause on automated access to the website was found.", "/.well-known/security.txt answers 404. No status page is linked, and status.serphouse.com did not answer.", "RDAP gives serphouse.com a registration date of 20 August 2019; the about page says SERPHouse started in September 2019." ], "score": 61 }, "pageJsonUrl": "https://www.anchorterminal.com/tools/serphouse.json", "live": { "slug": "serphouse", "probe": { "target": "https://mcp.serphouse.com/YOUR_API_KEY/mcp", "method": "get", "lastAt": "2026-11-07T19:22:32.462161347Z", "lastOk": true, "lastStatus": 400, "lastMs": 260, "authRequired": false, "uptime24h": 100, "uptime30d": 100, "p50ms24h": 236, "p95ms24h": 348, "samples24h": 210, "samples30d": 210, "days": [ { "date": "2026-11-06", "probes": 13, "ok": 13 }, { "date": "2026-11-07", "probes": 197, "ok": 197 } ] }, "versions": [ { "registry": "github", "name": "SERPHouse/serphouse-mcp", "version": "1.1.0", "released": "2026-07-06", "seenAt": "2026-11-07T00:04:55.526969474Z" }, { "registry": "npm", "name": "serphouse-mcp", "version": "1.1.0", "seenAt": "2026-11-07T00:04:54.741719814Z" } ], "githubStars": 10, "npmWeekly": 11, "securityTxt": { "url": "https://serphouse.com/.well-known/security.txt", "state": "none", "checkedAt": "2026-11-07T15:59:39.38860304Z" }, "llmsTxt": { "url": "https://www.serphouse.com/llms.txt", "ok": true, "status": 200, "checkedAt": "2026-11-07T15:33:54.600324581Z" }, "pages": [ { "url": "https://www.serphouse.com/privacy-policy", "kind": "privacy", "status": 200, "checkedAt": "2026-11-07T14:34:21.531839335Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "85f9c0a9e291" }, { "url": "https://www.serphouse.com/terms-of-service", "kind": "terms", "status": 200, "checkedAt": "2026-11-07T14:34:24.703890347Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "171892dff54e" } ], "mcpTools": { "url": "https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp", "checkedAt": "2026-11-07T01:47:41.660458875Z", "status": "ok", "protocol": "2025-11-25", "tools": [ { "name": "serphouse_domain_list", "title": "Serphouse Domain List", "description": "List supported search domains. Call this before Yahoo searches — yahoo.com is not valid; use regional domains like uk.yahoo.com from this list.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": {}, "type": "object" } }, { "name": "serphouse_language_list", "title": "Serphouse Language List", "description": "Get supported language codes for google, bing, or yahoo.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "type": { "description": "Search engine language catalog to fetch.", "enum": [ "google", "bing", "yahoo" ], "type": "string" } }, "required": [ "type" ], "type": "object" } }, { "name": "serphouse_location_search", "title": "Serphouse Location Search", "description": "Search Serphouse location ids and location strings for Google or Bing targeting.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "q": { "description": "Location search term, for example texas or london.", "minLength": 1, "type": "string" }, "type": { "default": "google", "enum": [ "google", "bing" ], "type": "string" } }, "required": [ "q" ], "type": "object" } }, { "name": "serphouse_account_info", "title": "Serphouse Account Info", "description": "Get Serphouse account plan and credit usage.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": {}, "type": "object" } }, { "name": "serphouse_search", "title": "Serphouse Search", "description": "Default web search for agents — fast lightweight Google organic results via POST /web-search-lite. Only q is required; gl defaults to US. Use serphouse_google_web only when you need device, gfilter, or num_result. Use serphouse_serp_google_advanced for SEO rankings beyond top 10.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "date_range": { "description": "Optional date filter: YYYY-MM-DD,YYYY-MM-DD or one of h, d, w, m, y. Omit for general searches — lite results may be empty when this is set.", "minLength": 1, "type": "string" }, "domain": { "default": "google.com", "minLength": 1, "type": "string" }, "gl": { "description": "Two-letter ISO country code, e.g. US, IN, GB. Used when loc is omitted.", "minLength": 1, "pattern": "^[A-Za-z]{2}$", "type": "string" }, "lang": { "default": "en", "minLength": 1, "type": "string" }, "loc": { "description": "Location name, e.g. Austin,Texas,United States. Provide loc or gl, not both.", "minLength": 1, "type": "string" }, "no_trace": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" }, { "const": "true", "type": "string" }, { "const": "false", "type": "string" }, { "const": true, "type": "boolean" }, { "const": false, "type": "boolean" } ], "description": "Enterprise only. Enables NoTrace mode when set to 1 or true." }, "page": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "q": { "description": "Search phrase to query.", "minLength": 1, "type": "string" }, "verbatim": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" } ] } }, "required": [ "q" ], "type": "object" } }, { "name": "serphouse_google_web_lite", "title": "Serphouse Google Web Search (Lite)", "description": "Alias of serphouse_search — fast lightweight Google organic results via POST /web-search-lite. Prefer serphouse_search for general agent queries.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "date_range": { "description": "Optional date filter: YYYY-MM-DD,YYYY-MM-DD or one of h, d, w, m, y. Omit for general searches — lite results may be empty when this is set.", "minLength": 1, "type": "string" }, "domain": { "default": "google.com", "minLength": 1, "type": "string" }, "gl": { "description": "Two-letter ISO country code, e.g. US, IN, GB. Used when loc is omitted.", "minLength": 1, "pattern": "^[A-Za-z]{2}$", "type": "string" }, "lang": { "default": "en", "minLength": 1, "type": "string" }, "loc": { "description": "Location name, e.g. Austin,Texas,United States. Provide loc or gl, not both.", "minLength": 1, "type": "string" }, "no_trace": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" }, { "const": "true", "type": "string" }, { "const": "false", "type": "string" }, { "const": true, "type": "boolean" }, { "const": false, "type": "boolean" } ], "description": "Enterprise only. Enables NoTrace mode when set to 1 or true." }, "page": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "q": { "description": "Search phrase to query.", "minLength": 1, "type": "string" }, "verbatim": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" } ] } }, "required": [ "q" ], "type": "object" } }, { "name": "serphouse_google_web", "title": "Serphouse Google Web Search (Full)", "description": "Full Google web search via POST /google-web with device, gfilter, and num_result. Requires loc or loc_id. For general queries use serphouse_search instead.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "date_range": { "description": "Date range as YYYY-MM-DD,YYYY-MM-DD or one of h, d, w, m, y.", "minLength": 1, "type": "string" }, "device": { "default": "desktop", "enum": [ "desktop", "mobile" ], "type": "string" }, "domain": { "default": "google.com", "minLength": 1, "type": "string" }, "gfilter": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" } ] }, "lang": { "default": "en", "minLength": 1, "type": "string" }, "loc": { "description": "Required unless loc_id is provided. Location name, for example Austin,Texas,United States. Provide exactly one of loc or loc_id.", "minLength": 1, "type": "string" }, "loc_id": { "anyOf": [ { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, { "minLength": 1, "pattern": "^\\d+$", "type": "string" } ], "description": "Required unless loc is provided. Serphouse location id from serphouse_location_search. Provide exactly one of loc_id or loc." }, "no_trace": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" }, { "const": "true", "type": "string" }, { "const": "false", "type": "string" }, { "const": true, "type": "boolean" }, { "const": false, "type": "boolean" } ], "description": "Enterprise only. Enables NoTrace mode when set to 1 or true." }, "num_result": { "maximum": 10, "minimum": 1, "type": "integer" }, "page": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "q": { "description": "Search phrase to query.", "minLength": 1, "type": "string" }, "verbatim": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" } ] } }, "required": [ "q" ], "type": "object" } }, { "name": "serphouse_google_image", "title": "Serphouse Google Image Search", "description": "Run a realtime Google image search via POST /google-image.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "date_range": { "minLength": 1, "type": "string" }, "domain": { "default": "google.com", "minLength": 1, "type": "string" }, "lang": { "default": "en", "minLength": 1, "type": "string" }, "loc": { "description": "Required unless loc_id is provided. Location name, for example Austin,Texas,United States. Provide exactly one of loc or loc_id.", "minLength": 1, "type": "string" }, "loc_id": { "anyOf": [ { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, { "minLength": 1, "pattern": "^\\d+$", "type": "string" } ], "description": "Required unless loc is provided. Serphouse location id from serphouse_location_search. Provide exactly one of loc_id or loc." }, "no_trace": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" }, { "const": "true", "type": "string" }, { "const": "false", "type": "string" }, { "const": true, "type": "boolean" }, { "const": false, "type": "boolean" } ], "description": "Enterprise only. Enables NoTrace mode when set to 1 or true." }, "page": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "q": { "description": "Search phrase to query.", "minLength": 1, "type": "string" } }, "required": [ "q" ], "type": "object" } }, { "name": "serphouse_google_news", "title": "Serphouse Google News Search", "description": "Run a realtime Google news search via POST /google-news.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "date_range": { "minLength": 1, "type": "string" }, "device": { "default": "desktop", "enum": [ "desktop", "mobile" ], "type": "string" }, "domain": { "default": "google.com", "minLength": 1, "type": "string" }, "lang": { "default": "en", "minLength": 1, "type": "string" }, "loc": { "description": "Required unless loc_id is provided. Location name, for example Austin,Texas,United States. Provide exactly one of loc or loc_id.", "minLength": 1, "type": "string" }, "loc_id": { "anyOf": [ { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, { "minLength": 1, "pattern": "^\\d+$", "type": "string" } ], "description": "Required unless loc is provided. Serphouse location id from serphouse_location_search. Provide exactly one of loc_id or loc." }, "no_trace": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" }, { "const": "true", "type": "string" }, { "const": "false", "type": "string" }, { "const": true, "type": "boolean" }, { "const": false, "type": "boolean" } ], "description": "Enterprise only. Enables NoTrace mode when set to 1 or true." }, "page": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "q": { "description": "Search phrase to query.", "minLength": 1, "type": "string" } }, "required": [ "q" ], "type": "object" } }, { "name": "serphouse_google_shop", "title": "Serphouse Google Shop Search", "description": "Run a realtime Google shopping search via POST /google-shop.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "domain": { "default": "google.com", "minLength": 1, "type": "string" }, "lang": { "default": "en", "minLength": 1, "type": "string" }, "loc": { "description": "Required unless loc_id is provided. Location name, for example Austin,Texas,United States. Provide exactly one of loc or loc_id.", "minLength": 1, "type": "string" }, "loc_id": { "anyOf": [ { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, { "minLength": 1, "pattern": "^\\d+$", "type": "string" } ], "description": "Required unless loc is provided. Serphouse location id from serphouse_location_search. Provide exactly one of loc_id or loc." }, "no_trace": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" }, { "const": "true", "type": "string" }, { "const": "false", "type": "string" }, { "const": true, "type": "boolean" }, { "const": false, "type": "boolean" } ], "description": "Enterprise only. Enables NoTrace mode when set to 1 or true." }, "page": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "q": { "description": "Search phrase to query.", "minLength": 1, "type": "string" } }, "required": [ "q" ], "type": "object" } }, { "name": "serphouse_bing_web", "title": "Serphouse Bing Web Search", "description": "Run a realtime Bing web search via POST /bing-web.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "date_range": { "minLength": 1, "type": "string" }, "device": { "default": "desktop", "enum": [ "desktop", "mobile" ], "type": "string" }, "lang": { "default": "en-US", "description": "Language code, for example en-US or fr-FR.", "minLength": 1, "type": "string" }, "loc": { "description": "Required unless loc_id is provided. Location name, for example Austin,Texas,United States. Provide exactly one of loc or loc_id.", "minLength": 1, "type": "string" }, "loc_id": { "anyOf": [ { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, { "minLength": 1, "pattern": "^\\d+$", "type": "string" } ], "description": "Required unless loc is provided. Serphouse location id from serphouse_location_search. Provide exactly one of loc_id or loc." }, "no_trace": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" }, { "const": "true", "type": "string" }, { "const": "false", "type": "string" }, { "const": true, "type": "boolean" }, { "const": false, "type": "boolean" } ], "description": "Enterprise only. Enables NoTrace mode when set to 1 or true." }, "page": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "q": { "description": "Search phrase to query.", "minLength": 1, "type": "string" } }, "required": [ "q" ], "type": "object" } }, { "name": "serphouse_bing_image", "title": "Serphouse Bing Image Search", "description": "Run a realtime Bing image search via POST /bing-image.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "lang": { "default": "en-US", "minLength": 1, "type": "string" }, "loc": { "description": "Required unless loc_id is provided. Location name, for example Austin,Texas,United States. Provide exactly one of loc or loc_id.", "minLength": 1, "type": "string" }, "loc_id": { "anyOf": [ { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, { "minLength": 1, "pattern": "^\\d+$", "type": "string" } ], "description": "Required unless loc is provided. Serphouse location id from serphouse_location_search. Provide exactly one of loc_id or loc." }, "no_trace": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" }, { "const": "true", "type": "string" }, { "const": "false", "type": "string" }, { "const": true, "type": "boolean" }, { "const": false, "type": "boolean" } ], "description": "Enterprise only. Enables NoTrace mode when set to 1 or true." }, "page": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "q": { "description": "Search phrase to query.", "minLength": 1, "type": "string" } }, "required": [ "q" ], "type": "object" } }, { "name": "serphouse_bing_news", "title": "Serphouse Bing News Search", "description": "Run a realtime Bing news search via POST /bing-news.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "device": { "default": "desktop", "enum": [ "desktop", "mobile" ], "type": "string" }, "lang": { "default": "en-US", "minLength": 1, "type": "string" }, "loc": { "description": "Required unless loc_id is provided. Location name, for example Austin,Texas,United States. Provide exactly one of loc or loc_id.", "minLength": 1, "type": "string" }, "loc_id": { "anyOf": [ { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, { "minLength": 1, "pattern": "^\\d+$", "type": "string" } ], "description": "Required unless loc is provided. Serphouse location id from serphouse_location_search. Provide exactly one of loc_id or loc." }, "no_trace": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" }, { "const": "true", "type": "string" }, { "const": "false", "type": "string" }, { "const": true, "type": "boolean" }, { "const": false, "type": "boolean" } ], "description": "Enterprise only. Enables NoTrace mode when set to 1 or true." }, "page": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "q": { "description": "Search phrase to query.", "minLength": 1, "type": "string" } }, "required": [ "q" ], "type": "object" } }, { "name": "serphouse_yahoo_web", "title": "Serphouse Yahoo Web Search", "description": "Run a realtime Yahoo web search via POST /yahoo-web.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "device": { "default": "desktop", "enum": [ "desktop", "mobile" ], "type": "string" }, "domain": { "default": "uk.yahoo.com", "description": "Regional Yahoo domain from serphouse_domain_list, for example uk.yahoo.com or fr.yahoo.com. Do not use yahoo.com.", "minLength": 1, "type": "string" }, "lang": { "default": "lang_en", "description": "Yahoo language code, for example lang_en or lang_fr.", "minLength": 1, "type": "string" }, "no_trace": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" }, { "const": "true", "type": "string" }, { "const": "false", "type": "string" }, { "const": true, "type": "boolean" }, { "const": false, "type": "boolean" } ], "description": "Enterprise only. Enables NoTrace mode when set to 1 or true." }, "page": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "q": { "description": "Search phrase to query.", "minLength": 1, "type": "string" } }, "required": [ "q" ], "type": "object" } }, { "name": "serphouse_yahoo_image", "title": "Serphouse Yahoo Image Search", "description": "Run a realtime Yahoo image search via POST /yahoo-image.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "domain": { "default": "uk.yahoo.com", "description": "Regional Yahoo domain from serphouse_domain_list, for example uk.yahoo.com or fr.yahoo.com. Do not use yahoo.com.", "minLength": 1, "type": "string" }, "lang": { "default": "lang_en", "minLength": 1, "type": "string" }, "no_trace": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" }, { "const": "true", "type": "string" }, { "const": "false", "type": "string" }, { "const": true, "type": "boolean" }, { "const": false, "type": "boolean" } ], "description": "Enterprise only. Enables NoTrace mode when set to 1 or true." }, "page": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "q": { "description": "Search phrase to query.", "minLength": 1, "type": "string" } }, "required": [ "q" ], "type": "object" } }, { "name": "serphouse_yahoo_news", "title": "Serphouse Yahoo News Search", "description": "Run a realtime Yahoo news search via POST /yahoo-news.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "device": { "default": "desktop", "enum": [ "desktop", "mobile" ], "type": "string" }, "domain": { "default": "uk.yahoo.com", "description": "Regional Yahoo domain from serphouse_domain_list, for example uk.yahoo.com or fr.yahoo.com. Do not use yahoo.com.", "minLength": 1, "type": "string" }, "lang": { "default": "lang_en", "minLength": 1, "type": "string" }, "no_trace": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" }, { "const": "true", "type": "string" }, { "const": "false", "type": "string" }, { "const": true, "type": "boolean" }, { "const": false, "type": "boolean" } ], "description": "Enterprise only. Enables NoTrace mode when set to 1 or true." }, "page": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "q": { "description": "Search phrase to query.", "minLength": 1, "type": "string" } }, "required": [ "q" ], "type": "object" } }, { "name": "serphouse_serp_google_advanced", "title": "Serphouse Google Advanced SERP", "description": "SEO ranking checks: fetch up to 100 Google results in one request. Use max_pages 1–10 (~10 results per page). For general web search use serphouse_search; use this when rank position beyond the top 10 is needed.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "date_range": { "description": "Date range as YYYY-MM-DD,YYYY-MM-DD or one of h, d, w, m, y.", "minLength": 1, "type": "string" }, "device": { "default": "desktop", "enum": [ "desktop", "mobile" ], "type": "string" }, "domain": { "default": "google.com", "minLength": 1, "type": "string" }, "gfilter": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" } ] }, "lang": { "default": "en", "minLength": 1, "type": "string" }, "loc": { "description": "Required unless loc_id is provided. Location name, for example Austin,Texas,United States. Provide exactly one of loc or loc_id.", "minLength": 1, "type": "string" }, "loc_id": { "anyOf": [ { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, { "minLength": 1, "pattern": "^\\d+$", "type": "string" } ], "description": "Required unless loc is provided. Serphouse location id from serphouse_location_search. Provide exactly one of loc_id or loc." }, "max_pages": { "default": 10, "maximum": 10, "minimum": 1, "type": "integer" }, "page": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "q": { "description": "Search phrase to query.", "minLength": 1, "type": "string" }, "serp_type": { "default": "web", "enum": [ "web", "news", "image", "shop" ], "type": "string" }, "verbatim": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" } ] } }, "required": [ "q" ], "type": "object" } }, { "name": "serphouse_google_jobs", "title": "Serphouse Google Jobs", "description": "Run a realtime Google Jobs search.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "date_range": { "minLength": 1, "type": "string" }, "domain": { "default": "google.com", "minLength": 1, "type": "string" }, "lang": { "default": "en", "minLength": 1, "type": "string" }, "loc": { "description": "Required unless loc_id is provided. Location name, for example Austin,Texas,United States. Provide exactly one of loc or loc_id.", "minLength": 1, "type": "string" }, "loc_id": { "anyOf": [ { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, { "minLength": 1, "pattern": "^\\d+$", "type": "string" } ], "description": "Required unless loc is provided. Serphouse location id from serphouse_location_search. Provide exactly one of loc_id or loc." }, "q": { "minLength": 1, "type": "string" } }, "required": [ "q" ], "type": "object" } }, { "name": "serphouse_google_autocomplete", "title": "Serphouse Google Autocomplete", "description": "Get realtime localized Google autocomplete suggestions.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "client": { "default": "chrome", "enum": [ "chrome", "chrome-omni", "home_page", "safari", "firefox", "youtube" ], "type": "string" }, "lang": { "default": "en", "minLength": 1, "type": "string" }, "loc": { "description": "Location name used to localize suggestions.", "minLength": 1, "type": "string" }, "q": { "minLength": 1, "type": "string" } }, "required": [ "q", "loc" ], "type": "object" } }, { "name": "serphouse_google_videos", "title": "Serphouse Google Videos", "description": "Run a realtime Google Videos search with optional video filters.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "date_range": { "description": "Date range as YYYY-MM-DD,YYYY-MM-DD or one of h, d, w, m, y.", "minLength": 1, "type": "string" }, "device": { "default": "desktop", "enum": [ "desktop", "mobile" ], "type": "string" }, "domain": { "default": "google.com", "minLength": 1, "type": "string" }, "lang": { "default": "en", "minLength": 1, "type": "string" }, "loc": { "description": "Required unless loc_id is provided. Location name, for example Austin,Texas,United States. Provide exactly one of loc or loc_id.", "minLength": 1, "type": "string" }, "loc_id": { "anyOf": [ { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, { "minLength": 1, "pattern": "^\\d+$", "type": "string" } ], "description": "Required unless loc is provided. Serphouse location id from serphouse_location_search. Provide exactly one of loc_id or loc." }, "page": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "q": { "description": "Search phrase to query.", "minLength": 1, "type": "string" }, "video_captions": { "const": "captioned", "type": "string" }, "video_duration": { "enum": [ "short", "medium", "long" ], "type": "string" }, "video_quality": { "const": "high", "type": "string" } }, "required": [ "q" ], "type": "object" } }, { "name": "serphouse_google_short_videos", "title": "Serphouse Google Short Videos", "description": "Run a realtime Google Short Videos search.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "date_range": { "description": "Date range as YYYY-MM-DD,YYYY-MM-DD or one of h, d, w, m, y.", "minLength": 1, "type": "string" }, "device": { "default": "desktop", "enum": [ "desktop", "mobile" ], "type": "string" }, "domain": { "default": "google.com", "minLength": 1, "type": "string" }, "lang": { "default": "en", "minLength": 1, "type": "string" }, "loc": { "description": "Required unless loc_id is provided. Location name, for example Austin,Texas,United States. Provide exactly one of loc or loc_id.", "minLength": 1, "type": "string" }, "loc_id": { "anyOf": [ { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, { "minLength": 1, "pattern": "^\\d+$", "type": "string" } ], "description": "Required unless loc is provided. Serphouse location id from serphouse_location_search. Provide exactly one of loc_id or loc." }, "page": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "q": { "description": "Search phrase to query.", "minLength": 1, "type": "string" }, "video_captions": { "const": "captioned", "type": "string" }, "video_quality": { "const": "high", "type": "string" } }, "required": [ "q" ], "type": "object" } }, { "name": "serphouse_google_forums", "title": "Serphouse Google Forums", "description": "Run a realtime Google Forums search for discussions and community results.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "date_range": { "description": "Date range as YYYY-MM-DD,YYYY-MM-DD or one of h, d, w, m, y.", "minLength": 1, "type": "string" }, "device": { "default": "desktop", "enum": [ "desktop", "mobile" ], "type": "string" }, "domain": { "default": "google.com", "minLength": 1, "type": "string" }, "lang": { "default": "en", "minLength": 1, "type": "string" }, "loc": { "description": "Required unless loc_id is provided. Location name, for example Austin,Texas,United States. Provide exactly one of loc or loc_id.", "minLength": 1, "type": "string" }, "loc_id": { "anyOf": [ { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, { "minLength": 1, "pattern": "^\\d+$", "type": "string" } ], "description": "Required unless loc is provided. Serphouse location id from serphouse_location_search. Provide exactly one of loc_id or loc." }, "page": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "q": { "description": "Search phrase to query.", "minLength": 1, "type": "string" }, "verbatim": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": "0", "type": "string" }, { "const": "1", "type": "string" } ] } }, "required": [ "q" ], "type": "object" } }, { "name": "serphouse_google_local", "title": "Serphouse Google Local", "description": "Run a realtime Google Local search for local business results.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "domain": { "default": "google.com", "minLength": 1, "type": "string" }, "lang": { "default": "en", "minLength": 1, "type": "string" }, "loc": { "description": "Required unless loc_id is provided. Location name, for example Austin,Texas,United States. Provide exactly one of loc or loc_id.", "minLength": 1, "type": "string" }, "loc_id": { "anyOf": [ { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, { "minLength": 1, "pattern": "^\\d+$", "type": "string" } ], "description": "Required unless loc is provided. Serphouse location id from serphouse_location_search. Provide exactly one of loc_id or loc." }, "page": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "q": { "minLength": 1, "type": "string" } }, "required": [ "q" ], "type": "object" } } ], "schemaTokens": 6824, "changedAt": "2026-11-07T01:47:41.660458875Z", "check": { "checker": "anchor-check/1.0", "totalTokens": 6824, "counts": { "error": 0, "note": 1, "warn": 43 }, "findings": [ { "rule": "TC11", "severity": "warn", "tool": "serphouse_bing_image", "message": "2 parameters without a description: lang, page", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_bing_news", "message": "3 parameters without a description: device, lang, page", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_bing_web", "message": "3 parameters without a description: date_range, device, page", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_google_autocomplete", "message": "3 parameters without a description: client, lang, q", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_google_forums", "message": "5 parameters without a description: device, domain, lang, page, verbatim", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_google_image", "message": "4 parameters without a description: date_range, domain, lang, page", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_google_jobs", "message": "4 parameters without a description: date_range, domain, lang, q", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_google_local", "message": "4 parameters without a description: domain, lang, page, q", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_google_news", "message": "5 parameters without a description: date_range, device, domain, lang, page", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_google_shop", "message": "3 parameters without a description: domain, lang, page", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_google_short_videos", "message": "6 parameters without a description: device, domain, lang, page, video_captions, video_quality", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_google_videos", "message": "7 parameters without a description: device, domain, lang, page, video_captions, video_duration and 1 more", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_google_web", "message": "7 parameters without a description: device, domain, gfilter, lang, num_result, page and 1 more", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_google_web_lite", "message": "4 parameters without a description: domain, lang, page, verbatim", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_location_search", "message": "1 parameter without a description: type", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_search", "message": "4 parameters without a description: domain, lang, page, verbatim", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_serp_google_advanced", "message": "8 parameters without a description: device, domain, gfilter, lang, max_pages, page and 2 more", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_yahoo_image", "message": "2 parameters without a description: lang, page", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_yahoo_news", "message": "3 parameters without a description: device, lang, page", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "serphouse_yahoo_web", "message": "2 parameters without a description: device, page", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_account_info", "message": "no readOnlyHint or destructiveHint", "fix": "Its name starts with \"info\"; if it only reads, set readOnlyHint: true so harnesses can run it without asking." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_bing_image", "message": "no readOnlyHint or destructiveHint", "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_bing_news", "message": "no readOnlyHint or destructiveHint", "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_bing_web", "message": "no readOnlyHint or destructiveHint", "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_domain_list", "message": "no readOnlyHint or destructiveHint", "fix": "Its name starts with \"list\"; if it only reads, set readOnlyHint: true so harnesses can run it without asking." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_google_autocomplete", "message": "no readOnlyHint or destructiveHint", "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_google_forums", "message": "no readOnlyHint or destructiveHint", "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_google_image", "message": "no readOnlyHint or destructiveHint", "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_google_jobs", "message": "no readOnlyHint or destructiveHint", "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_google_local", "message": "no readOnlyHint or destructiveHint", "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_google_news", "message": "no readOnlyHint or destructiveHint", "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_google_shop", "message": "no readOnlyHint or destructiveHint", "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_google_short_videos", "message": "no readOnlyHint or destructiveHint", "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_google_videos", "message": "no readOnlyHint or destructiveHint", "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_google_web", "message": "no readOnlyHint or destructiveHint", "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_google_web_lite", "message": "no readOnlyHint or destructiveHint", "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_language_list", "message": "no readOnlyHint or destructiveHint", "fix": "Its name starts with \"list\"; if it only reads, set readOnlyHint: true so harnesses can run it without asking." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_location_search", "message": "no readOnlyHint or destructiveHint", "fix": "Its name starts with \"search\"; if it only reads, set readOnlyHint: true so harnesses can run it without asking." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_search", "message": "no readOnlyHint or destructiveHint", "fix": "Its name starts with \"search\"; if it only reads, set readOnlyHint: true so harnesses can run it without asking." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_serp_google_advanced", "message": "no readOnlyHint or destructiveHint", "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_yahoo_image", "message": "no readOnlyHint or destructiveHint", "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_yahoo_news", "message": "no readOnlyHint or destructiveHint", "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint." }, { "rule": "TC16", "severity": "warn", "tool": "serphouse_yahoo_web", "message": "no readOnlyHint or destructiveHint", "fix": "Set readOnlyHint: true if it only reads; otherwise set destructiveHint and idempotentHint." }, { "rule": "TC24", "severity": "note", "message": "23 of 23 tools have no outputSchema", "fix": "Declare outputSchema for tools that return structured data, and return structuredContent that matches it." } ] } }, "updatedAt": "2026-11-07T19:22:32.462161347Z" } }, "edges": [ { "by": 59, "category": "maintenance", "leads": "perplexity-search-api", "name": "Maintenance \u0026 community", "reasons": { "a": "Read as a closed service with official SDKs and an open-source MCP server. perplexityai 0.46.1 on PyPI on 23 October 2026 and the MCP server's last commit on 21 October, with changelog entries into November 2026 (30). In the 90 days from 8 August, perplexityai 0.43.7 to 0.46.1 (six releases from 2 October), MCP server 1.2.1 (27 August) and 1.3.0 (25 September, Fast Search on perplexity_search), and Fast Search itself in September (20). A changelog with several entries a month, a community forum with a bug-report category, a GitHub discussion repository and api@perplexity.ai. MCP issue reply times weren't read (10 of 15). The MCP server is in the official registry under the domain-verified ai.perplexity namespace, and the Python and TypeScript SDKs are current (15). The MCP repository runs tests in CI and validates its plugin manifests. Its 1.4.0, prepared on 16 October, is not on npm, which still serves 1.3.0, and the registry's latest entry is 1.2.1 of 27 August (7 of 10). 30 + 20 + 10 + 15 + 7 = 82.", "b": "Read for a closed service, with its repositories read as code. No changelog or dated API change was found. The newest release is MCP server 1.1.0 on 6 July 2026, 123 days before 6 November, and the last commit in its repository was on 22 July (10). No release or dated change in the 90 days from 8 August; the about page's 2026 entry (Forums, Place Details and Scraper APIs) is undated (0). No changelog; support by email. Issues weren't read, since the GitHub API refused us for its rate limit (5 of 25). Not in the official MCP registry, though the repository's server.json names io.github.SERPHouse/serphouse-mcp. Node.js SDK last changed 24 June 2026, PHP SDK 10 May 2024, and no Python SDK repository was found under the SERPHouse organisation (5 of 15). The MCP repository has an npm publish workflow and no tests (3 of 10). 10 + 0 + 5 + 5 + 3 = 23." }, "scores": { "a": 82, "b": 23 } }, { "by": 45, "category": "security", "leads": "perplexity-search-api", "name": "Security \u0026 auth", "reasons": { "a": "Project API keys, shown once, revocable, and generated and revoked through two documented endpoints with a rotation guide. No per-key scopes or spending limits were found. The hosted MCP server also takes Sign in with Perplexity (OAuth). Keys go in the Authorization header only (22 of 30, as on the Decisions API listing). Search only reads, and MCP clients can disable tools, but any key reaches every API on the account, including the Agent API's sandbox and MCP tools (8 of 20). Snippets are third-party page text, and no guidance on treating them as untrusted was found in the docs, the MCP server or its SECURITY.md (0 of 15). Responses carry a request `id`, and the console shows usage by key. The Audit API covers enterprise organisations' web app events with its own keys, not API calls (8 of 15). security.txt valid until 31 December 2027 linking a security page, a SOC 2 Type II report, a 2025 HIPAA gap assessment and a CAIQlite listed on the trust centre, and a SECURITY.md on the MCP server that takes private reports through GitHub advisories or security@perplexity.ai. The trust centre is drawn by script and wasn't read (18 of 20). 22 + 8 + 0 + 8 + 18 = 56.", "b": "One key per account, one account per user, no scopes or rotation found (10). The REST API documents `api_token` in the query string and the hosted MCP server takes the key only in its URL path, less 10 (0 of 30). Searches only read, with no read-only or restricted key (8 of 20). Results are third-party snippets and AI Overview text, with no prompt-injection guidance (0). An account tool shows plan and credit usage; no per-call log was found (3 of 15). No security.txt (404), disclosure policy, bug bounty or certification found (0 of 20). 0 + 8 + 0 + 3 + 0 = 11." }, "scores": { "a": 56, "b": 11 } }, { "by": 40, "category": "reliability", "leads": "perplexity-search-api", "name": "Reliability", "reasons": { "a": "Graded on the hosted lines, for `POST /search` and the hosted MCP server. status.perplexity.com, on incident.io since 10 September 2026, has an API component with an RSS feed and a JSON summary. There is no separate Search component (20). In the 90 days from 8 August the feed lists 'Investigating API issue' on 13 August, resolved with no detail, a usage-based billing issue on 3 September, and on 9 October elevated errors on the website, app and Computer, where the API 'remained operational throughout'. Minor only, with the caveat that history before the migration may be incomplete (20). The Search API is limited to 50 query units a second with a burst of 50 on every tier, and the other APIs publish QPS and token limits per tier (15). 429 carries Retry-After and an `error.type`, the SDKs retry 429 and 5xx twice honouring Retry-After, the Search best-practices page shows backoff, and failed or rate-limited searches are not billed. Searches have no side effects (15). The FAQ says Perplexity does not guarantee uptime, failure frequency or recovery time, and the terms carry no SLA (0). No beta label on the Search API, launched on 25 September 2025 (10). 20 + 20 + 15 + 15 + 0 + 10 = 80.", "b": "Read with the hosted lines. No status page is linked from the site or docs, and status.serphouse.com did not answer on 6 November 2026 (0). No readable incident history (5). Rate limits published, 60 requests a minute and 60 concurrent on every self-serve plan (15). 429 is documented as 'slow down', and a 200 can carry `\"status\": \"error\"` with 'Please try again', with no Retry-After or backoff guidance. Failed requests aren't charged (5 of 15). The pricing page lists a 99.99% uptime SLA on Basic and Regular and the docs a 99.95% one, but no SLA terms or credits were found in the terms (5 of 10). Generally available (10). 0 + 5 + 15 + 5 + 5 + 10 = 40." }, "scores": { "a": 80, "b": 40 } }, { "by": 23, "category": "schema", "leads": "perplexity-search-api", "name": "Schema \u0026 documentation", "reasons": { "a": "OpenAPI 3.1.0 at docs.perplexity.ai/openapi.json describes `POST /search` with typed request and response schemas, listed in llms.txt (25). llms.txt indexes every page, each with a Markdown twin (10). The overview says what a result holds, that snippets can be empty, when to use the Search API instead of the Agent API, and that it takes queries not URLs and does not re-fetch pages (19 of 20). `search_type` is an enum, `max_results`, `max_tokens` and `max_tokens_per_page` carry minimum and maximum, country and language codes carry lengths, and `query` is a string or an array. The recency filter is an enum in the docs, and date filters are `MM/DD/YYYY` strings (14 of 15). Python, TypeScript and cURL examples with a recorded response. The spec documents only 200 and 422 for `/search`, and status codes are listed on the SDK error-handling page and the rate-limit page rather than for Search (11 of 15). A public changelog with several entries a month, dated by month only, and an unversioned `/search` path (10 of 15). 25 + 10 + 19 + 14 + 11 + 10 = 89.", "b": "No OpenAPI or similar contract for the REST API. The MCP server's tools carry typed Zod schemas, published in the source and a static server card (18 of 25). llms.txt at the site and the docs, and every docs page as Markdown (10). MCP tool descriptions say which tool to use for what, such as `serphouse_google_web` when device or `num_result` is needed, while the docs pages lead with marketing lines such as 'Unlock captivating Google video content' (12 of 20). Enums for device, SERP type, engine and video duration, defaults and 37 described parameters (11 of 15). A status code table and request examples per engine, with a generic error body (12 of 15). No changelog or API versioning; only the MCP server has tags (3 of 15). 18 + 10 + 12 + 11 + 12 + 3 = 66." }, "scores": { "a": 89, "b": 66 } }, { "by": 21, "category": "ergonomics", "leads": "perplexity-search-api", "name": "Agent ergonomics", "reasons": { "a": "`max_results` 1 to 20, `max_tokens` and `max_tokens_per_page` cap the extracted text, and results are title, url, snippet and two dates. The MCP server has four tools (23 of 25). Domain, language, recency, publication and update date filters and `country`, with up to five queries in one request. No pagination or offset (16 of 20). 429 bodies name the limit hit, the SDKs map status codes to typed errors, and 402 marks an empty balance. Search-specific error bodies beyond 422 validation are not documented (13 of 20). Searches only read, failed and rate-limited requests are not billed, and the MCP server sets readOnlyHint true, destructiveHint false and idempotentHint false on every tool (18 of 20). Only `query` is required. Official Python and TypeScript SDKs, a CLI and a Python Search SDK (15). 23 + 16 + 13 + 18 + 15 = 85.", "b": "23 MCP tools with no toolsets or filtering (15 of 25). `num_result`, `max_pages`, paging, device, location, language, date and video filters (16 of 20). Status codes are tabulated, but a 200 can also mean an error and the body carries only 'Please try again' (10 of 20). Searches only read and failed requests aren't charged, but the MCP tools carry no readOnlyHint or other annotations (10 of 20). `serphouse_search` needs only `q` and defaults to the US; most other tools need `loc` or `loc_id`. Official Node.js, PHP and Python SDKs are documented (13 of 15). 15 + 16 + 10 + 10 + 13 = 64." }, "scores": { "a": 85, "b": 64 } }, { "by": 16, "category": "transparency", "leads": "perplexity-search-api", "name": "Transparency \u0026 trust", "reasons": { "a": "Closed service under terms naming Perplexity AI, Inc. and California law. The MCP server is MIT and the SDKs Apache-2.0 (18 of 30). The terms and DPA say Customer Content and personal data don't train Perplexity's models, the DPA deletes personal data within 30 days of the service ending, and the Privacy and Security page says retention varies by API and zero data retention is not the default. The DPA also says Perplexity Search may follow different data terms, which weren't found, and no retention period for search queries is stated (15 of 30). Sonar Chat Completions support ended on 27 September 2026 with a migration guide and requests reformulated rather than refused, and sonar-reasoning was removed on 15 December 2025 with a named replacement. Notices are dated by month and there is no standing notice period beyond the terms' 30 days for termination (10 of 20). A sub-processor list on the trust centre, which is drawn by script and wasn't read, ten business days' notice of new non-model subprocessors, and SCCs for EU and UK transfers. No data location is stated (8 of 20). 18 + 15 + 10 + 8 = 51.", "b": "Closed service under terms naming Patoliya Infotech LLP in India, and the MCP server is MIT (18 of 30). The terms give retention periods (JSON results up to 6 months, HTML up to 1 month, search history indefinitely) and say personal data sits on DigitalOcean in India, and they advise EEA users not to use the service. The privacy policy is generic and neither document carries a date (15 of 30). No deprecation policy, and the terms allow products to be discontinued without notice (0 of 20). DigitalOcean in India named for account data; no sub-processor list (6 of 20). 18 + 15 + 0 + 6 = 39." }, "scores": { "a": 66, "b": 50 } } ], "facts": [ { "a": "HTTP API", "b": "HTTP API", "name": "Kind" }, { "a": "Perplexity", "b": "Patoliya Infotech LLP", "name": "Vendor" }, { "a": "https://api.perplexity.ai/mcp", "b": "https://mcp.serphouse.com/YOUR_API_KEY/mcp", "name": "Hosted endpoint" }, { "a": "Streamable HTTP, stdio", "b": "Streamable HTTP, stdio", "name": "Transports" }, { "a": "OAuth or key", "b": "API key", "name": "Auth" }, { "a": "Pay per use", "b": "Paid", "name": "Pricing" }, { "a": "$2.50 per 1,000 tool calls", "b": "not published", "name": "Price for web search" }, { "a": "no", "b": "no", "name": "x402" }, { "a": "Proprietary service under the Perplexity API Terms of Service. The MCP server is MIT and the official SDKs Apache-2.0", "b": "none", "name": "Licence" }, { "a": "4", "b": "23", "name": "Tools exposed" }, { "a": "no", "b": "no", "name": "Read-only variant documented" }, { "a": "yes", "b": "yes", "name": "llms.txt" }, { "a": "ai.perplexity/mcp-server", "b": "not listed", "name": "MCP registry" }, { "a": "2026-10-23", "b": "2026-07-06", "name": "Last release" }, { "a": "couldn't be read", "b": "no date given", "name": "Terms last updated" }, { "a": "couldn't be read", "b": "no date given", "name": "Privacy policy last updated" }, { "a": "couldn't be read", "b": "not found in the text", "name": "Customer content may train models" }, { "a": "couldn't be read", "b": "yes", "name": "Terms restrict automated access" }, { "a": "couldn't be read", "b": "not found in the text", "name": "Terms restrict benchmarking" }, { "a": "couldn't be read", "b": "yes", "name": "Terms or service can change without notice" }, { "a": "couldn't be read", "b": "not found in the text", "name": "Arbitration or class-action waiver" } ], "faq": [ { "answer": "Perplexity Search API scores 70.2 (BB) on agent readiness against SERPHouse's 42.4 (E), and leads in 6 of 7 scored categories. SERPHouse leads on payments \u0026 pricing.", "question": "Which is better for AI agents, Perplexity Search API or SERPHouse?" }, { "answer": "Perplexity Search API takes an API key or an OAuth sign-in. SERPHouse needs an API key.", "question": "Do Perplexity Search API and SERPHouse need an API key?" }, { "answer": "Yes. Perplexity Search API has a hosted endpoint at https://api.perplexity.ai/mcp and SERPHouse at https://mcp.serphouse.com/YOUR_API_KEY/mcp.", "question": "Can an agent call Perplexity Search API and SERPHouse without installing anything?" } ], "goodFor": [ { "aheadOn": [ "Reliability, 80 against 40", "Schema \u0026 documentation, 89 against 66", "Agent ergonomics, 85 against 64", "Security \u0026 auth, 56 against 11", "Maintenance \u0026 community, 82 against 23", "Transparency \u0026 trust, 66 against 50" ], "also": [ "Agent-ready, a grade of BB or better" ], "goodFor": "Agents on any model that need raw ranked sources with extracted text at a low per-request price, and teams that want cited answers from the same key through the Agent API.", "slug": "perplexity-search-api", "watchFor": "The FAQ says uptime and recovery time are not guaranteed, and the terms carry no SLA" }, { "aheadOn": [ "Payments \u0026 pricing, 40 against 25" ], "also": [ "Free to start without a card" ], "goodFor": "Low-cost Google, Bing and Yahoo result parsing for SEO and rank tracking, with many Google verticals.", "slug": "serphouse", "watchFor": "The hosted MCP server takes the API key only in its URL path, and the REST API also accepts `api_token` in the query string" } ], "history": null, "job": { "capability": "web.search", "name": "Web search" }, "others": [ { "json": "https://www.anchorterminal.com/compare/agentcore-web-search-vs-perplexity-search-api.json", "title": "Web Search Tool on Amazon Bedrock AgentCore vs Perplexity Search API", "url": "https://www.anchorterminal.com/compare/agentcore-web-search-vs-perplexity-search-api" }, { "json": "https://www.anchorterminal.com/compare/agentcore-web-search-vs-serphouse.json", "title": "Web Search Tool on Amazon Bedrock AgentCore vs SERPHouse", "url": "https://www.anchorterminal.com/compare/agentcore-web-search-vs-serphouse" }, { "json": "https://www.anchorterminal.com/compare/bing-grounding-vs-perplexity-search-api.json", "title": "Grounding with Bing Search vs Perplexity Search API", "url": "https://www.anchorterminal.com/compare/bing-grounding-vs-perplexity-search-api" }, { "json": "https://www.anchorterminal.com/compare/bing-grounding-vs-serphouse.json", "title": "Grounding with Bing Search vs SERPHouse", "url": "https://www.anchorterminal.com/compare/bing-grounding-vs-serphouse" }, { "json": "https://www.anchorterminal.com/compare/brave-search-mcp-vs-perplexity-search-api.json", "title": "Brave Search API + MCP vs Perplexity Search API", "url": "https://www.anchorterminal.com/compare/brave-search-mcp-vs-perplexity-search-api" }, { "json": "https://www.anchorterminal.com/compare/brave-search-mcp-vs-serphouse.json", "title": "Brave Search API + MCP vs SERPHouse", "url": "https://www.anchorterminal.com/compare/brave-search-mcp-vs-serphouse" }, { "json": "https://www.anchorterminal.com/compare/cloudflare-web-search-vs-perplexity-search-api.json", "title": "Cloudflare Web Search API vs Perplexity Search API", "url": "https://www.anchorterminal.com/compare/cloudflare-web-search-vs-perplexity-search-api" }, { "json": "https://www.anchorterminal.com/compare/cloudflare-web-search-vs-serphouse.json", "title": "Cloudflare Web Search API vs SERPHouse", "url": "https://www.anchorterminal.com/compare/cloudflare-web-search-vs-serphouse" }, { "json": "https://www.anchorterminal.com/compare/deepseek-search-api-vs-perplexity-search-api.json", "title": "DeepSeek Search and Fetch API vs Perplexity Search API", "url": "https://www.anchorterminal.com/compare/deepseek-search-api-vs-perplexity-search-api" }, { "json": "https://www.anchorterminal.com/compare/deepseek-search-api-vs-serphouse.json", "title": "DeepSeek Search and Fetch API vs SERPHouse", "url": "https://www.anchorterminal.com/compare/deepseek-search-api-vs-serphouse" }, { "json": "https://www.anchorterminal.com/compare/exa-mcp-vs-perplexity-search-api.json", "title": "Exa API + MCP vs Perplexity Search API", "url": "https://www.anchorterminal.com/compare/exa-mcp-vs-perplexity-search-api" }, { "json": "https://www.anchorterminal.com/compare/exa-mcp-vs-serphouse.json", "title": "Exa API + MCP vs SERPHouse", "url": "https://www.anchorterminal.com/compare/exa-mcp-vs-serphouse" }, { "json": "https://www.anchorterminal.com/compare/firecrawl-mcp-vs-perplexity-search-api.json", "title": "Firecrawl MCP vs Perplexity Search API", "url": "https://www.anchorterminal.com/compare/firecrawl-mcp-vs-perplexity-search-api" }, { "json": "https://www.anchorterminal.com/compare/kagi-search-vs-perplexity-search-api.json", "title": "Kagi Search API vs Perplexity Search API", "url": "https://www.anchorterminal.com/compare/kagi-search-vs-perplexity-search-api" }, { "json": "https://www.anchorterminal.com/compare/kagi-search-vs-serphouse.json", "title": "Kagi Search API vs SERPHouse", "url": "https://www.anchorterminal.com/compare/kagi-search-vs-serphouse" }, { "json": "https://www.anchorterminal.com/compare/linkup-vs-perplexity-search-api.json", "title": "Linkup vs Perplexity Search API", "url": "https://www.anchorterminal.com/compare/linkup-vs-perplexity-search-api" }, { "json": "https://www.anchorterminal.com/compare/linkup-vs-serphouse.json", "title": "Linkup vs SERPHouse", "url": "https://www.anchorterminal.com/compare/linkup-vs-serphouse" }, { "json": "https://www.anchorterminal.com/compare/mojeek-vs-perplexity-search-api.json", "title": "Mojeek Web Search API vs Perplexity Search API", "url": "https://www.anchorterminal.com/compare/mojeek-vs-perplexity-search-api" }, { "json": "https://www.anchorterminal.com/compare/mojeek-vs-serphouse.json", "title": "Mojeek Web Search API vs SERPHouse", "url": "https://www.anchorterminal.com/compare/mojeek-vs-serphouse" }, { "json": "https://www.anchorterminal.com/compare/newscatcher-vs-perplexity-search-api.json", "title": "NewsCatcher vs Perplexity Search API", "url": "https://www.anchorterminal.com/compare/newscatcher-vs-perplexity-search-api" }, { "json": "https://www.anchorterminal.com/compare/parallel-search-api-vs-perplexity-search-api.json", "title": "Parallel Search and Task APIs vs Perplexity Search API", "url": "https://www.anchorterminal.com/compare/parallel-search-api-vs-perplexity-search-api" }, { "json": "https://www.anchorterminal.com/compare/parallel-search-api-vs-serphouse.json", "title": "Parallel Search and Task APIs vs SERPHouse", "url": "https://www.anchorterminal.com/compare/parallel-search-api-vs-serphouse" }, { "json": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-searchapi-io.json", "title": "Perplexity Search API vs SearchAPI.io", "url": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-searchapi-io" }, { "json": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-serpapi.json", "title": "Perplexity Search API vs SerpApi", "url": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-serpapi" }, { "json": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-serper.json", "title": "Perplexity Search API vs Serper", "url": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-serper" }, { "json": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-serpkite.json", "title": "Perplexity Search API vs SerpKite", "url": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-serpkite" }, { "json": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-specstream.json", "title": "Perplexity Search API vs SpecStream", "url": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-specstream" }, { "json": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-tavily-mcp.json", "title": "Perplexity Search API vs Tavily API + MCP", "url": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-tavily-mcp" }, { "json": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-tinyfish-search.json", "title": "Perplexity Search API vs TinyFish Search", "url": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-tinyfish-search" }, { "json": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-valyu.json", "title": "Perplexity Search API vs Valyu", "url": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-valyu" }, { "json": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-you-com-api.json", "title": "Perplexity Search API vs You.com APIs", "url": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-you-com-api" }, { "json": "https://www.anchorterminal.com/compare/searchapi-io-vs-serphouse.json", "title": "SearchAPI.io vs SERPHouse", "url": "https://www.anchorterminal.com/compare/searchapi-io-vs-serphouse" }, { "json": "https://www.anchorterminal.com/compare/serpapi-vs-serphouse.json", "title": "SerpApi vs SERPHouse", "url": "https://www.anchorterminal.com/compare/serpapi-vs-serphouse" }, { "json": "https://www.anchorterminal.com/compare/serper-vs-serphouse.json", "title": "Serper vs SERPHouse", "url": "https://www.anchorterminal.com/compare/serper-vs-serphouse" }, { "json": "https://www.anchorterminal.com/compare/serphouse-vs-specstream.json", "title": "SERPHouse vs SpecStream", "url": "https://www.anchorterminal.com/compare/serphouse-vs-specstream" }, { "json": "https://www.anchorterminal.com/compare/serphouse-vs-tavily-mcp.json", "title": "SERPHouse vs Tavily API + MCP", "url": "https://www.anchorterminal.com/compare/serphouse-vs-tavily-mcp" }, { "json": "https://www.anchorterminal.com/compare/serphouse-vs-tinyfish-search.json", "title": "SERPHouse vs TinyFish Search", "url": "https://www.anchorterminal.com/compare/serphouse-vs-tinyfish-search" }, { "json": "https://www.anchorterminal.com/compare/serphouse-vs-valyu.json", "title": "SERPHouse vs Valyu", "url": "https://www.anchorterminal.com/compare/serphouse-vs-valyu" }, { "json": "https://www.anchorterminal.com/compare/serphouse-vs-you-com-api.json", "title": "SERPHouse vs You.com APIs", "url": "https://www.anchorterminal.com/compare/serphouse-vs-you-com-api" }, { "json": "https://www.anchorterminal.com/compare/arcmira-vs-perplexity-search-api.json", "title": "Arcmira vs Perplexity Search API", "url": "https://www.anchorterminal.com/compare/arcmira-vs-perplexity-search-api" }, { "json": "https://www.anchorterminal.com/compare/grep-ai-vs-perplexity-search-api.json", "title": "Grep AI vs Perplexity Search API", "url": "https://www.anchorterminal.com/compare/grep-ai-vs-perplexity-search-api" }, { "json": "https://www.anchorterminal.com/compare/liner-mcp-vs-perplexity-search-api.json", "title": "Liner Search MCP vs Perplexity Search API", "url": "https://www.anchorterminal.com/compare/liner-mcp-vs-perplexity-search-api" }, { "json": "https://www.anchorterminal.com/compare/fetch-reference-server-vs-serphouse.json", "title": "Fetch (MCP reference server) vs SERPHouse", "url": "https://www.anchorterminal.com/compare/fetch-reference-server-vs-serphouse" }, { "json": "https://www.anchorterminal.com/compare/newscatcher-vs-serphouse.json", "title": "NewsCatcher vs SERPHouse", "url": "https://www.anchorterminal.com/compare/newscatcher-vs-serphouse" }, { "json": "https://www.anchorterminal.com/compare/liner-mcp-vs-serphouse.json", "title": "Liner Search MCP vs SERPHouse", "url": "https://www.anchorterminal.com/compare/liner-mcp-vs-serphouse" }, { "json": "https://www.anchorterminal.com/compare/serphouse-vs-serpkite.json", "title": "SERPHouse vs SerpKite", "url": "https://www.anchorterminal.com/compare/serphouse-vs-serpkite" } ], "panel": null, "scores": [ { "by": 40, "edge": "perplexity-search-api", "key": "reliability", "name": "Reliability", "perplexity-search-api": 80, "serphouse": 40, "weight": 16 }, { "key": "performance", "name": "Performance", "pending": true, "weight": 10 }, { "by": 23, "edge": "perplexity-search-api", "key": "schema", "name": "Schema \u0026 documentation", "perplexity-search-api": 89, "serphouse": 66, "weight": 13 }, { "by": 21, "edge": "perplexity-search-api", "key": "ergonomics", "name": "Agent ergonomics", "perplexity-search-api": 85, "serphouse": 64, "weight": 13 }, { "by": 45, "edge": "perplexity-search-api", "key": "security", "name": "Security \u0026 auth", "perplexity-search-api": 56, "serphouse": 11, "weight": 14 }, { "by": 15, "edge": "serphouse", "key": "payments", "name": "Payments \u0026 pricing", "perplexity-search-api": 25, "serphouse": 40, "weight": 10 }, { "key": "tasks", "name": "Task success", "pending": true, "weight": 10 }, { "by": 59, "edge": "perplexity-search-api", "key": "maintenance", "name": "Maintenance \u0026 community", "perplexity-search-api": 82, "serphouse": 23, "weight": 7 }, { "by": 16, "edge": "perplexity-search-api", "key": "transparency", "name": "Transparency \u0026 trust", "perplexity-search-api": 66, "serphouse": 50, "weight": 7 } ], "summary": "Perplexity Search API scores 70.2 (BB) on agent readiness against SERPHouse's 42.4 (E), and leads in 6 of 7 scored categories. SERPHouse leads on payments \u0026 pricing. Both do web search.", "tasks": null, "tutorials": [], "verdicts": { "perplexity-search-api": "Raw ranked results with token-capped page text from Perplexity's own index, $5 per 1,000 requests or $1 with Fast Search, an OpenAPI description and a hosted MCP server with read-only annotations. Uptime is not guaranteed, there is no free allowance, keys carry no scopes, and no guidance on untrusted page text was found.", "serphouse": "SERPHouse returns parsed Google, Bing and Yahoo results at published prices from $0.62 per 1,000 requests, with a 23-tool MCP server and a 4,000-credit trial without a card. The hosted MCP puts the key in its URL, there is no status page, changelog or security contact, and the terms keep search history indefinitely." } }, "kind": "anchor.page", "links": { "api": "https://www.anchorterminal.com/api/v1/index.json", "html": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-serphouse", "json": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-serphouse.json", "llms": "https://www.anchorterminal.com/llms.txt", "markdown": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-serphouse.md", "mcp": "https://www.anchorterminal.com/mcp", "slim": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-serphouse.min.md" }, "markdown": "Perplexity Search API scores 70.2 (BB) on agent readiness against SERPHouse's 42.4 (E), and leads in 6 of 7 scored categories. SERPHouse leads on payments \u0026 pricing. Both do web search.\n\n- Perplexity Search API: grade BB, 70.2/100, rank #211 of 1510. Markdown https://www.anchorterminal.com/tools/perplexity-search-api.md · JSON https://www.anchorterminal.com/api/v1/tools/perplexity-search-api.json\n- SERPHouse: grade E, 42.4/100, rank #1283 of 1510. Markdown https://www.anchorterminal.com/tools/serphouse.md · JSON https://www.anchorterminal.com/api/v1/tools/serphouse.json\n- Best web search APIs for AI agents: https://www.anchorterminal.com/best/search/index.md\n- All 326 search comparisons: https://www.anchorterminal.com/compare/search/index.md\n\n## Which one, for what\n\n### Perplexity Search API (BB)\n\nGood for: Agents on any model that need raw ranked sources with extracted text at a low per-request price, and teams that want cited answers from the same key through the Agent API.\n\nAhead on:\n- Reliability, 80 against 40\n- Schema \u0026 documentation, 89 against 66\n- Agent ergonomics, 85 against 64\n- Security \u0026 auth, 56 against 11\n- Maintenance \u0026 community, 82 against 23\n- Transparency \u0026 trust, 66 against 50\n\nAlso in its favour:\n- Agent-ready, a grade of BB or better\n\nWatch for: The FAQ says uptime and recovery time are not guaranteed, and the terms carry no SLA\n\n### SERPHouse (E)\n\nGood for: Low-cost Google, Bing and Yahoo result parsing for SEO and rank tracking, with many Google verticals.\n\nAhead on:\n- Payments \u0026 pricing, 40 against 25\n\nAlso in its favour:\n- Free to start without a card\n\nWatch for: The hosted MCP server takes the API key only in its URL path, and the REST API also accepts `api_token` in the query string\n\n\n## Why the edge\n\n### Maintenance \u0026 community: Perplexity Search API +59\n\n- Perplexity Search API (82): Read as a closed service with official SDKs and an open-source MCP server. perplexityai 0.46.1 on PyPI on 23 October 2026 and the MCP server's last commit on 21 October, with changelog entries into November 2026 (30). In the 90 days from 8 August, perplexityai 0.43.7 to 0.46.1 (six releases from 2 October), MCP server 1.2.1 (27 August) and 1.3.0 (25 September, Fast Search on perplexity_search), and Fast Search itself in September (20). A changelog with several entries a month, a community forum with a bug-report category, a GitHub discussion repository and api@perplexity.ai. MCP issue reply times weren't read (10 of 15). The MCP server is in the official registry under the domain-verified ai.perplexity namespace, and the Python and TypeScript SDKs are current (15). The MCP repository runs tests in CI and validates its plugin manifests. Its 1.4.0, prepared on 16 October, is not on npm, which still serves 1.3.0, and the registry's latest entry is 1.2.1 of 27 August (7 of 10). 30 + 20 + 10 + 15 + 7 = 82.\n- SERPHouse (23): Read for a closed service, with its repositories read as code. No changelog or dated API change was found. The newest release is MCP server 1.1.0 on 6 July 2026, 123 days before 6 November, and the last commit in its repository was on 22 July (10). No release or dated change in the 90 days from 8 August; the about page's 2026 entry (Forums, Place Details and Scraper APIs) is undated (0). No changelog; support by email. Issues weren't read, since the GitHub API refused us for its rate limit (5 of 25). Not in the official MCP registry, though the repository's server.json names io.github.SERPHouse/serphouse-mcp. Node.js SDK last changed 24 June 2026, PHP SDK 10 May 2024, and no Python SDK repository was found under the SERPHouse organisation (5 of 15). The MCP repository has an npm publish workflow and no tests (3 of 10). 10 + 0 + 5 + 5 + 3 = 23.\n\n### Security \u0026 auth: Perplexity Search API +45\n\n- Perplexity Search API (56): Project API keys, shown once, revocable, and generated and revoked through two documented endpoints with a rotation guide. No per-key scopes or spending limits were found. The hosted MCP server also takes Sign in with Perplexity (OAuth). Keys go in the Authorization header only (22 of 30, as on the Decisions API listing). Search only reads, and MCP clients can disable tools, but any key reaches every API on the account, including the Agent API's sandbox and MCP tools (8 of 20). Snippets are third-party page text, and no guidance on treating them as untrusted was found in the docs, the MCP server or its SECURITY.md (0 of 15). Responses carry a request `id`, and the console shows usage by key. The Audit API covers enterprise organisations' web app events with its own keys, not API calls (8 of 15). security.txt valid until 31 December 2027 linking a security page, a SOC 2 Type II report, a 2025 HIPAA gap assessment and a CAIQlite listed on the trust centre, and a SECURITY.md on the MCP server that takes private reports through GitHub advisories or security@perplexity.ai. The trust centre is drawn by script and wasn't read (18 of 20). 22 + 8 + 0 + 8 + 18 = 56.\n- SERPHouse (11): One key per account, one account per user, no scopes or rotation found (10). The REST API documents `api_token` in the query string and the hosted MCP server takes the key only in its URL path, less 10 (0 of 30). Searches only read, with no read-only or restricted key (8 of 20). Results are third-party snippets and AI Overview text, with no prompt-injection guidance (0). An account tool shows plan and credit usage; no per-call log was found (3 of 15). No security.txt (404), disclosure policy, bug bounty or certification found (0 of 20). 0 + 8 + 0 + 3 + 0 = 11.\n\n### Reliability: Perplexity Search API +40\n\n- Perplexity Search API (80): Graded on the hosted lines, for `POST /search` and the hosted MCP server. status.perplexity.com, on incident.io since 10 September 2026, has an API component with an RSS feed and a JSON summary. There is no separate Search component (20). In the 90 days from 8 August the feed lists 'Investigating API issue' on 13 August, resolved with no detail, a usage-based billing issue on 3 September, and on 9 October elevated errors on the website, app and Computer, where the API 'remained operational throughout'. Minor only, with the caveat that history before the migration may be incomplete (20). The Search API is limited to 50 query units a second with a burst of 50 on every tier, and the other APIs publish QPS and token limits per tier (15). 429 carries Retry-After and an `error.type`, the SDKs retry 429 and 5xx twice honouring Retry-After, the Search best-practices page shows backoff, and failed or rate-limited searches are not billed. Searches have no side effects (15). The FAQ says Perplexity does not guarantee uptime, failure frequency or recovery time, and the terms carry no SLA (0). No beta label on the Search API, launched on 25 September 2025 (10). 20 + 20 + 15 + 15 + 0 + 10 = 80.\n- SERPHouse (40): Read with the hosted lines. No status page is linked from the site or docs, and status.serphouse.com did not answer on 6 November 2026 (0). No readable incident history (5). Rate limits published, 60 requests a minute and 60 concurrent on every self-serve plan (15). 429 is documented as 'slow down', and a 200 can carry `\"status\": \"error\"` with 'Please try again', with no Retry-After or backoff guidance. Failed requests aren't charged (5 of 15). The pricing page lists a 99.99% uptime SLA on Basic and Regular and the docs a 99.95% one, but no SLA terms or credits were found in the terms (5 of 10). Generally available (10). 0 + 5 + 15 + 5 + 5 + 10 = 40.\n\n### Schema \u0026 documentation: Perplexity Search API +23\n\n- Perplexity Search API (89): OpenAPI 3.1.0 at docs.perplexity.ai/openapi.json describes `POST /search` with typed request and response schemas, listed in llms.txt (25). llms.txt indexes every page, each with a Markdown twin (10). The overview says what a result holds, that snippets can be empty, when to use the Search API instead of the Agent API, and that it takes queries not URLs and does not re-fetch pages (19 of 20). `search_type` is an enum, `max_results`, `max_tokens` and `max_tokens_per_page` carry minimum and maximum, country and language codes carry lengths, and `query` is a string or an array. The recency filter is an enum in the docs, and date filters are `MM/DD/YYYY` strings (14 of 15). Python, TypeScript and cURL examples with a recorded response. The spec documents only 200 and 422 for `/search`, and status codes are listed on the SDK error-handling page and the rate-limit page rather than for Search (11 of 15). A public changelog with several entries a month, dated by month only, and an unversioned `/search` path (10 of 15). 25 + 10 + 19 + 14 + 11 + 10 = 89.\n- SERPHouse (66): No OpenAPI or similar contract for the REST API. The MCP server's tools carry typed Zod schemas, published in the source and a static server card (18 of 25). llms.txt at the site and the docs, and every docs page as Markdown (10). MCP tool descriptions say which tool to use for what, such as `serphouse_google_web` when device or `num_result` is needed, while the docs pages lead with marketing lines such as 'Unlock captivating Google video content' (12 of 20). Enums for device, SERP type, engine and video duration, defaults and 37 described parameters (11 of 15). A status code table and request examples per engine, with a generic error body (12 of 15). No changelog or API versioning; only the MCP server has tags (3 of 15). 18 + 10 + 12 + 11 + 12 + 3 = 66.\n\n### Agent ergonomics: Perplexity Search API +21\n\n- Perplexity Search API (85): `max_results` 1 to 20, `max_tokens` and `max_tokens_per_page` cap the extracted text, and results are title, url, snippet and two dates. The MCP server has four tools (23 of 25). Domain, language, recency, publication and update date filters and `country`, with up to five queries in one request. No pagination or offset (16 of 20). 429 bodies name the limit hit, the SDKs map status codes to typed errors, and 402 marks an empty balance. Search-specific error bodies beyond 422 validation are not documented (13 of 20). Searches only read, failed and rate-limited requests are not billed, and the MCP server sets readOnlyHint true, destructiveHint false and idempotentHint false on every tool (18 of 20). Only `query` is required. Official Python and TypeScript SDKs, a CLI and a Python Search SDK (15). 23 + 16 + 13 + 18 + 15 = 85.\n- SERPHouse (64): 23 MCP tools with no toolsets or filtering (15 of 25). `num_result`, `max_pages`, paging, device, location, language, date and video filters (16 of 20). Status codes are tabulated, but a 200 can also mean an error and the body carries only 'Please try again' (10 of 20). Searches only read and failed requests aren't charged, but the MCP tools carry no readOnlyHint or other annotations (10 of 20). `serphouse_search` needs only `q` and defaults to the US; most other tools need `loc` or `loc_id`. Official Node.js, PHP and Python SDKs are documented (13 of 15). 15 + 16 + 10 + 10 + 13 = 64.\n\n### Transparency \u0026 trust: Perplexity Search API +16\n\n- Perplexity Search API (66): Closed service under terms naming Perplexity AI, Inc. and California law. The MCP server is MIT and the SDKs Apache-2.0 (18 of 30). The terms and DPA say Customer Content and personal data don't train Perplexity's models, the DPA deletes personal data within 30 days of the service ending, and the Privacy and Security page says retention varies by API and zero data retention is not the default. The DPA also says Perplexity Search may follow different data terms, which weren't found, and no retention period for search queries is stated (15 of 30). Sonar Chat Completions support ended on 27 September 2026 with a migration guide and requests reformulated rather than refused, and sonar-reasoning was removed on 15 December 2025 with a named replacement. Notices are dated by month and there is no standing notice period beyond the terms' 30 days for termination (10 of 20). A sub-processor list on the trust centre, which is drawn by script and wasn't read, ten business days' notice of new non-model subprocessors, and SCCs for EU and UK transfers. No data location is stated (8 of 20). 18 + 15 + 10 + 8 = 51.\n- SERPHouse (50): Closed service under terms naming Patoliya Infotech LLP in India, and the MCP server is MIT (18 of 30). The terms give retention periods (JSON results up to 6 months, HTML up to 1 month, search history indefinitely) and say personal data sits on DigitalOcean in India, and they advise EEA users not to use the service. The privacy policy is generic and neither document carries a date (15 of 30). No deprecation policy, and the terms allow products to be discontinued without notice (0 of 20). DigitalOcean in India named for account data; no sub-processor list (6 of 20). 18 + 15 + 0 + 6 = 39.\n\n## Score by category\n\n| Category | Weight | Perplexity Search API | SERPHouse | Edge |\n| --- | --- | --- | --- | --- |\n| Reliability | 16% (20 this run) | 80 | 40 | Perplexity Search API +40 |\n| Performance | 10%, pending | pending | pending | not scored in this run |\n| Schema \u0026 documentation | 13% (16.2 this run) | 89 | 66 | Perplexity Search API +23 |\n| Agent ergonomics | 13% (16.2 this run) | 85 | 64 | Perplexity Search API +21 |\n| Security \u0026 auth | 14% (17.5 this run) | 56 | 11 | Perplexity Search API +45 |\n| Payments \u0026 pricing | 10% (12.5 this run) | 25 | 40 | SERPHouse +15 |\n| Task success | 10%, pending | pending | pending | not scored in this run |\n| Maintenance \u0026 community | 7% (8.8 this run) | 82 | 23 | Perplexity Search API +59 |\n| Transparency \u0026 trust | 7% (8.8 this run) | 66 | 50 | Perplexity Search API +16 |\n| Negative events | ≤15 | 0 | 0 | |\n| **Total** | | **70.2 · BB** | **42.4 · E** | |\n\n## Facts side by side\n\n| Fact | Perplexity Search API | SERPHouse |\n| --- | --- | --- |\n| Kind | HTTP API | HTTP API |\n| Vendor | Perplexity | Patoliya Infotech LLP |\n| Hosted endpoint | `https://api.perplexity.ai/mcp` | `https://mcp.serphouse.com/YOUR_API_KEY/mcp` |\n| Transports | Streamable HTTP, stdio | Streamable HTTP, stdio |\n| Auth | OAuth or key | API key |\n| Pricing | Pay per use | Paid |\n| Price for web search | $2.50 per 1,000 tool calls | not published |\n| x402 | no | no |\n| Licence | Proprietary service under the Perplexity API Terms of Service. The MCP server is MIT and the official SDKs Apache-2.0 | none |\n| Tools exposed | 4 | 23 |\n| Read-only variant documented | no | no |\n| llms.txt | yes | yes |\n| MCP registry | `ai.perplexity/mcp-server` | not listed |\n| Last release | 2026-10-23 | 2026-07-06 |\n| Terms last updated | couldn't be read | no date given |\n| Privacy policy last updated | couldn't be read | no date given |\n| Customer content may train models | couldn't be read | not found in the text |\n| Terms restrict automated access | couldn't be read | yes |\n| Terms restrict benchmarking | couldn't be read | not found in the text |\n| Terms or service can change without notice | couldn't be read | yes |\n| Arbitration or class-action waiver | couldn't be read | not found in the text |\n\n## Verdicts\n\n**Perplexity Search API.** Raw ranked results with token-capped page text from Perplexity's own index, $5 per 1,000 requests or $1 with Fast Search, an OpenAPI description and a hosted MCP server with read-only annotations. Uptime is not guaranteed, there is no free allowance, keys carry no scopes, and no guidance on untrusted page text was found.\n\n**SERPHouse.** SERPHouse returns parsed Google, Bing and Yahoo results at published prices from $0.62 per 1,000 requests, with a 23-tool MCP server and a 4,000-credit trial without a card. The hosted MCP puts the key in its URL, there is no status page, changelog or security contact, and the terms keep search history indefinitely.\n\n## Before you call either\n\n### Perplexity Search API\n\n1. Set `max_tokens_per_page` and `max_tokens` before calling; extracted text otherwise fills the context, and the price does not change with size\n2. Skip results with an empty `snippet` and dedupe by `url` when sending a `query` array; each query costs one rate-limit unit\n3. Use `search_type: \"fast\"` for $1 per 1,000 when latency and cost matter more than depth\n4. On 429 wait for Retry-After, then back off; on 402 stop and ask the user to add credits\n5. Use the Search API for sources and the Agent API's web_search tool for a written answer with citations\n\n### SERPHouse\n\n1. Send the key as `Authorization: Bearer`, not as `api_token` in the URL\n2. Treat a 200 with `\"status\": \"error\"` and 'Please try again' as a failure and retry later\n3. Pass `loc` or `loc_id` for Google and Bing tools other than `serphouse_search`; find IDs with `serphouse_location_search`\n4. Use `serphouse_search` for plain lookups and `serphouse_serp_google_advanced` only when ranks beyond the top 10 are needed, at ten times the price\n5. Keep under 60 requests a minute on self-serve plans\n\n## Questions\n\n### Which is better for AI agents, Perplexity Search API or SERPHouse?\n\nPerplexity Search API scores 70.2 (BB) on agent readiness against SERPHouse's 42.4 (E), and leads in 6 of 7 scored categories. SERPHouse leads on payments \u0026 pricing.\n\n### Do Perplexity Search API and SERPHouse need an API key?\n\nPerplexity Search API takes an API key or an OAuth sign-in. SERPHouse needs an API key.\n\n### Can an agent call Perplexity Search API and SERPHouse without installing anything?\n\nYes. Perplexity Search API has a hosted endpoint at https://api.perplexity.ai/mcp and SERPHouse at https://mcp.serphouse.com/YOUR_API_KEY/mcp.\n\n\n## For agents\n\n- This comparison as JSON: https://www.anchorterminal.com/compare/perplexity-search-api-vs-serphouse.json, and with the fewest tokens: https://www.anchorterminal.com/compare/perplexity-search-api-vs-serphouse.min.md\n- Over MCP at https://www.anchorterminal.com/mcp (no key): `compare_tools {\"a\": \"perplexity-search-api\", \"b\": \"serphouse\"}`. From a terminal: `anchor compare perplexity-search-api serphouse`\n- Each listing in full: https://www.anchorterminal.com/api/v1/tools/perplexity-search-api.json and https://www.anchorterminal.com/api/v1/tools/serphouse.json\n\n## Other comparisons with Perplexity Search API or SERPHouse\n\n- [Web Search Tool on Amazon Bedrock AgentCore vs Perplexity Search API](https://www.anchorterminal.com/compare/agentcore-web-search-vs-perplexity-search-api.md)\n- [Web Search Tool on Amazon Bedrock AgentCore vs SERPHouse](https://www.anchorterminal.com/compare/agentcore-web-search-vs-serphouse.md)\n- [Grounding with Bing Search vs Perplexity Search API](https://www.anchorterminal.com/compare/bing-grounding-vs-perplexity-search-api.md)\n- [Grounding with Bing Search vs SERPHouse](https://www.anchorterminal.com/compare/bing-grounding-vs-serphouse.md)\n- [Brave Search API + MCP vs Perplexity Search API](https://www.anchorterminal.com/compare/brave-search-mcp-vs-perplexity-search-api.md)\n- [Brave Search API + MCP vs SERPHouse](https://www.anchorterminal.com/compare/brave-search-mcp-vs-serphouse.md)\n- [Cloudflare Web Search API vs Perplexity Search API](https://www.anchorterminal.com/compare/cloudflare-web-search-vs-perplexity-search-api.md)\n- [Cloudflare Web Search API vs SERPHouse](https://www.anchorterminal.com/compare/cloudflare-web-search-vs-serphouse.md)\n- [DeepSeek Search and Fetch API vs Perplexity Search API](https://www.anchorterminal.com/compare/deepseek-search-api-vs-perplexity-search-api.md)\n- [DeepSeek Search and Fetch API vs SERPHouse](https://www.anchorterminal.com/compare/deepseek-search-api-vs-serphouse.md)\n- [Exa API + MCP vs Perplexity Search API](https://www.anchorterminal.com/compare/exa-mcp-vs-perplexity-search-api.md)\n- [Exa API + MCP vs SERPHouse](https://www.anchorterminal.com/compare/exa-mcp-vs-serphouse.md)\n- [Firecrawl MCP vs Perplexity Search API](https://www.anchorterminal.com/compare/firecrawl-mcp-vs-perplexity-search-api.md)\n- [Kagi Search API vs Perplexity Search API](https://www.anchorterminal.com/compare/kagi-search-vs-perplexity-search-api.md)\n- [Kagi Search API vs SERPHouse](https://www.anchorterminal.com/compare/kagi-search-vs-serphouse.md)\n- [Linkup vs Perplexity Search API](https://www.anchorterminal.com/compare/linkup-vs-perplexity-search-api.md)\n- [Linkup vs SERPHouse](https://www.anchorterminal.com/compare/linkup-vs-serphouse.md)\n- [Mojeek Web Search API vs Perplexity Search API](https://www.anchorterminal.com/compare/mojeek-vs-perplexity-search-api.md)\n- [Mojeek Web Search API vs SERPHouse](https://www.anchorterminal.com/compare/mojeek-vs-serphouse.md)\n- [NewsCatcher vs Perplexity Search API](https://www.anchorterminal.com/compare/newscatcher-vs-perplexity-search-api.md)\n- [Parallel Search and Task APIs vs Perplexity Search API](https://www.anchorterminal.com/compare/parallel-search-api-vs-perplexity-search-api.md)\n- [Parallel Search and Task APIs vs SERPHouse](https://www.anchorterminal.com/compare/parallel-search-api-vs-serphouse.md)\n- [Perplexity Search API vs SearchAPI.io](https://www.anchorterminal.com/compare/perplexity-search-api-vs-searchapi-io.md)\n- [Perplexity Search API vs SerpApi](https://www.anchorterminal.com/compare/perplexity-search-api-vs-serpapi.md)\n- [Perplexity Search API vs Serper](https://www.anchorterminal.com/compare/perplexity-search-api-vs-serper.md)\n- [Perplexity Search API vs SerpKite](https://www.anchorterminal.com/compare/perplexity-search-api-vs-serpkite.md)\n- [Perplexity Search API vs SpecStream](https://www.anchorterminal.com/compare/perplexity-search-api-vs-specstream.md)\n- [Perplexity Search API vs Tavily API + MCP](https://www.anchorterminal.com/compare/perplexity-search-api-vs-tavily-mcp.md)\n- [Perplexity Search API vs TinyFish Search](https://www.anchorterminal.com/compare/perplexity-search-api-vs-tinyfish-search.md)\n- [Perplexity Search API vs Valyu](https://www.anchorterminal.com/compare/perplexity-search-api-vs-valyu.md)\n- [Perplexity Search API vs You.com APIs](https://www.anchorterminal.com/compare/perplexity-search-api-vs-you-com-api.md)\n- [SearchAPI.io vs SERPHouse](https://www.anchorterminal.com/compare/searchapi-io-vs-serphouse.md)\n- [SerpApi vs SERPHouse](https://www.anchorterminal.com/compare/serpapi-vs-serphouse.md)\n- [Serper vs SERPHouse](https://www.anchorterminal.com/compare/serper-vs-serphouse.md)\n- [SERPHouse vs SpecStream](https://www.anchorterminal.com/compare/serphouse-vs-specstream.md)\n- [SERPHouse vs Tavily API + MCP](https://www.anchorterminal.com/compare/serphouse-vs-tavily-mcp.md)\n- [SERPHouse vs TinyFish Search](https://www.anchorterminal.com/compare/serphouse-vs-tinyfish-search.md)\n- [SERPHouse vs Valyu](https://www.anchorterminal.com/compare/serphouse-vs-valyu.md)\n- [SERPHouse vs You.com APIs](https://www.anchorterminal.com/compare/serphouse-vs-you-com-api.md)\n- [Arcmira vs Perplexity Search API](https://www.anchorterminal.com/compare/arcmira-vs-perplexity-search-api.md)\n- [Grep AI vs Perplexity Search API](https://www.anchorterminal.com/compare/grep-ai-vs-perplexity-search-api.md)\n- [Liner Search MCP vs Perplexity Search API](https://www.anchorterminal.com/compare/liner-mcp-vs-perplexity-search-api.md)\n- [Fetch (MCP reference server) vs SERPHouse](https://www.anchorterminal.com/compare/fetch-reference-server-vs-serphouse.md)\n- [NewsCatcher vs SERPHouse](https://www.anchorterminal.com/compare/newscatcher-vs-serphouse.md)\n- [Liner Search MCP vs SERPHouse](https://www.anchorterminal.com/compare/liner-mcp-vs-serphouse.md)\n- [SERPHouse vs SerpKite](https://www.anchorterminal.com/compare/serphouse-vs-serpkite.md)\n", "meta": { "attribution": "Anchor Terminal (https://www.anchorterminal.com)", "attributionRequired": true, "credit": "CC BY 4.0, credit Anchor Terminal and link the page or API address you took it from (https://www.anchorterminal.com/terms/#data)", "docs": "https://www.anchorterminal.com/docs/", "generatedAt": "2026-11-07", "license": "CC-BY-4.0", "method": "https://www.anchorterminal.com/benchmark/", "methodology": "0.7", "openapi": "https://www.anchorterminal.com/openapi.json", "preview": false, "run": "2026-10-01", "runLabel": "October 2026 research run", "terms": "https://www.anchorterminal.com/terms/#data" }, "page": { "breadcrumbs": [ { "name": "Home", "url": "https://www.anchorterminal.com/" }, { "name": "Compare", "url": "https://www.anchorterminal.com/compare/" }, { "name": "Perplexity Search API vs SERPHouse", "url": "" } ], "description": "Perplexity Search scores 70.2 (BB) to SERPHouse's 42.4 (E) for web search. Prices, MCP, x402, uptime and agent notes side by side.", "facts": [ "Perplexity Search API BB 70.2", "SERPHouse E 42.4", "scores" ], "h1": "Perplexity Search API vs SERPHouse", "image": "https://www.anchorterminal.com/assets/og/default.png", "path": "/compare/perplexity-search-api-vs-serphouse", "published": "2026-10-01", "section": "tools", "title": "Perplexity Search vs SERPHouse for AI agents (2026) | Anchor Terminal", "toc": null, "updated": "2026-11-07", "url": "https://www.anchorterminal.com/compare/perplexity-search-api-vs-serphouse" }, "tokens": { "markdown": 6050, "slim": 3530 }, "version": 1 }