{
  "name": "Deepgram Aura (Text to Speech)",
  "slug": "deepgram-aura",
  "website_url": "https://deepgram.com/product/text-to-speech",
  "vendor_description": "\"Sub-200ms streaming text-to-speech built for voice agents with domain-specific accuracy and secure, scalable deployment across cloud and on-prem environments\"",
  "categories": [
    "text-to-speech"
  ],
  "summary": "Deepgram Aura is a streaming text-to-speech API built for real-time voice agents, contact centers, and conversational AI, with sub-200ms latency delivered over WebSocket or REST. It is priced per 1,000 characters on a usage-based model with a one-time $200 sign-up credit, no sales call required, and enterprise plans available. The API carries SOC 2 Type 2, HIPAA, GDPR, and PCI DSS certifications, supports self-hosted deployment, and offers SDKs for JavaScript, Python, Go, and .NET.",
  "capabilities": {
    "supported_actions": [
      "synthesize_speech",
      "streaming_tts",
      "websocket_streaming",
      "rest_tts",
      "tts_callback",
      "audio_output_streaming",
      "multilingual_synthesis",
      "codeswitching_voices",
      "self_hosted_deployment"
    ],
    "supported_regions": [
      "United States",
      "European Union (api.eu.deepgram.com)",
      "Australia (api.au.deepgram.com)"
    ],
    "supported_languages": [
      "English (US)",
      "English (UK/British)",
      "English (Australian)",
      "English (Irish)",
      "English (Filipino/Philippine)",
      "Spanish (Mexican)",
      "Spanish (Peninsular)",
      "Spanish (Colombian)",
      "Spanish (Latin American)",
      "German",
      "French",
      "Dutch",
      "Italian",
      "Japanese"
    ],
    "input_types": [
      "plain text",
      "JSON text payload"
    ],
    "output_types": [
      "mp3",
      "wav/linear16",
      "mulaw",
      "alaw",
      "opus",
      "flac",
      "aac",
      "streaming audio chunks"
    ],
    "webhooks_supported": true,
    "sandbox_available": false,
    "sdk_languages": [
      "JavaScript",
      "Python",
      "Go",
      ".NET"
    ],
    "mcp_server_available": true
  },
  "integration": {
    "api_style": "rest",
    "base_url": "https://api.deepgram.com/v1",
    "api_version": "v1",
    "versioning_scheme": "url",
    "stability": "ga",
    "deprecation_policy_url": null,
    "auth_methods": [
      "api_key",
      "jwt"
    ],
    "auth_docs_url": "https://developers.deepgram.com/reference/authentication",
    "idempotency_supported": null,
    "error_format": "vendor-specific",
    "webhook_signing": "dg-token header",
    "webhook_events_url": "https://developers.deepgram.com/docs/tts-callback",
    "rate_limit_requests": 15,
    "rate_limit_window": "concurrent",
    "sdk_packages": [
      {
        "package": "@deepgram/sdk",
        "language": "JavaScript",
        "official": true,
        "repo_url": "https://github.com/deepgram/deepgram-js-sdk"
      },
      {
        "package": "deepgram-sdk",
        "language": "Python",
        "official": true,
        "repo_url": "https://github.com/deepgram/deepgram-python-sdk"
      },
      {
        "package": "github.com/deepgram/deepgram-go-sdk/v2",
        "language": "Go",
        "official": true,
        "repo_url": "https://github.com/deepgram/deepgram-go-sdk"
      },
      {
        "package": "Deepgram",
        "language": ".NET",
        "official": true,
        "repo_url": "https://github.com/deepgram/deepgram-dotnet-sdk"
      }
    ],
    "mcp_url": "https://developers.deepgram.com/_mcp/server",
    "quickstart_url": "https://developers.deepgram.com/docs/text-to-speech"
  },
  "pricing": {
    "pricing_model": "usage_based",
    "has_published_pricing": true,
    "starting_price_usd": "0.0000",
    "price_basis": "1,000 characters",
    "free_tier_available": false,
    "free_tier_limit": "$200 credit",
    "free_tier_details": null,
    "minimum_commitment": null,
    "self_serve_signup": true,
    "requires_sales_call": false,
    "requires_verification": false,
    "enterprise_plan_available": true,
    "price_points": [
      {
        "plan": "Pay As You Go",
        "item": "Aura-2 speech synthesis",
        "amount_usd": "0.0300",
        "amount_percent": null,
        "per": "1,000 characters",
        "currency": "USD",
        "source_url": "https://deepgram.com/pricing"
      },
      {
        "plan": "Pay As You Go",
        "item": "Aura-1 speech synthesis",
        "amount_usd": "0.0150",
        "amount_percent": null,
        "per": "1,000 characters",
        "currency": "USD",
        "source_url": "https://deepgram.com/pricing"
      },
      {
        "plan": "Growth (prepaid annual credits)",
        "item": "Aura-2 speech synthesis",
        "amount_usd": "0.0270",
        "amount_percent": null,
        "per": "1,000 characters",
        "currency": "USD",
        "source_url": "https://deepgram.com/pricing"
      },
      {
        "plan": "Growth (prepaid annual credits)",
        "item": "Aura-1 speech synthesis",
        "amount_usd": "0.0135",
        "amount_percent": null,
        "per": "1,000 characters",
        "currency": "USD",
        "source_url": "https://deepgram.com/pricing"
      }
    ]
  },
  "compliance": {
    "soc2": "type_2",
    "hipaa": true,
    "gdpr": true,
    "iso_27001": null,
    "pci_dss": true,
    "sla_published": true,
    "sla_url": null,
    "data_retention_policy_url": "https://developers.deepgram.com/trust-security/data-privacy-compliance",
    "documented_rate_limits": "Max 2,000 characters per request (Aura-2 and Aura-1); requests exceeding this return HTTP 413. Concurrent request limit enforced per project: 15 concurrent REST requests on Pay As You Go; 45 concurrent WebSocket requests. Exceeding returns HTTP 429 Too Many Requests.",
    "known_restrictions": [
      "No SSML support; uses text-based prompting techniques (punctuation, filler words) for speech control instead",
      "WebSocket/streaming mode only supports linear16, mulaw, and alaw encodings; compressed formats (mp3, opus, flac, aac) are REST-only",
      "Maximum 2,000 characters per REST request",
      "$200 sign-up credit is a one-time trial credit, not a recurring free tier",
      "Voice cloning not offered as a self-serve feature",
      "Spanish, Dutch, French, German, Italian, Japanese voices are Aura-2 only (Aura-1 has English voices only)"
    ]
  },
  "developer": {
    "docs_url": "https://developers.deepgram.com/home",
    "api_reference_url": null,
    "openapi_spec_url": null,
    "postman_collection_url": null,
    "changelog_url": "https://deepgram.com/changelog",
    "status_page_url": "https://status.deepgram.com",
    "llms_txt_url": "https://deepgram.com/llms.txt",
    "markdown_docs_url": null,
    "rendering": "static"
  },
  "adoption": {
    "launched_at": "2024-03-12",
    "ga_date": "2024-03-12",
    "github_stars": null,
    "github_stars_at": null,
    "notable_customers": [
      "Humach",
      "Vapi",
      "Daily",
      "Twilio",
      "Quiq"
    ]
  },
  "scores": {
    "agent_friendliness": 55,
    "pricing_transparency": 85,
    "setup_speed": 60,
    "docs_quality": 35,
    "procurement_friction": 85,
    "trust_readiness": 85,
    "best_for": [
      "Regulated or enterprise workloads - compliance attestations and an enterprise plan",
      "AI agents and automation - an agent-ready surface (MCP / llms.txt)",
      "Teams needing broad API coverage out of the box"
    ],
    "avoid_if": [
      "You want to try it free before paying"
    ]
  },
  "sources": [
    {
      "field": "sdk_languages",
      "url": "https://developers.deepgram.com/docs/text-to-speech",
      "excerpt": "JavaScript/Node.js, Python, Go, C#, Java",
      "confidence": "high"
    },
    {
      "field": "supported_languages",
      "url": "https://developers.deepgram.com/docs/tts-models",
      "excerpt": "Aura-2 offers the most extensive voice library: English (39 voices), Spanish (17 voices, Early Access), Dutch (9 voices), French (2 voices), German (7 voices), Italian (10 voices), Japanese (5 voices)",
      "confidence": "high"
    },
    {
      "field": "webhooks_supported",
      "url": "https://developers.deepgram.com/docs/tts-callback",
      "excerpt": "Deepgram's Callback feature allows you to supply a callback URL to which generated text-to-speech audio can be returned. When passed, Deepgram will immediately respond with a request_id before processing your text asynchronously.",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://deepgram.com/pricing",
      "excerpt": "Pay As You Go: Aura-2: $0.030/1k characters; Aura-1: $0.0150/1k characters",
      "confidence": "high"
    },
    {
      "field": "has_published_pricing",
      "url": "https://deepgram.com/pricing",
      "excerpt": "Aura-2: $0.030/1k characters; Aura-1: $0.0150/1k characters",
      "confidence": "high"
    },
    {
      "field": "enterprise_plan_available",
      "url": "https://deepgram.com/pricing",
      "excerpt": "Enterprise — For businesses with large volumes, data or deployment requirements, or support needs.",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://developers.deepgram.com/trust-security/data-privacy-compliance",
      "excerpt": "Deepgram has achieved SOC 2 Type 1 and Type 2 certification.",
      "confidence": "high"
    },
    {
      "field": "hipaa",
      "url": "https://developers.deepgram.com/trust-security/data-privacy-compliance",
      "excerpt": "Deepgram is considered a Business Associate as defined by the US HIPAA legislation.",
      "confidence": "high"
    },
    {
      "field": "pci_dss",
      "url": "https://developers.deepgram.com/trust-security/security-policy",
      "excerpt": "We maintain HIPAA Compliance and are PCI Compliant, adhering to the requirements throughout the year, which includes a list of checks, obligations, and independent audits for verification.",
      "confidence": "high"
    },
    {
      "field": "iso_27001",
      "url": "https://developers.deepgram.com/trust-security/data-privacy-compliance",
      "excerpt": "Deepgram has achieved SOC 2 Type 1 and Type 2 certification. [ISO 27001 is not mentioned on any trust/security page]",
      "confidence": "high"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://developers.deepgram.com/reference/api-rate-limits",
      "excerpt": "Text-to-Speech REST: 15 concurrent (Aura/Aura-2) — Pay as You Go plan",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://developers.deepgram.com/docs/tts-encoding",
      "excerpt": "streaming audio output is only available with the PCM and mu-law/a-law formats, while the compressed formats (MP3, Opus, FLAC, AAC) work exclusively with REST requests.",
      "confidence": "high"
    },
    {
      "field": "supported_regions",
      "url": "https://developers.deepgram.com/trust-security/data-privacy-compliance",
      "excerpt": "European Union: api.eu.deepgram.com; Australia: api.au.deepgram.com (AWS ap-southeast-2, Sydney)",
      "confidence": "high"
    },
    {
      "field": "vendor_description",
      "url": "https://deepgram.com/product/text-to-speech",
      "excerpt": "sub-200ms streaming text-to-speech built for voice agents with domain-specific accuracy and secure, scalable deployment across cloud and on-prem environments",
      "confidence": "high"
    },
    {
      "field": "output_types",
      "url": "https://developers.deepgram.com/docs/tts-encoding",
      "excerpt": "linear16: 16-bit, little-endian, signed PCM WAV data; mulaw: Mu-law encoded WAV data; alaw: A-law encoded WAV data; mp3: MP3 audio compression format (default); opus: Ogg Opus codec; flac: Free Lossless Audio Codec (FLAC); aac: Advanced Audio Coding format",
      "confidence": "high"
    },
    {
      "field": "mcp_server_available",
      "url": "https://developers.deepgram.com/developer-tools/cli/mcp-server",
      "excerpt": "The dg CLI includes a built-in MCP (Model Context Protocol) server that gives AI coding tools direct access to Deepgram APIs.",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://deepgram.com/pricing",
      "excerpt": "Growth option allows customers to Save up to 20% by committing to prepaid annual credits that are redeemed against actual usage — no mandatory recurring base fee on the standard Pay As You Go tier",
      "confidence": "high"
    },
    {
      "field": "free_tier_available",
      "url": "https://deepgram.com/pricing",
      "excerpt": "Free $200 Credit — no credit card required to start. Provides access to All endpoints in public models for Speech-to-Text and Text-to-Speech services.",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://deepgram.com/data-security",
      "excerpt": "We recently received a SOC 2 Type II 'clean bill of health' from Cyberguard Compliance—the gold standard in SOC audits.",
      "confidence": "high"
    },
    {
      "field": "hipaa",
      "url": "https://developers.deepgram.com/trust-security/security-policy",
      "excerpt": "We maintain HIPAA Compliance and are PCI Compliant, adhering to the requirements throughout the year, which includes a list of checks, obligations, and independent audits for verification.",
      "confidence": "high"
    },
    {
      "field": "gdpr",
      "url": "https://developers.deepgram.com/trust-security/data-privacy-compliance",
      "excerpt": "Deepgram is GDPR ready and provides information to customers to help them understand how features and functionality of its platform may affect their GDPR compliance obligations. For customers requiring data processing within the European Union, Deepgram provides an EU-specific endpoint at api.eu.deepgram.com.",
      "confidence": "high"
    },
    {
      "field": "pci_dss",
      "url": "https://developers.deepgram.com/trust-security/data-privacy-compliance",
      "excerpt": "We are PCI compliant, and perform a yearly review of our standing within the framework.",
      "confidence": "high"
    },
    {
      "field": "sla_published",
      "url": "https://deepgram.com/dedicated",
      "excerpt": "Get predictable latency and 99.9% uptime, backed by enterprise-grade SLAs.",
      "confidence": "medium"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://developers.deepgram.com/docs/text-to-speech",
      "excerpt": "Aura-2 and Aura-1 models: Maximum 2,000 characters. Exceeding this triggers a 413 error.",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://developers.deepgram.com/docs/tts-models",
      "excerpt": "Aura 1 (legacy) includes 12 English voices only; Spanish, Dutch, French, German, Italian, Japanese voices are Aura-2 only",
      "confidence": "high"
    },
    {
      "field": "sandbox_available",
      "url": "https://developers.deepgram.com/docs/create-additional-api-keys",
      "excerpt": "For best results, use different API keys for testing and production. [No separate sandbox environment — testing occurs in the live environment using the $200 trial credit]",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://developers.deepgram.com/guides/fundamentals/authenticating",
      "excerpt": "For temporary/short-lived credentials, Deepgram provides a 'token-based Auth API' that allows creation of short-lived tokens for API requests instead of sharing permanent keys.",
      "confidence": "high"
    },
    {
      "field": "api_style",
      "url": "https://developers.deepgram.com/docs/text-to-speech",
      "excerpt": "API Style: REST and WebSocket interfaces for streaming text-to-speech input",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://developers.deepgram.com/docs/tts-websocket",
      "excerpt": "The Deepgram TTS WebSocket endpoint URL is wss://api.deepgram.com/v1/speak",
      "confidence": "high"
    },
    {
      "field": "versioning_scheme",
      "url": "https://developers.deepgram.com/reference/text-to-speech/speak-request",
      "excerpt": "Base URL: https://api.deepgram.com, endpoint: /v1/speak — version encoded in URL path",
      "confidence": "high"
    },
    {
      "field": "stability",
      "url": "https://www.businesswire.com/news/home/20240312857580/en/Deepgram-Launches-Aura-a-Text-to-Speech-API-for-Real-Time-Conversational-Voice-AI-Agents",
      "excerpt": "Deepgram Launches Aura, a Text-to-Speech API for Real-Time, Conversational Voice AI Agents — March 12, 2024",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/deepgram/deepgram-python-sdk",
      "excerpt": "Official Python SDK for Deepgram.",
      "confidence": "high"
    },
    {
      "field": "mcp_url",
      "url": "https://developers.deepgram.com/developer-tools/cli/mcp-server",
      "excerpt": "The MCP server is accessible at https://developers.deepgram.com/_mcp/server for AI client integration.",
      "confidence": "high"
    },
    {
      "field": "error_format",
      "url": "https://developers.deepgram.com/reference/text-to-speech/speak-request",
      "excerpt": "Three possible error response structures: 1. Text Error: Simple string 2. Legacy Error: Object with err_code, err_msg, request_id 3. Modern Error: Object with category, message, details, request_id",
      "confidence": "high"
    },
    {
      "field": "webhook_events_url",
      "url": "https://developers.deepgram.com/docs/tts-callback",
      "excerpt": "TTS Callback | Deepgram's Docs — Deepgram's callback feature enables asynchronous text-to-speech processing by accepting a callback URL parameter.",
      "confidence": "high"
    },
    {
      "field": "rate_limit_requests",
      "url": "https://developers.deepgram.com/docs/working-with-concurrency-rate-limits",
      "excerpt": "Deepgram doesn't restrict the number of requests you can send in a given time span, only the number of concurrent requests you can make.",
      "confidence": "high"
    },
    {
      "field": "requires_verification",
      "url": "https://developers.deepgram.com/docs/create-additional-api-keys",
      "excerpt": "When you sign up, we automatically create your 1st Project for you — no additional verification steps outlined between account creation and API key generation.",
      "confidence": "high"
    },
    {
      "field": "starting_price_usd",
      "url": "https://deepgram.com/pricing",
      "excerpt": "Aura-1: $0.0150/1k characters — Pay-As-You-Go rate",
      "confidence": "high"
    },
    {
      "field": "price_basis",
      "url": "https://deepgram.com/pricing",
      "excerpt": "Aura-2: $0.030/1k characters — Aura-1: $0.0150/1k characters — billed per 1,000 characters",
      "confidence": "high"
    },
    {
      "field": "launched_at",
      "url": "https://deepgram.com/learn/aura-text-to-speech-tts-api-voice-ai-agents-launch",
      "excerpt": "Aura Text-to-Speech is now generally available",
      "confidence": "high"
    },
    {
      "field": "ga_date",
      "url": "https://www.businesswire.com/news/home/20240312857580/en/Deepgram-Launches-Aura-a-Text-to-Speech-API-for-Real-Time-Conversational-Voice-AI-Agents",
      "excerpt": "Deepgram Launches Aura, a Text-to-Speech API for Real-Time, Conversational Voice AI Agents — March 12, 2024",
      "confidence": "high"
    },
    {
      "field": "notable_customers",
      "url": "https://deepgram.com/learn/introducing-aura-2-enterprise-text-to-speech",
      "excerpt": "Notable Customers: Vapi, Quiq, Call Simulator — praised integration of TTS within Deepgram's enterprise-grade infrastructure",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://developers.deepgram.com/reference/authentication",
      "excerpt": "All API requests must be made over HTTPS. Calls made over plain HTTP will fail. Requests without authentication will fail.",
      "confidence": "high"
    },
    {
      "field": "auth_docs_url",
      "url": "https://developers.deepgram.com/reference/authentication",
      "excerpt": "Authentication | Deepgram's Docs",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://developers.deepgram.com/reference/text-to-speech/speak-request",
      "excerpt": "Base URL: https://api.deepgram.com, endpoint: /v1/speak",
      "confidence": "high"
    },
    {
      "field": "api_version",
      "url": "https://developers.deepgram.com/reference/text-to-speech/speak-request",
      "excerpt": "API Version: v1 (endpoint: /v1/speak)",
      "confidence": "high"
    },
    {
      "field": "stability",
      "url": "https://deepgram.com/learn/aura-text-to-speech-tts-api-voice-ai-agents-launch",
      "excerpt": "Aura has reached general availability as of the article's publication.",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/deepgram/deepgram-js-sdk",
      "excerpt": "Official JavaScript SDK for Deepgram.",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/deepgram/deepgram-go-sdk",
      "excerpt": "Official Go SDK for Deepgram.",
      "confidence": "high"
    },
    {
      "field": "quickstart_url",
      "url": "https://developers.deepgram.com/docs/text-to-speech",
      "excerpt": "Getting Started | Deepgram's Docs — text-to-speech getting started guide",
      "confidence": "high"
    },
    {
      "field": "webhook_signing",
      "url": "https://developers.deepgram.com/docs/tts-callback",
      "excerpt": "The callback request includes a dg-token header 'automatically set to the API Key Identifier associated with the API Key used to submit the original request.'",
      "confidence": "high"
    },
    {
      "field": "rate_limit_requests",
      "url": "https://developers.deepgram.com/reference/api-rate-limits",
      "excerpt": "Text-to-Speech REST: 15 concurrent (Aura/Aura-2) — Pay as You Go plan",
      "confidence": "high"
    },
    {
      "field": "rate_limit_window",
      "url": "https://developers.deepgram.com/reference/api-rate-limits",
      "excerpt": "Rate limits apply per project, not per account or API key. If the number of in-progress requests for a project meets or exceeds the rate limit, new requests will receive a 429: Too Many Requests error.",
      "confidence": "high"
    },
    {
      "field": "data_retention_policy_url",
      "url": "https://developers.deepgram.com/trust-security/data-privacy-compliance",
      "excerpt": "Data Privacy Compliance | Deepgram's Docs — Deepgram's default configuration meets the strictest requirements with zero retention after processing.",
      "confidence": "medium"
    },
    {
      "field": "starting_price_usd",
      "url": "https://deepgram.com/learn/aura-text-to-speech-tts-api-voice-ai-agents-launch",
      "excerpt": "Pricing begins at $0.015 per 1,000 characters.",
      "confidence": "high"
    },
    {
      "field": "free_tier_limit",
      "url": "https://deepgram.com/pricing",
      "excerpt": "Free $200 Credit — no credit card required to start. Provides access to All endpoints in public models for Speech-to-Text and Text-to-Speech services.",
      "confidence": "high"
    },
    {
      "field": "launched_at",
      "url": "https://techcrunch.com/2024/03/12/deepgrams-aura-gives-ai-agents-a-voice/",
      "excerpt": "Deepgram's Aura gives AI agents a voice — March 12, 2024",
      "confidence": "high"
    },
    {
      "field": "notable_customers",
      "url": "https://deepgram.com/learn/aura-text-to-speech-tts-api-voice-ai-agents-launch",
      "excerpt": "Notable Customers in Production: Humach — Contact center solutions company; Vapi — Voice assistant development platform integrating Aura; Daily — WebRTC platform provider integrating Aura into production toolkits",
      "confidence": "high"
    }
  ],
  "fields_not_found": [
    "iso_27001",
    "minimum_commitment",
    "exact_voice_count_non_english_languages_complete_list",
    "detailed_sla_terms_beyond_99.9_uptime_for_dedicated",
    "deprecation_policy_url",
    "sla_url",
    "idempotency_supported",
    "rate_limit_requests (for WebSocket: 45 concurrent; for REST: 15 concurrent on Pay-as-You-Go)"
  ],
  "source_confidence": "high",
  "last_verified_at": "2026-06-21T00:00:00.000Z",
  "contribute": {
    "note": "This data is crowd-editable. Suggest corrections or leave a review via these endpoints - no auth required, requests are rate-limited, and every submission is reviewed before it goes live. For a field edit, {field} is any key in this response and a citation is required.",
    "endpoints": [
      {
        "action": "review",
        "label": "Leave a review or comment",
        "method": "POST",
        "url": "https://apio.sh/api/feedback/deepgram-aura",
        "example_body": {
          "kind": "review",
          "rating": 5,
          "body": "Your experience with this API…"
        }
      },
      {
        "action": "field_edit",
        "label": "Suggest a correction to a field (cite a source)",
        "method": "POST",
        "url": "https://apio.sh/api/suggest/deepgram-aura/{field}",
        "example_body": {
          "value": "corrected value",
          "citations": [
            {
              "url": "https://source.example/page",
              "excerpt": "supporting quote"
            }
          ],
          "note": "what changed and why"
        }
      },
      {
        "action": "new_api",
        "label": "Suggest a new API to add (only name is required - send as much as you can cite)",
        "method": "POST",
        "url": "https://apio.sh/api/suggest/api",
        "example_body": {
          "value": {
            "name": "Acme Email API",
            "website_url": "https://acme.example",
            "vendor_name": "Acme",
            "categories": [
              "email"
            ],
            "pricing_model": "usage_based",
            "has_published_pricing": true,
            "free_tier_available": true,
            "price_points": [
              {
                "plan": "Pay as you go",
                "item": "1,000 emails",
                "amount_usd": 1,
                "per": "1,000 emails",
                "source_url": "https://acme.example/pricing"
              }
            ],
            "soc2": "type_2",
            "docs_url": "https://docs.acme.example"
          },
          "citations": [
            {
              "url": "https://acme.example/pricing",
              "excerpt": "$1 per 1,000 emails"
            }
          ]
        },
        "value_schema": [
          {
            "field": "name",
            "type": "string",
            "label": "Product name (the only required field)"
          },
          {
            "field": "website_url",
            "type": "string",
            "label": "Marketing website URL"
          },
          {
            "field": "vendor_name",
            "type": "string",
            "label": "Company/vendor name behind the product"
          },
          {
            "field": "vendor_description",
            "type": "string",
            "label": "One-line description, quoted from the vendor"
          },
          {
            "field": "categories",
            "type": "string[]",
            "label": "Category/leaf slugs it belongs to, e.g. [\"email\",\"sms\"]"
          },
          {
            "field": "primary_use_cases",
            "type": "string[]",
            "label": "What it's used for"
          },
          {
            "field": "supported_actions",
            "type": "string[]",
            "label": "Concrete API actions/capabilities"
          },
          {
            "field": "supported_regions",
            "type": "string[]",
            "label": "Countries/regions/data-residency"
          },
          {
            "field": "supported_languages",
            "type": "string[]",
            "label": "Human/spoken languages supported"
          },
          {
            "field": "input_types",
            "type": "string[]",
            "label": "Accepted input types/formats"
          },
          {
            "field": "output_types",
            "type": "string[]",
            "label": "Produced output types/formats"
          },
          {
            "field": "webhooks_supported",
            "type": "bool",
            "label": "Supports webhooks?"
          },
          {
            "field": "sandbox_available",
            "type": "bool",
            "label": "Dedicated sandbox/test mode?"
          },
          {
            "field": "sdk_languages",
            "type": "string[]",
            "label": "Languages with an official SDK"
          },
          {
            "field": "mcp_server_available",
            "type": "bool",
            "label": "Official MCP server?"
          },
          {
            "field": "pricing_model",
            "type": "enum",
            "label": "Pricing model",
            "values": [
              "usage_based",
              "subscription",
              "seat_based",
              "hybrid",
              "contact_sales"
            ]
          },
          {
            "field": "has_published_pricing",
            "type": "bool",
            "label": "Concrete prices published publicly?"
          },
          {
            "field": "free_tier_available",
            "type": "bool",
            "label": "Recurring/perpetual free tier (not a trial)?"
          },
          {
            "field": "free_tier_details",
            "type": "string",
            "label": "What the free tier includes"
          },
          {
            "field": "minimum_commitment",
            "type": "string",
            "label": "Any stated minimum spend/commitment"
          },
          {
            "field": "self_serve_signup",
            "type": "bool",
            "label": "Get an API key without talking to sales?"
          },
          {
            "field": "requires_sales_call",
            "type": "bool",
            "label": "Does going live require sales?"
          },
          {
            "field": "enterprise_plan_available",
            "type": "bool",
            "label": "Named enterprise tier?"
          },
          {
            "field": "starting_price_usd",
            "type": "number",
            "label": "Lowest published paid entry price (USD number)"
          },
          {
            "field": "price_basis",
            "type": "string",
            "label": "Unit the starting price is per, e.g. '1,000 emails'"
          },
          {
            "field": "free_tier_limit",
            "type": "string",
            "label": "Free-tier ceiling in literal terms"
          },
          {
            "field": "price_points",
            "type": "object[]",
            "label": "Structured prices: [{plan,item,amount_usd,amount_percent,per,source_url}]"
          },
          {
            "field": "soc2",
            "type": "enum",
            "label": "SOC 2 status",
            "values": [
              "type_2",
              "type_1",
              "in_progress",
              "none",
              "unknown"
            ]
          },
          {
            "field": "hipaa",
            "type": "bool",
            "label": "HIPAA (e.g. BAA available)?"
          },
          {
            "field": "gdpr",
            "type": "bool",
            "label": "GDPR compliance stated?"
          },
          {
            "field": "iso_27001",
            "type": "bool",
            "label": "ISO 27001 certified?"
          },
          {
            "field": "pci_dss",
            "type": "bool",
            "label": "PCI DSS compliant?"
          },
          {
            "field": "sla_published",
            "type": "bool",
            "label": "Published SLA / uptime commitment?"
          },
          {
            "field": "documented_rate_limits",
            "type": "string",
            "label": "Documented rate limits, quoted"
          },
          {
            "field": "known_restrictions",
            "type": "string[]",
            "label": "Notable documented restrictions/limits"
          },
          {
            "field": "auth_methods",
            "type": "string[]",
            "label": "Auth methods",
            "values": [
              "api_key",
              "oauth2",
              "jwt",
              "basic",
              "hmac_signature",
              "mtls",
              "session"
            ]
          },
          {
            "field": "api_style",
            "type": "enum",
            "label": "Primary API style",
            "values": [
              "rest",
              "graphql",
              "grpc",
              "soap",
              "websocket"
            ]
          },
          {
            "field": "base_url",
            "type": "string",
            "label": "API root/base URL"
          },
          {
            "field": "api_version",
            "type": "string",
            "label": "Current API version string"
          },
          {
            "field": "quickstart_url",
            "type": "string",
            "label": "Quickstart / hello-world URL"
          },
          {
            "field": "docs_url",
            "type": "string",
            "label": "Developer docs URL"
          },
          {
            "field": "api_reference_url",
            "type": "string",
            "label": "API reference URL"
          },
          {
            "field": "openapi_spec_url",
            "type": "string",
            "label": "OpenAPI spec URL"
          },
          {
            "field": "changelog_url",
            "type": "string",
            "label": "Changelog URL"
          },
          {
            "field": "status_page_url",
            "type": "string",
            "label": "Status page URL"
          },
          {
            "field": "notable_customers",
            "type": "string[]",
            "label": "Named public customers"
          },
          {
            "field": "launched_at",
            "type": "string",
            "label": "Launch date (ISO date or year)"
          }
        ]
      },
      {
        "action": "token",
        "label": "Optional - raise your rate limit",
        "method": "GET",
        "url": "https://apio.sh/api/feedback/token"
      }
    ]
  }
}