X-API-Key: your_api_key
X-API-Secret: your_api_secret

curl -X POST "https://api.nyne.ai/company/discovery" \
  -H "X-API-Key: your_api_key" \
  -H "X-API-Secret: your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "AI startups in healthcare that have raised Series A funding",
    "requirements": [
      {
        "name": "series_a_funded",
        "description": "Has raised a Series A funding round"
      },
      {
        "name": "healthcare_focus",
        "description": "Primary business focus is in healthcare or medical technology"
      }
    ],
    "extract": [
      {
        "name": "ceo_name",
        "description": "Name of the CEO or founder"
      },
      {
        "name": "funding_amount",
        "description": "Total funding amount raised"
      }
    ],
    "limit": 10,
    "quality": "standard",
    "callback_url": "https://yourapp.com/webhook/discovery"
  }'

{
  "success": true,
  "data": {
    "request_id": "a1b2c3d4e5f6...",
    "status": "pending",
    "message": "Discovery request queued for processing. Use GET with request_id to check status.",
    "created_on": "2026-02-19T10:30:00"
  },
  "timestamp": "2026-02-19T10:30:00Z"
}

curl -X GET "https://api.nyne.ai/company/discovery?request_id=a1b2c3d4e5f6..." \
  -H "X-API-Key: your_api_key" \
  -H "X-API-Secret: your_api_secret"

{
  "success": true,
  "data": {
    "request_id": "a1b2c3d4e5f6...",
    "status": "completed",
    "completed": true,
    "completed_on": "2026-02-19T10:33:00",
    "created_on": "2026-02-19T10:30:00",
    "result": {
      "entity_type": "companies",
      "query": "AI startups in healthcare that have raised Series A funding",
      "results_count": 10,
      "results": [
        {
          "name": "MedAI Corp",
          "url": "medai.com",
          "description": "AI-powered medical diagnostics startup specializing in early disease detection using machine learning",
          "match_status": "matched",
          "evaluations": {
            "series_a_funded": {
              "value": "yes",
              "matched": true
            },
            "healthcare_focus": {
              "value": "yes",
              "matched": true
            }
          },
          "extractions": {
            "ceo_name": "John Smith",
            "funding_amount": "$15M Series A"
          },
          "sources": [
            {
              "field": "series_a_funded",
              "reasoning": "Found Series A announcement from 2025 with confirmed funding round",
              "confidence": "high",
              "citations": [
                {
                  "title": "TechCrunch - MedAI Corp Raises Series A",
                  "url": "https://techcrunch.com/2025/medai-series-a",
                  "excerpts": ["MedAI Corp announced a $15M Series A round led by Andreessen Horowitz..."]
                }
              ]
            },
            {
              "field": "healthcare_focus",
              "reasoning": "Company website and press coverage confirm healthcare AI as primary focus",
              "confidence": "high",
              "citations": [
                {
                  "title": "MedAI Corp - About Us",
                  "url": "https://medai.com/about",
                  "excerpts": ["MedAI Corp is building AI-powered diagnostic tools for healthcare providers"]
                }
              ]
            }
          ]
        }
      ],
      "metrics": {
        "candidates_evaluated": 50,
        "candidates_matched": 10
      }
    }
  },
  "timestamp": "2026-02-19T10:33:00Z"
}

# Submit a discovery request
curl -X POST "https://api.nyne.ai/company/discovery" \
  -H "X-API-Key: your_api_key" \
  -H "X-API-Secret: your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "AI startups in healthcare that have raised Series A funding",
    "requirements": [
      {"name": "series_a_funded", "description": "Has raised a Series A funding round"},
      {"name": "healthcare_focus", "description": "Primary business focus is in healthcare"}
    ],
    "extract": [
      {"name": "ceo_name", "description": "Name of the CEO or founder"}
    ],
    "limit": 10,
    "quality": "standard"
  }'

# Check status (replace REQUEST_ID with the returned request_id)
curl -X GET "https://api.nyne.ai/company/discovery?request_id=REQUEST_ID" \
  -H "X-API-Key: your_api_key" \
  -H "X-API-Secret: your_api_secret"

import requests
import time

API_KEY = "your_api_key"
API_SECRET = "your_api_secret"
BASE_URL = "https://api.nyne.ai"

headers = {
    "X-API-Key": API_KEY,
    "X-API-Secret": API_SECRET,
    "Content-Type": "application/json"
}

# Step 1: Submit discovery request
payload = {
    "query": "AI startups in healthcare that have raised Series A funding",
    "requirements": [
        {"name": "series_a_funded", "description": "Has raised a Series A funding round"},
        {"name": "healthcare_focus", "description": "Primary business focus is in healthcare"}
    ],
    "extract": [
        {"name": "ceo_name", "description": "Name of the CEO or founder"},
        {"name": "funding_amount", "description": "Total funding amount raised"}
    ],
    "limit": 10,
    "quality": "standard"
}

response = requests.post(f"{BASE_URL}/company/discovery", json=payload, headers=headers)
data = response.json()

if not data.get("success"):
    print(f"Error: {data}")
    exit(1)

request_id = data["data"]["request_id"]
print(f"Request submitted: {request_id}")

