API Data Analysis: Analyze Data from Any App with getqueryly

The web interface is great for one-off analysis. But what if you want to analyze data from your own app, a script, or an automated pipeline? getqueryly's REST API lets you send data and get analysis results programmatically. No browser needed.

Why Use an API for Data Analysis?

APIs let you integrate analysis into workflows that run without human intervention:

• Automated reports: Cron job pulls data daily, sends it to getqueryly, gets a report back
• App integration: Your SaaS app lets users upload files and get instant analysis
• Pipeline validation: Check data quality before it enters your database
• Batch processing: Analyze hundreds of files without clicking through the UI
• Custom dashboards: Build your own frontend, use getqueryly as the analysis backend

How the API Works

Every analysis starts with an API key. Generate one from the getqueryly dashboard, then use it in your requests.

Step 1: Generate an API Key

1. Sign in to getqueryly.com
2. Go to Settings
3. Click "Generate API Key"
4. Choose an expiration, 7, 30, 90 days or never, and a name like Default key
5. Copy the key shown once with Copy. Rotate gives a new key and the old one stops immediately, revoke then delete removes a compromised key

Step 2: Upload Your File

Send your file to the upload endpoint:

curl -X POST https://getqueryly.com/api/data-scientist/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]"

The response includes a session ID. Use this ID for all subsequent requests on this file.

Step 3: Query Your Data

Ask questions about your data using natural language:

curl -X POST https://getqueryly.com/api/data-scientist/query \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "What is the average revenue by region?", "session_id": "SESSION_ID"}'

Get back structured results with statistics, charts, and insights.

Step 4: Run Health Checks

Check data quality programmatically:

curl https://getqueryly.com/api/data-scientist/health/SESSION_ID \
  -H "X-API-Key: YOUR_API_KEY"

Get back a quality score from 0 to 100 plus missing values, outliers, duplicates and type issues. See Data Health Check for what the score means.

API Endpoints

• POST /api/data-scientist/upload: Upload a file, get a session_id (free)
• POST /api/data-scientist/query: Ask any question in plain English about your data (1 Make)
• GET /api/data-scientist/health/{session_id}: Data quality score, missing, outliers, duplicates (2 Makes)
• GET /api/data-scientist/insights/{session_id}: Automatic patterns, anomalies, trends, correlations (3 Makes)
• GET /api/data-scientist/test-recommend/{session_id}: AI picks and runs the right statistical test (1 Make)
• POST /api/data-scientist/swarm: Multi-analyst consensus report, quick 5 Makes or full 8 Makes
• GET /api/data-scientist/dashboard/generate/{session_id}: Executive dashboard with KPIs and charts (2 Makes)
• POST /api/data-scientist/report/{session_id}: Generate a PDF report with charts and stats (3 Makes)
• POST /api/data-scientist/share: Snapshot charts + narrative into a shareable link (free with session)
• GET /api/data-scientist/autonomous/{session_id}: Data Guardian autonomous analysis (5 Makes)
• GET /api/makes/costs and GET /api/makes/limits: Check costs and your remaining Makes

Full reference with request and response shapes: api-docs. All data endpoints accept X-API-Key. Charts are returned as images proven from your actual file.

MCP Protocol Support

For AI coding assistants, getqueryly supports the Model Context Protocol (MCP). This lets your AI assistant analyze data directly from your coding environment without manual API calls.

MCP tools include: file upload, query, health check, chart generation, insights, multi-analyst reports, and report generation.

Costs and Limits

Every action spends Makes from one shared pool for web, API and MCP. Uploading and Kaggle search are free. A data question costs 1 Make, health check 2, insights 3, report 3, multi-analyst swarm 5 for quick or 8 for full, chat 1, visuals 2, diagram and infographic 1 each. Check live costs at GET /api/makes/costs and your balance at GET /api/makes/limits.

Free users get 10 Makes per day, 2 per day without signing in. Paid users have no daily cap and spend from balance that never expires: Starter 50 Makes for GHS 49, Growth 200 for GHS 149, Pro 600 for GHS 399. Per-key rate limits keep things fair, free 10 regular and 5 AI requests per minute, higher on paid tiers, all returned in X-RateLimit headers with 429 Retry-After when you hit them.

Try It

Generate an API key and test the upload endpoint with a CSV file. The response tells you if the file was accepted and what analysis options are available.