getqueryly API

Upload your file via code, ask in plain English, get calculated answers from your actual file.

Quick Start

# 1. Upload a dataset
curl -X POST https://getqueryly.com/api/data-scientist/upload \
  -F "session_id=my_session_1" \
  -F "file=@sales_data.csv"

# 2. Ask a question
curl -X POST https://getqueryly.com/api/data-scientist/query \
  -F "session_id=my_session_1" \
  -F "query=Show average revenue by region"

# 3. Run a health check
curl https://getqueryly.com/api/data-scientist/health/my_session_1

Authentication

getqueryly supports two authentication methods: API keys for server-to-server calls, and session tokens for user sessions.

API Key Authentication

Generate an API key from the dashboard. Include it in the X-API-Key header.

curl -H "X-API-Key: dmk_your_key_here" \
  https://getqueryly.com/api/makes/limits

Bearer Token Authentication

For user-specific endpoints, use the session token from sign-in.

curl -H "Authorization: Bearer eyJhbGciOi..." \
  https://getqueryly.com/api/auth/me

Rate Limits

Limits are per-day and reset at midnight UTC. Anonymous users get 2 uses/day.

Paid users have no daily limit. Buy as many times as you want, balance stacks.

Requests per minute (per API key)

AI endpoints (analysis, chat, actions, MCP) get the AI rate. Exceeding the rate returns 429 with a Retry-After header.

Every API response carries X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers. Live per-key state is on the usage page.

Upload File

curl -X POST https://getqueryly.com/api/data-scientist/upload \
  -F "session_id=ds_1720000000_abc12" \
  -F "file=@sales_data.csv"

Response

{
  "session_id": "ds_1720000000_abc12",
  "load_info": {
    "rows": 4520,
    "columns": 12,
    "column_names": ["date", "region", "product", "revenue", ...],
    "dtypes": {"date": "object", "revenue": "float64", ...}
  },
  "overview": "Dataset Loaded: 4,520 rows and 12 columns..."
}

Query Data

curl -X POST https://getqueryly.com/api/data-scientist/query \
  -F "session_id=ds_1720000000_abc12" \
  -F "query=Show average salary by department as a bar chart"

Response

{
  "text": "The average salary by department is:\n- Engineering: $95,400\n- Marketing: $72,300\n- Sales: $68,100",
  "charts": ["/outputs/ds_1720000000_abc12/salary_bar_chart.png"],
  "code_executed": true,
  "session_id": "ds_1720000000_abc12"
}

Generate Code

Health Check

curl https://getqueryly.com/api/data-scientist/health/ds_1720000000_abc12

Response

{
  "overall_score": 82,
  "dimensions": {
    "completeness": {"score": 85, "detail": "3.2% missing values"},
    "consistency": {"score": 90, "detail": "No type mismatches"},
    "accuracy": {"score": 78, "detail": "2 outlier regions detected"},
    "timeliness": {"score": 75, "detail": "Data spans 2023-2025"}
  },
  "summary": "Your data is in good shape with minor issues.",
  "fixes": ["Fill 145 missing email values", "Review 12 salary outliers"]
}

Insights

curl https://getqueryly.com/api/data-scientist/insights/ds_1720000000_abc12

Data Guardian (Autonomous Analysis)

curl https://getqueryly.com/api/data-scientist/autonomous/ds_1720000000_abc12

Response

{
  "pulse": {
    "alerts": [
      {"severity": "critical", "type": "missing_crisis", "title": "email is 45% missing", "action": "Drop email or use advanced imputation."},
      {"severity": "warning", "type": "outlier", "title": "Unusual values in revenue: 12 outliers (8.2%)"}
    ],
    "overall_health": {"score": 72, "label": "Good", "detail": "Minor issues detected."},
    "summary": {"total": 5, "critical": 1, "warnings": 2, "info": 2}
  },
  "discoveries": {
    "discoveries": [
      {"type": "strong_correlation", "title": "revenue and cost are strongly positively correlated", "detail": "r = 0.847"},
      {"type": "category_pattern", "title": "'Region A' has 34% more revenue than 'Region B'"}
    ],
    "total": 3
  },
  "prophets": {
    "predictions": [
      {"type": "trend_forecast", "title": "revenue is projected to increase by 12%", "detail": "Current: 1250. Predicted next: 1400 (R² = 0.89)"},
      {"type": "acceleration", "title": "cost is accelerating (45% change)"}
    ],
    "total": 2
  },
  "narrative": "Data Health: Good (72/100)\nALERT: 1 critical issue(s) detected.\nHidden patterns found:\n  - revenue and cost are strongly positively correlated\nForecasts:\n  - revenue is projected to increase by 12%",
  "metadata": {"filename": "sales.csv", "rows": 500, "columns": 12, "analysis_time": 1.23}
}

