{
  "name": "Nyne.ai 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 for the curated search, enrichment, lookup, newsfeed, person ask, and company workflows."
  ],
  "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": [
        "person_search",
        "person_enrichment",
        "person_lookup_fields",
        "person_newsfeed",
        "person_ask",
        "company_search",
        "company_enrichment",
        "check_status"
      ],
      "best_for": [
        "common person search workflows",
        "known-person enrichment",
        "targeted field lookup",
        "recent social newsfeed",
        "profile Q&A",
        "company search and enrichment"
      ]
    },
    "local_package": {
      "path": "mcp-server/",
      "coverage": "curated_http_api_subset",
      "supported_endpoints": [
        "person_search",
        "person_enrichment",
        "person_lookup_fields",
        "person_newsfeed",
        "person_ask",
        "company_search",
        "company_enrichment"
      ],
      "resources": ["nyne://docs/llms", "nyne://docs/manifest", "nyne://schemas/person", "nyne://docs/rate-limits"]
    }
  },
  "routing": [
    {
      "task": "Known person from email, phone, or social profile URL",
      "use": "person_enrichment"
    },
    {
      "task": "Known person lookup with enrichment-shaped output",
      "use": "person_enrich"
    },
    {
      "task": "Resolve identity from email, phone, social URL, or username",
      "use": "person_identify"
    },
    {
      "task": "Recent social posts or activity",
      "use": "person_newsfeed"
    },
    {
      "task": "Recent social posts or activity lookup",
      "use": "person_newsfeed_lookup"
    },
    {
      "task": "Explainable psychographics or interests",
      "use": "person_interests"
    },
    {
      "task": "Natural-language Q&A about a known person",
      "use": "person_ask"
    },
    {
      "task": "Natural-language Q&A lookup about a known person",
      "use": "person_ask_lookup"
    },
    {
      "task": "Follower overlap across supported social accounts",
      "use": "person_connection_mapping"
    },
    {
      "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 company social 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_enrich",
      "category": "person",
      "path": "/person/enrich",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Look up a known person using the standard enrichment result shape.",
      "best_for": "Known-person enrichment when the standard person profile shape is needed.",
      "required_inputs": ["email | phone | social_media_url | name"],
      "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_enrichment", "person_identify", "person_ask_lookup"]
    },
    {
      "id": "person_identify",
      "category": "person",
      "path": "/person/identify",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Resolve a likely person identity from email, phone, social URL, or username.",
      "best_for": "Identity starter workflows and username-based profile resolution.",
      "required_inputs": ["email | phone | social_media_url | username"],
      "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_enrich", "person_ask_lookup"]
    },
    {
      "id": "person_search",
      "category": "person",
      "path": "/person/search",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "People search with natural-language queries, structured filters, pagination, and optional result-quality flags.",
      "best_for": "Searching for contacts by freeform query or structured filters.",
      "required_inputs": ["query | custom_filters | docid_whitelist | 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_newsfeed_lookup",
      "category": "person",
      "path": "/person/newsfeed-lookup",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Fetch recent social posts and activity from a profile URL.",
      "best_for": "Recent activity lookups for a known profile.",
      "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_newsfeed", "person_interactions"]
    },
    {
      "id": "person_connection_mapping",
      "category": "person",
      "path": "/person/connection-mapping",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Analyze follower overlap across supported social accounts.",
      "best_for": "Connection and relationship mapping from social follower graphs.",
      "required_inputs": ["accounts | usernames | social_media_urls"],
      "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_interactions", "person_identify"]
    },
    {
      "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_ask_lookup",
      "category": "person",
      "path": "/person/ask-lookup",
      "method": "POST",
      "status_method": "GET",
      "async": true,
      "purpose": "Answer a natural-language question about a known person.",
      "best_for": "Person Q&A lookups with best-effort evidence fields.",
      "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_enrich", "person_identify"]
    },
    {
      "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 company social 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"]
    }
  ]
}