{
  "name": "You.com Search API",
  "slug": "you-search",
  "website_url": "https://you.com/apis",
  "vendor_description": "\"Real-Time Web Intelligence for AI Apps\"",
  "categories": [
    "web-search"
  ],
  "summary": "You.com Search API provides real-time web search, news retrieval, and AI-grounded research capabilities designed for RAG pipelines, LLM agents, and agentic applications. Pricing starts at $5 per 1,000 searches on a usage-based model, with $100 in complimentary credits on signup and a free unauthenticated tier of 100 queries per day. The REST API supports Python and TypeScript SDKs, an MCP server, and both API key and OAuth2 authentication, and is SOC 2 Type 2 certified with GDPR compliance. Customers include Amazon, Databricks, DuckDuckGo, Bank of America, Harvey, and Windsurf.",
  "capabilities": {
    "supported_actions": [
      "web_search",
      "news_search",
      "image_search",
      "get_contents",
      "research_with_citations",
      "finance_research",
      "express_agent",
      "custom_agent",
      "account_balance"
    ],
    "supported_regions": [
      "global",
      "37 supported country filter codes (e.g. US, GB, IN)"
    ],
    "supported_languages": [
      "BCP 47 language codes supported as query/result filter; default EN"
    ],
    "input_types": [
      "natural language query",
      "search operators",
      "URL (for contents API)",
      "structured JSON (research API)",
      "domain allowlist/blocklist filters",
      "country code",
      "freshness date range"
    ],
    "output_types": [
      "JSON",
      "Markdown",
      "raw HTML",
      "cited answer text",
      "web result snippets",
      "news result snippets",
      "structured JSON (via output_schema)",
      "image results"
    ],
    "webhooks_supported": false,
    "sandbox_available": false,
    "sdk_languages": [
      "Python",
      "TypeScript"
    ],
    "mcp_server_available": true
  },
  "integration": {
    "api_style": "rest",
    "base_url": "https://ydc-index.io",
    "api_version": "v1",
    "versioning_scheme": "url",
    "stability": "ga",
    "deprecation_policy_url": null,
    "auth_methods": [
      "api_key",
      "oauth2"
    ],
    "auth_docs_url": "https://you.com/docs/quickstart",
    "idempotency_supported": null,
    "error_format": "vendor-specific",
    "webhook_signing": null,
    "webhook_events_url": null,
    "rate_limit_requests": 100,
    "rate_limit_window": "day",
    "sdk_packages": [
      {
        "package": "youdotcom",
        "language": "Python",
        "official": true,
        "repo_url": "https://github.com/youdotcom-oss/youdotcom-python-sdk"
      },
      {
        "package": "@youdotcom-oss/sdk",
        "language": "TypeScript",
        "official": true,
        "repo_url": "https://github.com/youdotcom-oss/youdotcom-typescript-sdk"
      },
      {
        "package": "@youdotcom-oss/mcp",
        "language": "TypeScript",
        "official": true,
        "repo_url": "https://github.com/youdotcom-oss/agent-skills"
      }
    ],
    "mcp_url": "https://api.you.com/mcp",
    "quickstart_url": "https://you.com/docs/quickstart"
  },
  "pricing": {
    "pricing_model": "usage_based",
    "has_published_pricing": true,
    "starting_price_usd": "5.0000",
    "price_basis": "1,000 searches",
    "free_tier_available": false,
    "free_tier_limit": "100 queries/day (no API key); $100 complimentary credits on signup",
    "free_tier_details": "$100 in complimentary credits for new accounts (one-time signup credit, not a recurring monthly allowance). An unauthenticated MCP profile limited to 100 queries/day and restricted to web search only also exists but is likewise not a recurring free allowance.",
    "minimum_commitment": null,
    "self_serve_signup": true,
    "requires_sales_call": false,
    "requires_verification": false,
    "enterprise_plan_available": true,
    "price_points": [
      {
        "plan": null,
        "item": "Web Search API calls",
        "amount_usd": "5.0000",
        "amount_percent": null,
        "per": "1,000 calls",
        "currency": "USD",
        "source_url": "https://you.com/pricing"
      },
      {
        "plan": null,
        "item": "Contents API pages",
        "amount_usd": "1.0000",
        "amount_percent": null,
        "per": "1,000 pages",
        "currency": "USD",
        "source_url": "https://you.com/pricing"
      },
      {
        "plan": "Lite",
        "item": "Research API calls",
        "amount_usd": "12.0000",
        "amount_percent": null,
        "per": "1,000 calls",
        "currency": "USD",
        "source_url": "https://you.com/resources/research-api-by-you-com"
      },
      {
        "plan": "Standard",
        "item": "Research API calls",
        "amount_usd": "50.0000",
        "amount_percent": null,
        "per": "1,000 calls",
        "currency": "USD",
        "source_url": "https://you.com/resources/research-api-by-you-com"
      },
      {
        "plan": "Deep",
        "item": "Research API calls",
        "amount_usd": "100.0000",
        "amount_percent": null,
        "per": "1,000 calls",
        "currency": "USD",
        "source_url": "https://you.com/resources/research-api-by-you-com"
      },
      {
        "plan": "Exhaustive",
        "item": "Research API calls",
        "amount_usd": "450.0000",
        "amount_percent": null,
        "per": "1,000 calls",
        "currency": "USD",
        "source_url": "https://you.com/resources/research-api-by-you-com"
      },
      {
        "plan": "Deep",
        "item": "Finance Research API calls",
        "amount_usd": "110.0000",
        "amount_percent": null,
        "per": "1,000 calls",
        "currency": "USD",
        "source_url": "https://you.com/resources/introducing-the-finance-research-api-agentic-research-no-infra-required"
      },
      {
        "plan": "Exhaustive",
        "item": "Finance Research API calls",
        "amount_usd": "500.0000",
        "amount_percent": null,
        "per": "1,000 calls",
        "currency": "USD",
        "source_url": "https://you.com/resources/introducing-the-finance-research-api-agentic-research-no-infra-required"
      },
      {
        "plan": null,
        "item": "Livecrawl add-on (full page content via Search API)",
        "amount_usd": "1.0000",
        "amount_percent": null,
        "per": "1,000 pages",
        "currency": "USD",
        "source_url": "https://you.com/docs/api-reference/search/v1-search"
      }
    ]
  },
  "compliance": {
    "soc2": "type_2",
    "hipaa": false,
    "gdpr": true,
    "iso_27001": null,
    "pci_dss": null,
    "sla_published": true,
    "sla_url": "https://home.you.com/web-search-api",
    "data_retention_policy_url": "https://you.com/privacy",
    "documented_rate_limits": "100 queries per day on free/unauthenticated MCP tier; paid authenticated tier rate limits not publicly published; enterprise customers get custom QPS limits.",
    "known_restrictions": [
      "include_domains and exclude_domains are mutually exclusive",
      "include_domains and boost_domains are mutually exclusive",
      "domain filter lists capped at 500 entries each",
      "output_schema (structured JSON) incompatible with 'lite' research_effort tier",
      "Research API input limited to 40,000 characters",
      "Frontier research tier (>$2000/1K calls) requires direct contact with You.com",
      "GET requests to search endpoint are cached; POST requests are not",
      "you-contents, you-research, and you-finance APIs require a paid API key (not available on free unauthenticated MCP tier)"
    ]
  },
  "developer": {
    "docs_url": "https://docs.you.com",
    "api_reference_url": "https://docs.you.com/docs/api-reference/search/v1-search",
    "openapi_spec_url": "https://docs.you.com/openapi.json",
    "postman_collection_url": null,
    "changelog_url": null,
    "status_page_url": null,
    "llms_txt_url": "https://docs.you.com/llms.txt",
    "markdown_docs_url": null,
    "rendering": "static"
  },
  "adoption": {
    "launched_at": "2023-11-14",
    "ga_date": "2023-11-14",
    "github_stars": null,
    "github_stars_at": null,
    "notable_customers": [
      "DuckDuckGo",
      "Harvey",
      "Windsurf",
      "Databricks",
      "Amazon",
      "Bank of America"
    ]
  },
  "scores": {
    "agent_friendliness": 80,
    "pricing_transparency": 85,
    "setup_speed": 55,
    "docs_quality": 65,
    "procurement_friction": 85,
    "trust_readiness": 60,
    "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": "vendor_description",
      "url": "https://you.com/apis",
      "excerpt": "Real-Time Web Intelligence for AI Apps",
      "confidence": "high"
    },
    {
      "field": "supported_actions",
      "url": "https://you.com/docs/build-with-agents/mcp-server",
      "excerpt": "you-search, you-contents, you-research, you-finance (optional) - Finance-optimized research covering company fundamentals, equity/commodity pricing, SEC filings, and financial news",
      "confidence": "high"
    },
    {
      "field": "supported_actions",
      "url": "https://you.com/docs/llms.txt",
      "excerpt": "Search API - Get structured, LLM-optimized search results from web and news sources; Contents API - Extract clean HTML or Markdown content from any webpage on demand; Research API - Get thorough, well-cited answers to complex questions; Finance Research API; Live News API; Images API; Account Balance (Billing); Express Agent; Custom Agent; Advanced Agent",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://you.com/pricing",
      "excerpt": "$5.00 per 1,000 calls ... Pay-as-you-go: No minimums required; Volume discounts: Lower rates as usage increases",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://you.com/resources/lower-search-api-cost",
      "excerpt": "Web Search API: Current rate: $5 per 1,000 calls; Contents API: Current rate: $1 per 1,000 pages",
      "confidence": "high"
    },
    {
      "field": "has_published_pricing",
      "url": "https://you.com/pricing",
      "excerpt": "Search API: $5.00 per 1,000 calls; Contents API: $1.00 per 1,000 pages; Research API Lite: $12.00 per 1,000 calls; Finance Research API Deep tier: $110.00 per 1,000 calls",
      "confidence": "high"
    },
    {
      "field": "has_published_pricing",
      "url": "https://you.com/resources/research-api-by-you-com",
      "excerpt": "Pricing is fixed per tier. Lite $12.00, Standard $50.00, Deep $100.00, Exhaustive $450.00 per 1,000 requests. Frontier tier: Contact You.com",
      "confidence": "high"
    },
    {
      "field": "free_tier_available",
      "url": "https://you.com/apis",
      "excerpt": "$100 in complimentary credits",
      "confidence": "high"
    },
    {
      "field": "free_tier_available",
      "url": "https://you.com/resources/lower-search-api-cost",
      "excerpt": "New developers receive $100 in free credits to begin development. No credit card is required for signup",
      "confidence": "high"
    },
    {
      "field": "quickstart_url",
      "url": "https://you.com/docs/quickstart",
      "excerpt": "You.com API Quickstart | Search, Contents & Research APIs for AI Applications",
      "confidence": "high"
    },
    {
      "field": "sandbox_available",
      "url": "https://you.com/docs/build-with-agents/mcp-server",
      "excerpt": "connect to https://api.you.com/mcp?profile=free and use you-search with no API key. Limited to 100 queries per day.",
      "confidence": "high"
    },
    {
      "field": "mcp_server_available",
      "url": "https://you.com/docs/build-with-agents/mcp-server",
      "excerpt": "MCP Server URL: https://api.you.com/mcp",
      "confidence": "high"
    },
    {
      "field": "mcp_server_available",
      "url": "https://you.com/resources/october-2025-api-roundup",
      "excerpt": "Model Context Protocol (MCP) server, bringing comprehensive web search capabilities to your agentic IDE",
      "confidence": "high"
    },
    {
      "field": "sdk_languages",
      "url": "https://you.com/resources/november-2025-api-roundup",
      "excerpt": "Python SDK (v0) ... Covers Search, Content, News, and Agent APIs ... Available on PyPI",
      "confidence": "high"
    },
    {
      "field": "sdk_languages",
      "url": "https://you.com/docs/llms.txt",
      "excerpt": "Python SDK; TypeScript SDK; MCP Server integration; Framework integrations (LangChain, crewAI, Vercel AI, etc.)",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://home.you.com/security",
      "excerpt": "SOC 2 Type 2 Compliant badge displayed. The You.com Platform undergoes an annual third-party security assessments.",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://you.com/pricing",
      "excerpt": "SOC 2 certified",
      "confidence": "high"
    },
    {
      "field": "hipaa",
      "url": "https://home.you.com/security",
      "excerpt": "You.com supports our customers' compliance with privacy laws, including GDPR and CCPA. HIPAA not mentioned.",
      "confidence": "high"
    },
    {
      "field": "hipaa",
      "url": "https://you.com/privacy",
      "excerpt": "please do not enter such sensitive personal information in prompts or otherwise share such information that could enter our systems",
      "confidence": "high"
    },
    {
      "field": "gdpr",
      "url": "https://home.you.com/security",
      "excerpt": "You.com supports our customers' compliance with privacy laws, including GDPR and CCPA.",
      "confidence": "high"
    },
    {
      "field": "gdpr",
      "url": "https://you.com/privacy",
      "excerpt": "You.com is a joint controller under GDPR and UK GDPR. Standard GDPR rights including access, rectification, erasure, consent withdrawal, and data portability are documented.",
      "confidence": "high"
    },
    {
      "field": "enterprise_plan_available",
      "url": "https://you.com/enterprise-ai-solutions",
      "excerpt": "SOC 2 certified; Zero Data Retention policy explicitly stated; Enterprise-grade security infrastructure; White-glove onboarding and production support included",
      "confidence": "high"
    },
    {
      "field": "enterprise_plan_available",
      "url": "https://you.com/pricing",
      "excerpt": "Custom QPS limits for high-volume usage; Volume discounts and annual commitment savings offered; Zero data retention options",
      "confidence": "high"
    },
    {
      "field": "sla_published",
      "url": "https://home.you.com/web-search-api",
      "excerpt": "99.9% uptime SLA guaranteed",
      "confidence": "high"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://you.com/docs/build-with-agents/mcp-server",
      "excerpt": "Rate Limits: 100 queries per day for the free tier",
      "confidence": "high"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://you.com/apis",
      "excerpt": "Limited to 100 queries per day",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://you.com/docs/api-reference/search/v1-search",
      "excerpt": "Domain parameter conflicts: Cannot combine include_domains with boost_domains; cannot mix include_domains with exclude_domains; GET requests are cached; POST requests are not; Livecrawl adds $1.00 per 1,000 pages",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://you.com/docs/api-reference/research/v1-research",
      "excerpt": "output_schema incompatible with 'lite' effort level; Input limited to 40,000 characters; max 5 nesting depth, 100 total properties, 25,000 character budget",
      "confidence": "high"
    },
    {
      "field": "input_types",
      "url": "https://you.com/docs/api-reference/search/v1-search",
      "excerpt": "query (string, required): Search terms; supports search operators; country: Two-letter country code; language: BCP 47 format; freshness: day, week, month, year, or date range; include_domains / exclude_domains / boost_domains: Comma-separated (max 500)",
      "confidence": "high"
    },
    {
      "field": "input_types",
      "url": "https://you.com/docs/api-reference/research/v1-research",
      "excerpt": "input (string, required): Research question; max 40,000 characters",
      "confidence": "high"
    },
    {
      "field": "output_types",
      "url": "https://you.com/docs/api-reference/search/v1-search",
      "excerpt": "results.web: Array of web result objects (title, url, description, snippets, page_age, etc.); results.news: Array of news result objects; metadata: Search UUID, original query, latency in seconds",
      "confidence": "high"
    },
    {
      "field": "output_types",
      "url": "https://you.com/docs/api-reference/research/v1-research",
      "excerpt": "content: Markdown string with numbered citations (default) or JSON object (if output_schema specified); sources: Array with URL, title, and relevant snippets from each source",
      "confidence": "high"
    },
    {
      "field": "self_serve_signup",
      "url": "https://you.com/resources/lower-search-api-cost",
      "excerpt": "No credit card is required for signup, and existing credits carry over to the new pricing structure.",
      "confidence": "high"
    },
    {
      "field": "webhooks_supported",
      "url": "https://you.com/docs/llms.txt",
      "excerpt": "REST API with OpenAPI specification (JSON/YAML available); Python SDK; TypeScript SDK; MCP Server integration",
      "confidence": "medium"
    },
    {
      "field": "base_url",
      "url": "https://you.com/docs/api-reference/search/v1-search",
      "excerpt": "GET https://ydc-index.io/v1/search",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://you.com/docs/quickstart",
      "excerpt": "Make authenticated requests with `X-API-Key` header",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://you.com/docs/build-with-agents/mcp-server",
      "excerpt": "Bearer token (API key from you.com/platform) ... OAuth 2.1 (automatic flow, no API key needed)",
      "confidence": "high"
    },
    {
      "field": "api_version",
      "url": "https://you.com/docs/api-reference/search/v1-search",
      "excerpt": "GET https://ydc-index.io/v1/search",
      "confidence": "high"
    },
    {
      "field": "versioning_scheme",
      "url": "https://you.com/docs/quickstart",
      "excerpt": "Search API: `https://ydc-index.io/v1/search` ... versioning Scheme: Path-based versioning (v1)",
      "confidence": "high"
    },
    {
      "field": "mcp_url",
      "url": "https://you.com/docs/build-with-agents/mcp-server",
      "excerpt": "MCP Server URL: `https://api.you.com/mcp`",
      "confidence": "high"
    },
    {
      "field": "mcp_url",
      "url": "https://you.com/resources/october-2025-api-roundup",
      "excerpt": "MCP Launch Date: October 15, 2025",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/youdotcom-oss/youdotcom-python-sdk",
      "excerpt": "A type-safe Python SDK for the You.com API ... pip install youdotcom",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/youdotcom-oss/youdotcom-typescript-sdk",
      "excerpt": "The official You.com TypeScript SDK ... npm add @youdotcom-oss/sdk",
      "confidence": "high"
    },
    {
      "field": "rate_limit_requests",
      "url": "https://you.com/docs/build-with-agents/mcp-server",
      "excerpt": "Free tier limited to \"100 queries per day\"; authenticated users receive higher limits",
      "confidence": "high"
    },
    {
      "field": "rate_limit_window",
      "url": "https://you.com/docs/build-with-agents/mcp-server",
      "excerpt": "connect to `https://api.you.com/mcp?profile=free` and use `you-search` with no API key. Limited to 100 queries per day.",
      "confidence": "high"
    },
    {
      "field": "starting_price_usd",
      "url": "https://you.com/pricing",
      "excerpt": "$5.00 per 1,000 calls ... Includes up to 100 URLs per call and News Search endpoint",
      "confidence": "high"
    },
    {
      "field": "starting_price_usd",
      "url": "https://you.com/resources/lower-search-api-cost",
      "excerpt": "Web Search API (1-50 results): Previous $6.25/1K requests | Current $5.00/1K requests ... All usage starting March 12, 2026 is billed at the new rates.",
      "confidence": "high"
    },
    {
      "field": "price_basis",
      "url": "https://you.com/pricing",
      "excerpt": "$5.00 per 1,000 calls",
      "confidence": "high"
    },
    {
      "field": "free_tier_limit",
      "url": "https://you.com/pricing",
      "excerpt": "$100 free credit to get started across all APIs ... No minimum commitments required",
      "confidence": "high"
    },
    {
      "field": "free_tier_limit",
      "url": "https://you.com/docs/build-with-agents/mcp-server",
      "excerpt": "Free tier at `https://api.you.com/mcp?profile=free` (search only, 100 queries/day)",
      "confidence": "high"
    },
    {
      "field": "launched_at",
      "url": "https://medium.com/@you.com/introducing-the-you-api-web-scale-search-for-llms-3617c5712e16",
      "excerpt": "Launch Date: November 20, 2023",
      "confidence": "high"
    },
    {
      "field": "launched_at",
      "url": "https://www.businesswire.com/news/home/20231114112050/en/You.com-Launches-API-for-Web-Search-and-Retrieval-Augmented-Generation-Giving-AI-Chatbots-And-Large-Language-Models-Real-Time-Web-Access-And-Unparalleled-Accuracy",
      "excerpt": "You.com Launches API for Web Search and Retrieval Augmented Generation ... [dated November 14, 2023]",
      "confidence": "high"
    },
    {
      "field": "ga_date",
      "url": "https://medium.com/@you.com/introducing-the-you-api-web-scale-search-for-llms-3617c5712e16",
      "excerpt": "Launch Date: November 20, 2023",
      "confidence": "medium"
    },
    {
      "field": "notable_customers",
      "url": "https://home.you.com/web-search-api",
      "excerpt": "Specific clients include: Amazon, Bank of America, DuckDuckGo, Databricks, Harvey, and Windsurf",
      "confidence": "high"
    },
    {
      "field": "notable_customers",
      "url": "https://pulse2.com/you-com-profile-saahil-jain-interview/",
      "excerpt": "DuckDuckGo ... Harvey ... Windsurf ... Databricks ... OpenAI (default search provider for open-weight GPT models)",
      "confidence": "high"
    },
    {
      "field": "error_format",
      "url": "https://you.com/docs/api-reference/search/v1-search",
      "excerpt": "401 Unauthorized: {\"detail\": \"error message\"} ... 422 Unprocessable Entity: {\"error\": \"error message\"} ... 500 Internal Server Error: {\"detail\": \"error message\"}",
      "confidence": "high"
    },
    {
      "field": "stability",
      "url": "https://you.com/resources/november-2025-api-roundup",
      "excerpt": "Python SDK (v0) is the first version released, available via PyPI ... Databricks is mentioned as a launch partner for the MCP Marketplace",
      "confidence": "medium"
    },
    {
      "field": "sla_url",
      "url": "https://home.you.com/web-search-api",
      "excerpt": "99.9% uptime SLA guaranteed ... SOC2 Certified: Infrastructure independently audited for data security, privacy, and availability standards",
      "confidence": "medium"
    },
    {
      "field": "data_retention_policy_url",
      "url": "https://you.com/privacy",
      "excerpt": "we may retain certain information for legitimate business purposes or to comply with legal or regulatory obligations ... This data will not be used for developing, improving, or training third party AI and/or ML models",
      "confidence": "high"
    },
    {
      "field": "requires_verification",
      "url": "https://you.com/docs/quickstart",
      "excerpt": "Initial Credits: $100 complimentary credits (no credit card required) ... No explicit verification requirements mentioned beyond account creation and API key generation",
      "confidence": "high"
    }
  ],
  "fields_not_found": [
    "iso_27001",
    "pci_dss",
    "specific QPS/concurrency rate limits for paid tiers",
    "Frontier tier per-1K pricing (contact sales)",
    "formal published SLA document URL",
    "deprecation_policy_url",
    "rate_limit_requests (paid tier specific numbers)",
    "idempotency_supported",
    "webhook_signing",
    "webhook_events_url"
  ],
  "source_confidence": "high",
  "last_verified_at": "2026-06-14T00: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/you-search",
        "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/you-search/{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",
        "method": "POST",
        "url": "https://apio.sh/api/suggest/api",
        "example_body": {
          "value": {
            "name": "Acme API",
            "website_url": "https://acme.example"
          },
          "citations": [
            {
              "url": "https://acme.example"
            }
          ]
        }
      },
      {
        "action": "token",
        "label": "Optional - raise your rate limit",
        "method": "GET",
        "url": "https://apio.sh/api/feedback/token"
      }
    ]
  }
}