Multi-Analyst Reports

curl -X POST https://getqueryly.com/api/data-scientist/swarm \
  -F "session_id=ds_1720000000_abc12" \
  -F "query=Analyze this data thoroughly and provide key insights" \
  -F "depth=deep"

Response

{
  "persona_names": ["Statistician", "BI Analyst", "Domain Expert"],
  "persona_results": {
    "statistician": {"name": "Statistician", "output": "Revenue follows a right-skewed distribution..."},
    "bi_analyst": {"name": "BI Analyst", "output": "Q4 shows 23% growth over Q3..."},
    "domain_expert": {"name": "Domain Expert", "output": "The engineering department drives 62%..."}
  },
  "consensus": {"text": "Key finding: Revenue is growing 15% QoQ driven by..."}
}

Available Personas

Kaggle Dataset Explorer

Search and load 200K+ public datasets from Kaggle directly via the API. Requires Kaggle API credentials configured on the server.

curl https://getqueryly.com/api/kaggle/status

# Response
{"configured": true}

curl "https://getqueryly.com/api/kaggle/search?q=world+population&page=1"

# Response
{
  "results": [
    {
      "ref": "iamsouravbanerjee/world-population-dataset",
      "title": "World Population Dataset",
      "description": "Global Headcount by Country/Territory",
      "license": "Other (specified in description)",
      "downloads": 89310,
      "votes": 768,
      "files_count": 1,
      "tags": ["people", "tabular", "beginner"]
    }
  ],
  "query": "world population",
  "page": 1
}

curl -X POST https://getqueryly.com/api/kaggle/load \
  -H "Content-Type: application/json" \
  -d '{"dataset": "iamsouravbanerjee/world-population-dataset"}'

# Response
{
  "session_id": "kgl_abc123...",
  "load_info": {"rows": 234, "columns": 15},
  "dataset": "iamsouravbanerjee/world-population-dataset",
  "overview": "Loaded Kaggle dataset: iamsouravbanerjee/world-population-dataset"
}

List Sessions

Session History

Delete Session

User Info

curl -H "Authorization: Bearer eyJhbGciOi..." \
  https://getqueryly.com/api/auth/me

Response

{
  "uid": "abc123",
  "email": "[email protected]",
  "displayName": "John",
  "provider": "password",
  "tier": "free",
  "dailyLimit": 10
}

API Keys

Pricing

curl https://getqueryly.com/api/pricing

Usage Limits

curl https://getqueryly.com/api/makes/limits

Response

{
  "tier": "free",
  "limit": 10,
  "used": 3,
  "remaining": 7,
  "balance": 0,
  "total_available": 7
}

Payments

getqueryly uses a secure payment gateway for payments. All amounts are in GHS (Ghanaian Cedis).

AI Tool Integration

getqueryly connects to AI coding tools and assistants, letting them upload, query, and analyze your data directly.

Available Tools

Connect Your AI Tools

Add getqueryly to your AI tool using this configuration:

{
  "mcpServers": {
    "getqueryly": {
      "url": "https://getqueryly.com/mcp/sse",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Chat

Service Health

curl https://getqueryly.com/health

Response

{
  "status": "ok",
  "service": "getqueryly",
  "version": "2.0",
  "firebase": "connected",
  "queue": {"waiting": 0, "running": 0, "capacity": 3},
  "disk_gb": 65.4,
  "uptime": "active"
}