{
  "$schema": "https://intentroute.net/catalog/v1.1/schema/capability-record.schema.json",
  "schema_version": "1.1.0",
  "record_id": "web-search:perplexity",
  "record_version": "1.0.1",
  "catalog_release_id": "web-search-v0.2.0",
  "category": "web.search",
  "record_status": "accepted",
  "provider": {
    "provider_id": "perplexity",
    "name": "Perplexity"
  },
  "product": {
    "product_id": "perplexity-search-api",
    "name": "Perplexity Search API"
  },
  "delivery_model": "ai_native_retrieval",
  "agent_tasks": [
    {
      "task": "current_fact_retrieval",
      "basis_claims": [
        "/claims/capabilities/request_features",
        "/claims/capabilities/response_fields"
      ]
    },
    {
      "task": "source_discovery",
      "basis_claims": [
        "/claims/capabilities/response_fields"
      ]
    },
    {
      "task": "comparative_research",
      "basis_claims": [
        "/claims/capabilities/request_features",
        "/claims/capabilities/response_fields"
      ]
    },
    {
      "task": "domain_constrained_search",
      "basis_claims": [
        "/claims/capabilities/request_features"
      ]
    },
    {
      "task": "regional_search",
      "basis_claims": [
        "/claims/capabilities/request_features"
      ]
    },
    {
      "task": "language_search",
      "basis_claims": [
        "/claims/capabilities/request_features"
      ]
    },
    {
      "task": "fresh_content_for_rag",
      "basis_claims": [
        "/claims/capabilities/request_features",
        "/claims/capabilities/response_fields"
      ]
    }
  ],
  "canonical_uris": {
    "machine": "https://intentroute.net/catalog/v1/web-search/records/perplexity.json",
    "human": "https://intentroute.net/catalog/web-search/perplexity"
  },
  "claims": {
    "identity": {
      "provider": {
        "claim_class": "provider_identity",
        "state": "current",
        "confidence": "high",
        "observed_on": "2026-08-16",
        "review_interval_days": 90,
        "next_review_on": "2026-11-14",
        "state_reason": null,
        "evidence": [
          {
            "evidence_id": "ev:perplexity.provider-identity",
            "evidence_type": "public_documentation",
            "source_url": "https://docs.perplexity.ai/docs/search/quickstart",
            "source_title": "Perplexity Search API quickstart",
            "observed_on": "2026-08-16",
            "source_published_on": null,
            "locator": "Provider/product documentation",
            "content_digest": null,
            "notes": null
          }
        ],
        "value": {
          "official_name": "Perplexity",
          "official_url": "https://www.perplexity.ai/"
        }
      },
      "product": {
        "claim_class": "product_identity",
        "state": "current",
        "confidence": "high",
        "observed_on": "2026-08-16",
        "review_interval_days": 90,
        "next_review_on": "2026-11-14",
        "state_reason": null,
        "evidence": [
          {
            "evidence_id": "ev:perplexity.product-identity",
            "evidence_type": "public_documentation",
            "source_url": "https://docs.perplexity.ai/docs/search/quickstart",
            "source_title": "Perplexity Search API quickstart",
            "observed_on": "2026-08-16",
            "source_published_on": null,
            "locator": "Product title and documentation boundary",
            "content_digest": null,
            "notes": null
          }
        ],
        "value": {
          "official_name": "Perplexity Search API",
          "documentation_url": "https://docs.perplexity.ai/docs/search/quickstart"
        }
      }
    },
    "access": {
      "endpoint": {
        "claim_class": "endpoint",
        "state": "current",
        "confidence": "high",
        "observed_on": "2026-08-16",
        "review_interval_days": 30,
        "next_review_on": "2026-09-15",
        "state_reason": null,
        "evidence": [
          {
            "evidence_id": "ev:perplexity.endpoint",
            "evidence_type": "public_documentation",
            "source_url": "https://docs.perplexity.ai/docs/search/quickstart",
            "source_title": "Perplexity Search API quickstart",
            "observed_on": "2026-08-16",
            "source_published_on": null,
            "locator": "Documented request example or endpoint reference",
            "content_digest": null,
            "notes": null
          }
        ],
        "value": {
          "base_url": "https://api.perplexity.ai",
          "search_path": "/search",
          "http_method": "POST"
        }
      },
      "authentication": {
        "claim_class": "authentication",
        "state": "current",
        "confidence": "high",
        "observed_on": "2026-08-16",
        "review_interval_days": 30,
        "next_review_on": "2026-09-15",
        "state_reason": null,
        "evidence": [
          {
            "evidence_id": "ev:perplexity.authentication",
            "evidence_type": "public_documentation",
            "source_url": "https://docs.perplexity.ai/docs/search/quickstart",
            "source_title": "Perplexity Search API quickstart",
            "observed_on": "2026-08-16",
            "source_published_on": null,
            "locator": "Documented authentication method",
            "content_digest": null,
            "notes": null
          }
        ],
        "value": [
          "bearer_token"
        ]
      },
      "availability": {
        "claim_class": "access_availability",
        "state": "current",
        "confidence": "high",
        "observed_on": "2026-08-24",
        "review_interval_days": 7,
        "next_review_on": "2026-08-31",
        "state_reason": null,
        "evidence": [
          {
            "evidence_id": "ev:perplexity.access-availability",
            "evidence_type": "public_documentation",
            "source_url": "https://docs.perplexity.ai/docs/search/quickstart",
            "source_title": "Perplexity Search API quickstart",
            "observed_on": "2026-08-24",
            "source_published_on": null,
            "locator": "Documented account or access path",
            "content_digest": null,
            "notes": null
          }
        ],
        "value": "public_signup"
      },
      "product_stage": {
        "claim_class": "product_stage",
        "state": "unknown",
        "confidence": "unknown",
        "observed_on": null,
        "review_interval_days": null,
        "next_review_on": null,
        "state_reason": null,
        "evidence": [],
        "value": null
      }
    },
    "capabilities": {
      "request_features": {
        "claim_class": "request_features",
        "state": "current",
        "confidence": "high",
        "observed_on": "2026-08-16",
        "review_interval_days": 30,
        "next_review_on": "2026-09-15",
        "state_reason": null,
        "evidence": [
          {
            "evidence_id": "ev:perplexity.request-features",
            "evidence_type": "public_documentation",
            "source_url": "https://docs.perplexity.ai/docs/search/quickstart",
            "source_title": "Perplexity Search API quickstart",
            "observed_on": "2026-08-16",
            "source_published_on": null,
            "locator": "Documented request controls",
            "content_digest": null,
            "notes": null
          }
        ],
        "value": [
          "query",
          "max_results",
          "domain_filter",
          "recency_filter",
          "language",
          "geography"
        ]
      },
      "response_fields": {
        "claim_class": "response_fields",
        "state": "current",
        "confidence": "high",
        "observed_on": "2026-08-16",
        "review_interval_days": 30,
        "next_review_on": "2026-09-15",
        "state_reason": null,
        "evidence": [
          {
            "evidence_id": "ev:perplexity.response-fields",
            "evidence_type": "public_documentation",
            "source_url": "https://docs.perplexity.ai/docs/search/quickstart",
            "source_title": "Perplexity Search API quickstart",
            "observed_on": "2026-08-16",
            "source_published_on": null,
            "locator": "Documented structured response or citation fields",
            "content_digest": null,
            "notes": null
          }
        ],
        "value": [
          "title",
          "url",
          "snippet",
          "published_at",
          "raw_content"
        ]
      }
    },
    "commercial": {
      "pricing": {
        "claim_class": "pricing",
        "state": "current",
        "confidence": "high",
        "observed_on": "2026-08-24",
        "review_interval_days": 7,
        "next_review_on": "2026-08-31",
        "state_reason": null,
        "evidence": [
          {
            "evidence_id": "ev:perplexity.pricing",
            "evidence_type": "public_documentation",
            "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing",
            "source_title": "Perplexity API pricing",
            "observed_on": "2026-08-24",
            "source_published_on": null,
            "locator": "Current provider pricing table",
            "content_digest": null,
            "notes": null
          }
        ],
        "value": {
          "billing_model": "usage_based",
          "provider_units": [
            {
              "tier_name": "Search API",
              "amount": "5",
              "currency": "USD",
              "unit": "successful_requests",
              "unit_quantity": 1000,
              "description": "Successful Search API requests; one request may contain up to five queries and has no token charge."
            }
          ],
          "normalized_units": []
        }
      },
      "quota": {
        "claim_class": "quota",
        "state": "unknown",
        "confidence": "unknown",
        "observed_on": null,
        "review_interval_days": null,
        "next_review_on": null,
        "state_reason": null,
        "evidence": [],
        "value": null
      }
    },
    "coverage": {
      "languages": {
        "claim_class": "languages",
        "state": "current",
        "confidence": "high",
        "observed_on": "2026-08-16",
        "review_interval_days": 30,
        "next_review_on": "2026-09-15",
        "state_reason": null,
        "evidence": [
          {
            "evidence_id": "ev:perplexity.languages",
            "evidence_type": "public_documentation",
            "source_url": "https://docs.perplexity.ai/docs/search/quickstart",
            "source_title": "Perplexity Search API quickstart",
            "observed_on": "2026-08-16",
            "source_published_on": null,
            "locator": "Documented language controls",
            "content_digest": null,
            "notes": null
          }
        ],
        "value": [
          "Language filtering is documented for Search API requests."
        ]
      },
      "geographies": {
        "claim_class": "geographies",
        "state": "current",
        "confidence": "high",
        "observed_on": "2026-08-16",
        "review_interval_days": 30,
        "next_review_on": "2026-09-15",
        "state_reason": null,
        "evidence": [
          {
            "evidence_id": "ev:perplexity.geographies",
            "evidence_type": "public_documentation",
            "source_url": "https://docs.perplexity.ai/docs/search/quickstart",
            "source_title": "Perplexity Search API quickstart",
            "observed_on": "2026-08-16",
            "source_published_on": null,
            "locator": "Documented geographic controls",
            "content_digest": null,
            "notes": null
          }
        ],
        "value": [
          "Country filtering is documented for Search API requests."
        ]
      }
    },
    "policy": {
      "terms": {
        "claim_class": "terms",
        "state": "unknown",
        "confidence": "unknown",
        "observed_on": null,
        "review_interval_days": null,
        "next_review_on": null,
        "state_reason": null,
        "evidence": [],
        "value": null
      },
      "privacy": {
        "claim_class": "privacy",
        "state": "current",
        "confidence": "high",
        "observed_on": "2026-08-16",
        "review_interval_days": 30,
        "next_review_on": "2026-09-15",
        "state_reason": null,
        "evidence": [
          {
            "evidence_id": "ev:perplexity.privacy",
            "evidence_type": "public_documentation",
            "source_url": "https://docs.perplexity.ai/docs/resources/privacy-security",
            "source_title": "Perplexity API Privacy and Security",
            "observed_on": "2026-08-16",
            "source_published_on": null,
            "locator": "Public privacy or data-control statement",
            "content_digest": null,
            "notes": null
          }
        ],
        "value": {
          "privacy_url": "https://docs.perplexity.ai/docs/resources/privacy-security",
          "retention_summary": "The public page documents API controls, but Search-API-specific content retention is not stated and is not inferred from Sonar."
        }
      },
      "usage_restrictions": {
        "claim_class": "usage_restrictions",
        "state": "unknown",
        "confidence": "unknown",
        "observed_on": null,
        "review_interval_days": null,
        "next_review_on": null,
        "state_reason": null,
        "evidence": [],
        "value": null
      }
    }
  },
  "correction": {
    "status": "none",
    "public_correction_uri": null,
    "acknowledgement_target_days": null,
    "resolution_target_days": null
  },
  "revision_history": []
}