SQL API

Run raw MariaDB SQL queries against your databases using the Datasquirel API.

Overview

The SQL API lets you execute any valid MariaDB SQL statement directly against your database and receive the result set as JSON. Use it when the standard CRUD endpoints don't cover your use case — complex JOINs, aggregations, subqueries, or DDL operations.

Quick Example

import datasquirel from "@moduletrace/datasquirel";

const result = await datasquirel.api.sql({
    key: process.env.DATASQUIREL_API_KEY,
    params: {
        query: "SELECT * FROM users WHERE is_active = 1 ORDER BY created_at DESC LIMIT 10",
    },
});

console.log(result.payload);

Authentication

A Full Access API key is required to run raw SQL queries. Read-only keys cannot use the SQL endpoint.