Kruncher.ai Documentation

Getting an Analysis Report

Every project in Kruncher.ai comes with an array of analyses. Each analysis contains detailed reports on company performance and insights. To get the latest report you need to:

Search for the company by name to get its project data
Pick the latest analysis from the analyses array (sorted by createdAt)
Fetch the full report using that analysisId

Step 1: Find the Company and Get the Latest Analysis ID

Search for the company by name using the Search Projects endpoint. The response includes an analyses array on each project. Sort by createdAt to pick the most recent one.

JavaScript

CODE

const API_KEY = "YOUR_API_KEY_HERE";
 
// Search for the company by name
const searchRes = await fetch(
  "https://api.kruncher.ai/api/integration/project/search?keywords=acme",
  { headers: { "Authorization": API_KEY } }
);
const { data } = await searchRes.json();
 
if (!data.results.length) {
  throw new Error("Company not found");
}
 
const project = data.results[0];
console.log("Found project:", project.id, project.name);

Python

CODE

import requests
 
API_KEY = "YOUR_API_KEY_HERE"
 
# Search for the company by name
search = requests.get(
    "https://api.kruncher.ai/api/integration/project/search",
    params={"keywords": "acme"},
    headers={"Authorization": API_KEY},
)
results = search.json()["data"]["results"]
 
if not results:
    raise ValueError("Company not found")
 
project = results[0]
print("Found project:", project["id"], project["name"])

cURL

CODE

# Search for the company by name
curl -X GET "https://api.kruncher.ai/api/integration/project/search?keywords=acme" \
  -H "Authorization: YOUR_API_KEY_HERE"

Now retrieve the full project details (including analyses) using Find Companies and pick the latest analysis:

JavaScript

CODE

// Get project details with analyses
const projectsRes = await fetch(
  `https://api.kruncher.ai/api/integration/projects?search=${encodeURIComponent(project.name)}`,
  { headers: { "Authorization": API_KEY, "Content-Type": "application/json" } }
);
const projects = await projectsRes.json();
const company = projects.data.find((p) => p.id === project.id);
 
// Pick the latest analysis by createdAt
const latestAnalysis = company.analyses
  .sort((a, b) => new Date(b.createdAt) - new Date(a.createdAt))[0];
 
const analysisId = latestAnalysis.id;
console.log("Latest analysis:", analysisId, latestAnalysis.status);

Python

CODE

# Get project details with analyses
projects = requests.get(
    "https://api.kruncher.ai/api/integration/projects",
    params={"search": project["name"]},
    headers={"Authorization": API_KEY, "Content-Type": "application/json"},
).json()
 
company = next(p for p in projects["data"] if p["id"] == project["id"])
 
# Pick the latest analysis by createdAt
latest_analysis = sorted(
    company["analyses"], key=lambda a: a["createdAt"], reverse=True
)[0]
 
analysis_id = latest_analysis["id"]
print("Latest analysis:", analysis_id, latest_analysis["status"])

cURL

CODE

# Get project details with analyses
# Then pick the latest analysisId from the analyses array in the response
curl -X GET "https://api.kruncher.ai/api/integration/projects?search=acme" \
  -H "Authorization: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json"

Step 2: Fetch the Full Report

Once you have the analysisId, request the full company report:

CODE

GET https://api.kruncher.ai/api/integration/analysis/detail?analysisId=<analysisId>

JavaScript

CODE

const reportRes = await fetch(
  `https://api.kruncher.ai/api/integration/analysis/detail?analysisId=${analysisId}`,
  {
    headers: {
      "Authorization": API_KEY,
      "Content-Type": "application/json"
    }
  }
);
const report = await reportRes.json();
console.log("Full Company Report:", report);

Python

CODE

report = requests.get(
    "https://api.kruncher.ai/api/integration/analysis/detail",
    params={"analysisId": analysis_id},
    headers={"Authorization": API_KEY, "Content-Type": "application/json"},
).json()
 
print("Full Company Report:", report)

cURL

CODE

curl -X GET "https://api.kruncher.ai/api/integration/analysis/detail?analysisId=YOUR_ANALYSIS_ID" \
  -H "Authorization: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json"