# Step 2: Poll for results
while True:
    time.sleep(5)
    response = requests.get(
        f"{BASE_URL}/company/discovery",
        params={"request_id": request_id},
        headers=headers
    )
    result = response.json()
    status = result["data"]["status"]
    print(f"Status: {status}")

    if status == "completed":
        discovery = result["data"]["result"]
        print(f"Found {discovery['results_count']} companies")
        for company in discovery["results"]:
            print(f"  - {company['name']}: {company['description']}")
            if company.get("extractions"):
                for key, value in company["extractions"].items():
                    print(f"    {key}: {value}")
        break
    elif status == "failed":
        print(f"Discovery failed: {result['data'].get('error', 'Unknown error')}")
        break

const API_KEY = "your_api_key";
const API_SECRET = "your_api_secret";
const BASE_URL = "https://api.nyne.ai";

const headers = {
  "X-API-Key": API_KEY,
  "X-API-Secret": API_SECRET,
  "Content-Type": "application/json"
};

async function discoverCompanies() {
  // Step 1: Submit discovery request
  const payload = {
    query: "AI startups in healthcare that have raised Series A funding",
    requirements: [
      { name: "series_a_funded", description: "Has raised a Series A funding round" },
      { name: "healthcare_focus", description: "Primary business focus is in healthcare" }
    ],
    extract: [
      { name: "ceo_name", description: "Name of the CEO or founder" },
      { name: "funding_amount", description: "Total funding amount raised" }
    ],
    limit: 10,
    quality: "standard"
  };

  const submitResponse = await fetch(`${BASE_URL}/company/discovery`, {
    method: "POST",
    headers,
    body: JSON.stringify(payload)
  });
  const submitData = await submitResponse.json();

  if (!submitData.success) {
    console.error("Error:", submitData);
    return;
  }

  const requestId = submitData.data.request_id;
  console.log(`Request submitted: ${requestId}`);

  // Step 2: Poll for results
  while (true) {
    await new Promise(resolve => setTimeout(resolve, 5000));

    const statusResponse = await fetch(
      `${BASE_URL}/company/discovery?request_id=${requestId}`,
      { headers }
    );
    const statusData = await statusResponse.json();
    const status = statusData.data.status;
    console.log(`Status: ${status}`);

    if (status === "completed") {
      const discovery = statusData.data.result;
      console.log(`Found ${discovery.results_count} companies`);
      discovery.results.forEach(company => {
        console.log(`  - ${company.name}: ${company.description}`);
        if (company.extractions) {
          Object.entries(company.extractions).forEach(([key, value]) => {
            console.log(`    ${key}: ${value}`);
          });
        }
      });
      return statusData;
    } else if (status === "failed") {
      console.error("Discovery failed:", statusData.data.error || "Unknown error");
      return statusData;
    }
  }
}

discoverCompanies();

<?php

$apiKey = "your_api_key";
$apiSecret = "your_api_secret";
$baseUrl = "https://api.nyne.ai";

// Step 1: Submit discovery request
$payload = [
    "query" => "AI startups in healthcare that have raised Series A funding",
    "requirements" => [
        ["name" => "series_a_funded", "description" => "Has raised a Series A funding round"],
        ["name" => "healthcare_focus", "description" => "Primary business focus is in healthcare"]
    ],
    "extract" => [
        ["name" => "ceo_name", "description" => "Name of the CEO or founder"],
        ["name" => "funding_amount", "description" => "Total funding amount raised"]
    ],
    "limit" => 10,
    "quality" => "standard"
];

$ch = curl_init("$baseUrl/company/discovery");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode($payload),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "X-API-Key: $apiKey",
        "X-API-Secret: $apiSecret",
        "Content-Type: application/json"
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

if (!$data["success"]) {
    echo "Error: " . print_r($data, true);
    exit(1);
}

$requestId = $data["data"]["request_id"];
echo "Request submitted: $requestId\n";

// Step 2: Poll for results
while (true) {
    sleep(5);

    $ch = curl_init("$baseUrl/company/discovery?request_id=$requestId");
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            "X-API-Key: $apiKey",
            "X-API-Secret: $apiSecret"
        ]
    ]);

    $response = curl_exec($ch);
    curl_close($ch);

    $result = json_decode($response, true);
    $status = $result["data"]["status"];
    echo "Status: $status\n";

    if ($status === "completed") {
        $discovery = $result["data"]["result"];
        echo "Found " . $discovery["results_count"] . " companies\n";
        foreach ($discovery["results"] as $company) {
            echo "  - " . $company["name"] . ": " . $company["description"] . "\n";
            if (isset($company["extractions"])) {
                foreach ($company["extractions"] as $key => $value) {
                    echo "    $key: $value\n";
                }
            }
        }
        break;
    } elseif ($status === "failed") {
        echo "Discovery failed: " . ($result["data"]["error"] ?? "Unknown error") . "\n";
        break;
    }
}

?>

POST your_callback_url
Content-Type: application/json

{
  "request_id": "a1b2c3d4e5f6...",
  "status": "completed",
  "completed": true,
  "result": {
    "entity_type": "companies",
    "query": "AI startups in healthcare that have raised Series A funding",
    "results_count": 10,
    "results": [...],
    "metrics": {
      "candidates_evaluated": 50,
      "candidates_matched": 10
    }
  }
}