{
  "name": "Nyne API Manifest",
  "version": "2026-04-16",
  "base_url": "https://api.nyne.ai",
  "llms_url": "https://api.nyne.ai/llms.txt",
  "documentation_home_url": "https://api.nyne.ai/documentation",
  "notes": [
    "Prefer markdown docs by appending .md to endpoint documentation paths.",
    "Use routing guidance instead of inferring endpoint choice from similar names like search, discover, discovery, and leads.",
    "The hosted MCP at /.well-known/mcp currently exposes a curated subset of workflows. The HTTP API surface below is broader.",
    "The local mcp-server package in this repository exposes generic tools that can call the full documented HTTP API surface."
  ],
  "status_model": {
    "in_progress": [
      "pending",
      "queued",
      "processing",
      "finding",
      "fetching",
      "analyzing",
      "enriching",
      "gathering",
      "aggregating",
      "searching",
      "discovering",
      "running",
      "started",
      "in_progress"
    ],
    "terminal_success": [
      "completed",
      "complete",
      "success",
      "succeeded"
    ],
    "terminal_failure": [
      "failed",
      "error",
      "not_found",
      "cancelled",
      "canceled",
      "timeout",
      "timed_out"
    ]
  },
  "mcp": {
    "hosted": {
      "discovery_url": "https://api.nyne.ai/.well-known/mcp",
      "manifest_url": "https://api.nyne.ai/mcp",
      "coverage": "subset",
      "supported_tools": [
        "search",
        "fetch",
        "search_people_semantic",
        "get_person_profile",
        "ask_profile",
        "check_status"
      ],
      "best_for": [
        "common person search workflows",
        "known-person enrichment",
        "profile Q&A"
      ]
    },
    "local_package": {
      "path": "mcp-server/",
      "coverage": "full_documented_http_api",
      "resources": [
        "nyne://docs/llms",
        "nyne://docs/manifest",
        "nyne://schemas/person",
        "nyne://docs/rate-limits"
      ]
    }
  },
  "routing": [
    {
      "task": "Known person from email, phone, or LinkedIn URL",
      "use": "person_enrichment"
    },
    {
      "task": "Recent social posts or activity",
      "use": "person_newsfeed"
    },
    {
      "task": "Explainable psychographics or interests",
      "use": "person_interests"
    },
    {
      "task": "Natural-language Q&A about a known person",
      "use": "person_ask"
    },
    {
      "task": "Full person dossier",
      "use": "person_deep_research"
    },
    {
      "task": "Natural-language people search",
      "use": "person_search"
    },
    {
      "task": "Keyword and location people discovery",
      "use": "person_discover"
    },
    {
      "task": "Open-web people discovery with structured requirements and citations",
      "use": "person_discovery"
    },
    {
      "task": "Social-post-driven lead generation",
      "use": "person_leads"
    },
    {
      "task": "Known company from domain, email, phone, or LinkedIn URL",
      "use": "company_enrichment"
    },
    {
      "task": "Open-web company discovery with structured requirements and citations",
      "use": "company_discovery"
    },
    {
      "task": "Company pain points from filings",
      "use": "company_needs"
    },
    {
      "task": "Company funding history",
      "use": "company_funding"
    },
    {
      "task": "Investor or fund lookup",
      "use": "company_funders"
    }
  ],
  "endpoints": [
    {
      "id": "person_enrichment",
      "category": "person",
      "path": "/person/enrichment",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Look up a known person from email, phone, or social profile URL.",
      "best_for": "Known-contact enrichment before downstream person or company analysis.",
      "required_inputs": [
        "email | phone | social_media_url"
      ],
      "result_path": "data.result",
      "docs_url_html": "https://api.nyne.ai/documentation/person/enrichment",
      "docs_url_md": "https://api.nyne.ai/documentation/person/enrichment.md",
      "related": [
        "person_newsfeed",
        "person_interests",
        "company_enrichment"
      ]
    },
    {
      "id": "person_search",
      "category": "person",
      "path": "/person/search",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Natural-language people search with pagination and optional result-quality flags.",
      "best_for": "Searching for contacts by a freeform query.",
      "required_inputs": [
        "query | cursor | request_id"
      ],
      "result_path": "data.results",
      "docs_url_html": "https://api.nyne.ai/documentation/person/search",
      "docs_url_md": "https://api.nyne.ai/documentation/person/search.md",
      "related": [
        "person_discover",
        "person_discovery",
        "person_leads"
      ]
    },
    {
      "id": "person_newsfeed",
      "category": "person",
      "path": "/person/newsfeed",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Fetch recent social posts and activity from a person profile URL.",
      "best_for": "Recent messaging context and social activity.",
      "required_inputs": [
        "social_media_url"
      ],
      "result_path": "data.result.newsfeed",
      "docs_url_html": "https://api.nyne.ai/documentation/person/newsfeed",
      "docs_url_md": "https://api.nyne.ai/documentation/person/newsfeed.md",
      "related": [
        "person_interests",
        "person_interactions"
      ]
    },
    {
      "id": "person_events",
      "category": "person",
      "path": "/person/events",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Discover event, conference, and appearance intelligence for a person.",
      "best_for": "Event-based outreach context.",
      "required_inputs": [
        "email | phone | social_media_url | name"
      ],
      "result_path": "data.result",
      "docs_url_html": "https://api.nyne.ai/documentation/person/events",
      "docs_url_md": "https://api.nyne.ai/documentation/person/events.md",
      "related": [
        "person_articlesearch",
        "person_deep_research"
      ]
    },
    {
      "id": "person_social_profiles",
      "category": "person",
      "path": "/person/social-profiles",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Resolve social accounts for a known person.",
      "best_for": "Finding profile URLs before newsfeed or interest analysis.",
      "required_inputs": [
        "email | phone | social_media_url | name"
      ],
      "result_path": "data.result",
      "docs_url_html": "https://api.nyne.ai/documentation/person/social-profiles",
      "docs_url_md": "https://api.nyne.ai/documentation/person/social-profiles.md",
      "related": [
        "person_newsfeed",
        "person_single_social_lookup"
      ]
    },
    {
      "id": "person_interests",
      "category": "person",
      "path": "/person/interests",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Build an attribution-based interest and psychographic profile.",
      "best_for": "Explainable persona, psychographic, and interest analysis.",
      "required_inputs": [
        "email | phone | social_media_url | name"
      ],
      "result_path": "data.result",
      "docs_url_html": "https://api.nyne.ai/documentation/person/interests",
      "docs_url_md": "https://api.nyne.ai/documentation/person/interests.md",
      "related": [
        "person_newsfeed",
        "person_deep_research"
      ]
    },
    {
      "id": "person_interactions",
      "category": "person",
      "path": "/person/interactions",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Analyze interaction and engagement patterns across a person's social graph.",
      "best_for": "Social relationship and engagement analysis.",
      "required_inputs": [
        "social_media_url | email | phone"
      ],
      "result_path": "data.result",
      "docs_url_html": "https://api.nyne.ai/documentation/person/interactions",
      "docs_url_md": "https://api.nyne.ai/documentation/person/interactions.md",
      "related": [
        "person_newsfeed",
        "person_interests"
      ]
    },
    {
      "id": "person_articlesearch",
      "category": "person",
      "path": "/person/articlesearch",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Search articles, media mentions, and related public-web coverage for a person.",
      "best_for": "Press and media context.",
      "required_inputs": [
        "name | social_media_url | email"
      ],
      "result_path": "data.results",
      "docs_url_html": "https://api.nyne.ai/documentation/person/articlesearch",
      "docs_url_md": "https://api.nyne.ai/documentation/person/articlesearch.md",
      "related": [
        "person_events",
        "person_deep_research"
      ]
    },
    {
      "id": "person_deep_research",
      "category": "person",
      "path": "/person/deep-research",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Generate a multi-source intelligence dossier on a person.",
      "best_for": "Full prospect briefs when latency and credit cost are acceptable.",
      "required_inputs": [
        "email | phone | social_media_url | name+company | name+city"
      ],
      "result_path": "data.result",
      "docs_url_html": "https://api.nyne.ai/documentation/person/deep-research",
      "docs_url_md": "https://api.nyne.ai/documentation/person/deep-research.md",
      "related": [
        "person_enrichment",
        "person_interests",
        "person_articlesearch"
      ]
    },
    {
      "id": "person_discovery",
      "category": "person",
      "path": "/person/discovery",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Open-web people discovery using natural-language queries, requirements, and citations.",
      "best_for": "Finding candidates that must satisfy explicit requirements with explainable evidence.",
      "required_inputs": [
        "query"
      ],
      "result_path": "data.results",
      "docs_url_html": "https://api.nyne.ai/documentation/person/discovery",
      "docs_url_md": "https://api.nyne.ai/documentation/person/discovery.md",
      "related": [
        "person_search",
        "person_discover"
      ]
    },
    {
      "id": "person_discover",
      "category": "person",
      "path": "/person/discover",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Keyword and location based people discovery.",
      "best_for": "Prospecting when you know the role or keyword pattern and geography.",
      "required_inputs": [
        "keywords"
      ],
      "result_path": "data.results",
      "docs_url_html": "https://api.nyne.ai/documentation/person/discover",
      "docs_url_md": "https://api.nyne.ai/documentation/person/discover.md",
      "related": [
        "person_search",
        "person_discovery"
      ]
    },
    {
      "id": "person_leads",
      "category": "person",
      "path": "/person/leads",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Generate lead lists from social activity and related criteria.",
      "best_for": "Lead generation workflows tied to social intent or activity.",
      "required_inputs": [
        "see endpoint docs"
      ],
      "result_path": "data.results",
      "docs_url_html": "https://api.nyne.ai/documentation/person/leads",
      "docs_url_md": "https://api.nyne.ai/documentation/person/leads.md",
      "related": [
        "person_search",
        "person_discover"
      ]
    },
    {
      "id": "person_ask",
      "category": "person",
      "path": "/person/ask",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Answer a natural-language question about a person.",
      "best_for": "Question answering over a known person instead of composing custom logic client-side.",
      "required_inputs": [
        "question",
        "email | phone | social_media_url"
      ],
      "result_path": "data.result",
      "docs_url_html": "https://api.nyne.ai/documentation/person/ask",
      "docs_url_md": "https://api.nyne.ai/documentation/person/ask.md",
      "related": [
        "person_enrichment",
        "person_deep_research"
      ]
    },
    {
      "id": "person_simulation",
      "category": "person",
      "path": "/person/simulation",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Simulate conversations or outreach based on a person profile.",
      "best_for": "Testing messaging hypotheses and persona simulation.",
      "required_inputs": [
        "email | phone | social_media_url | name"
      ],
      "result_path": "data.result",
      "docs_url_html": "https://api.nyne.ai/documentation/person/simulation",
      "docs_url_md": "https://api.nyne.ai/documentation/person/simulation.md",
      "related": [
        "person_enrichment",
        "person_ask"
      ]
    },
    {
      "id": "person_single_social_lookup",
      "category": "person",
      "path": "/person/single-social-lookup",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Resolve a single social profile from a URL or identifier.",
      "best_for": "Normalizing one social identity before downstream social APIs.",
      "required_inputs": [
        "social_media_url"
      ],
      "result_path": "data.result",
      "docs_url_html": "https://api.nyne.ai/documentation/person/single-social-lookup",
      "docs_url_md": "https://api.nyne.ai/documentation/person/single-social-lookup.md",
      "related": [
        "person_social_profiles",
        "person_newsfeed"
      ]
    },
    {
      "id": "person_competitor_engagements",
      "category": "person",
      "path": "/person/competitor-engagements",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Track competitor engagement activity for a person.",
      "best_for": "Competitive intelligence on prospect behavior.",
      "required_inputs": [
        "social_media_url | email | phone"
      ],
      "result_path": "data.results",
      "docs_url_html": "https://api.nyne.ai/documentation/person/competitor-engagements",
      "docs_url_md": "https://api.nyne.ai/documentation/person/competitor-engagements.md",
      "related": [
        "person_newsfeed",
        "person_interactions"
      ]
    },
    {
      "id": "company_enrichment",
      "category": "company",
      "path": "/company/enrichment",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Enrich a known company from domain, email, phone, or LinkedIn URL.",
      "best_for": "Anchoring a company before company-level intelligence workflows.",
      "required_inputs": [
        "domain | email | phone | social_media_url"
      ],
      "result_path": "data.result",
      "docs_url_html": "https://api.nyne.ai/documentation/company/enrichment",
      "docs_url_md": "https://api.nyne.ai/documentation/company/enrichment.md",
      "related": [
        "company_search",
        "company_needs",
        "company_funding"
      ]
    },
    {
      "id": "company_search",
      "category": "company",
      "path": "/company/search",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Search for companies by name, industry, location, or keywords.",
      "best_for": "Company lookup before enrichment or deeper company workflows.",
      "required_inputs": [
        "see endpoint docs"
      ],
      "result_path": "data.results",
      "docs_url_html": "https://api.nyne.ai/documentation/company/search",
      "docs_url_md": "https://api.nyne.ai/documentation/company/search.md",
      "related": [
        "company_enrichment",
        "company_discovery"
      ]
    },
    {
      "id": "company_needs",
      "category": "company",
      "path": "/company/needs",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Summarize pain points, challenges, or requested topics from company filings.",
      "best_for": "Sales intelligence and pain-point research.",
      "required_inputs": [
        "company_name",
        "content"
      ],
      "result_path": "data.result",
      "docs_url_html": "https://api.nyne.ai/documentation/company/needs",
      "docs_url_md": "https://api.nyne.ai/documentation/company/needs.md",
      "related": [
        "company_enrichment",
        "company_funding"
      ]
    },
    {
      "id": "company_checkseller",
      "category": "company",
      "path": "/company/checkseller",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Check whether a company appears to be a seller or vendor candidate.",
      "best_for": "Seller-vendor screening workflows.",
      "required_inputs": [
        "see endpoint docs"
      ],
      "result_path": "data.result",
      "docs_url_html": "https://api.nyne.ai/documentation/company/checkseller",
      "docs_url_md": "https://api.nyne.ai/documentation/company/checkseller.md",
      "related": [
        "company_checkfeature",
        "company_enrichment"
      ]
    },
    {
      "id": "company_checkfeature",
      "category": "company",
      "path": "/company/checkfeature",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Check whether a company appears to use a feature or technology.",
      "best_for": "Technographic and feature-adoption checks.",
      "required_inputs": [
        "see endpoint docs"
      ],
      "result_path": "data.result",
      "docs_url_html": "https://api.nyne.ai/documentation/company/checkfeature",
      "docs_url_md": "https://api.nyne.ai/documentation/company/checkfeature.md",
      "related": [
        "company_checkseller",
        "company_enrichment"
      ]
    },
    {
      "id": "company_funding",
      "category": "company",
      "path": "/company/funding",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Retrieve company funding rounds, investors, and valuations.",
      "best_for": "Fundraising and investor context.",
      "required_inputs": [
        "company_name | company_domain"
      ],
      "result_path": "data.result",
      "docs_url_html": "https://api.nyne.ai/documentation/company/funding",
      "docs_url_md": "https://api.nyne.ai/documentation/company/funding.md",
      "related": [
        "company_funders",
        "company_enrichment"
      ]
    },
    {
      "id": "company_funders",
      "category": "company",
      "path": "/company/funders",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Look up investors, venture firms, and fund profiles.",
      "best_for": "Investor diligence and fund research.",
      "required_inputs": [
        "company_name | company_domain"
      ],
      "result_path": "data.result",
      "docs_url_html": "https://api.nyne.ai/documentation/company/funders",
      "docs_url_md": "https://api.nyne.ai/documentation/company/funders.md",
      "related": [
        "company_funding"
      ]
    },
    {
      "id": "company_discovery",
      "category": "company",
      "path": "/company/discovery",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Open-web company discovery using natural-language queries, requirements, and citations.",
      "best_for": "Finding companies that must satisfy structured requirements with explainable evidence.",
      "required_inputs": [
        "query"
      ],
      "result_path": "data.results",
      "docs_url_html": "https://api.nyne.ai/documentation/company/discovery",
      "docs_url_md": "https://api.nyne.ai/documentation/company/discovery.md",
      "related": [
        "company_search",
        "company_enrichment"
      ]
    }
  ]
}