Full Example

Here’s the complete flow in a single function (for cURL, run each step sequentially):

JavaScript

CODE

const API_KEY = "YOUR_API_KEY_HERE";
const BASE_URL = "https://api.kruncher.ai/api";
 
async function getLatestReport(companyName) {
  // 1. Search for the company
  const searchRes = await fetch(
    `${BASE_URL}/integration/project/search?keywords=${encodeURIComponent(companyName)}`,
    { headers: { "Authorization": API_KEY } }
  );
  const searchData = await searchRes.json();
 
  if (!searchData.data.results.length) {
    throw new Error(`No company found for "${companyName}"`);
  }
 
  const projectId = searchData.data.results[0].id;
 
  // 2. Get project details with analyses
  const projectsRes = await fetch(
    `${BASE_URL}/integration/projects?search=${encodeURIComponent(companyName)}`,
    { headers: { "Authorization": API_KEY, "Content-Type": "application/json" } }
  );
  const projects = await projectsRes.json();
  const company = projects.data.find((p) => p.id === projectId);
 
  if (!company?.analyses?.length) {
    throw new Error("No analyses found for this company");
  }
 
  // Pick the latest analysis
  const latest = company.analyses
    .sort((a, b) => new Date(b.createdAt) - new Date(a.createdAt))[0];
 
  // 3. Fetch the full report
  const reportRes = await fetch(
    `${BASE_URL}/integration/analysis/detail?analysisId=${latest.id}`,
    { headers: { "Authorization": API_KEY, "Content-Type": "application/json" } }
  );
 
  return await reportRes.json();
}
 
// Usage
const report = await getLatestReport("Acme Corp");
console.log(report);

Python

CODE

import requests
 
API_KEY = "YOUR_API_KEY_HERE"
BASE_URL = "https://api.kruncher.ai/api"
 
def get_latest_report(company_name):
    headers = {"Authorization": API_KEY, "Content-Type": "application/json"}
 
    # 1. Search for the company
    search = requests.get(
        f"{BASE_URL}/integration/project/search",
        params={"keywords": company_name},
        headers=headers,
    ).json()
 
    results = search["data"]["results"]
    if not results:
        raise ValueError(f'No company found for "{company_name}"')
 
    project_id = results[0]["id"]
 
    # 2. Get project details with analyses
    projects = requests.get(
        f"{BASE_URL}/integration/projects",
        params={"search": company_name},
        headers=headers,
    ).json()
 
    company = next((p for p in projects["data"] if p["id"] == project_id), None)
 
    if not company or not company.get("analyses"):
        raise ValueError("No analyses found for this company")
 
    # Pick the latest analysis
    latest = sorted(company["analyses"], key=lambda a: a["createdAt"], reverse=True)[0]
 
    # 3. Fetch the full report
    report = requests.get(
        f"{BASE_URL}/integration/analysis/detail",
        params={"analysisId": latest["id"]},
        headers=headers,
    ).json()
 
    return report
 
# Usage
report = get_latest_report("Acme Corp")
print(report)

cURL

CODE

#!/bin/bash
API_KEY="YOUR_API_KEY_HERE"
 
# 1. Search for the company
curl -s -X GET "https://api.kruncher.ai/api/integration/project/search?keywords=acme" \
  -H "Authorization: $API_KEY" | jq '.data.results[0].id'
 
# 2. Get project details and pick the latest analysisId
# Use the project name from step 1
curl -s -X GET "https://api.kruncher.ai/api/integration/projects?search=acme" \
  -H "Authorization: $API_KEY" \
  -H "Content-Type: application/json" \
  | jq '.data[0].analyses | sort_by(.createdAt) | last | .id'
 
# 3. Fetch the full report (replace with the analysisId from step 2)
curl -X GET "https://api.kruncher.ai/api/integration/analysis/detail?analysisId=YOUR_ANALYSIS_ID" \
  -H "Authorization: $API_KEY" \
  -H "Content-Type: application/json"

For more details on the search API, see Search Projects. For the full response field reference, see Find Companies.