FLUNCLE
  1. Docs
  2. Api Overview

Search the archive

Search Fluncle's archive by name, coordinate, or the sound of it.

FLUNCLE / docs
FLUNCLE / docs
FindingsGetting startedThe Log IDThe APIAPI referenceThe CLIThe MCP serverThe rave terminalThe oniondigThe feeds

The API

The public HTTP API every other surface reads. Overview and the full reference.

The Fluncle API is the source every other surface reads. The CLI, the rave terminal, the MCP server, and dig are all thin clients of it. It's public, read-mostly, and needs no key for the findings.

API reference

Every endpoint and schema, rendered live from the OpenAPI document. Try requests in the browser.

The base

The stable, versioned base is:

https://www.fluncle.com/api/v1

The bare /api/* path is a permanent alias, so an old link keeps resolving.

A taste

The findings, newest first:

curl https://www.fluncle.com/api/v1/tracks?limit=3

A single finding by its Log ID:

curl https://www.fluncle.com/api/v1/tracks/241.7.3A

The list is paginated with limit and a cursor; the head is always the latest finding.

The spec

The API describes itself. The OpenAPI 3.1 document lives under the same versioned base it describes:

https://www.fluncle.com/api/v1/openapi.json

The API reference reads exactly that document, so it never drifts from what the API actually does. Submitting a track through the API is a recommendation, same as everywhere: it's rate-limited, and Fluncle listens before anything joins the archive.

A Postman collection is built from the same OpenAPI document, on request, under the same versioned base:

https://www.fluncle.com/api/v1/postman.json

Import that URL into Postman for a folder per endpoint with example bodies wired up. It's generated from the spec each time, so it tracks the API the same way the reference does.

The Log ID

A finding's permanent coordinate in the Galaxy, and how to read it.

API reference

Next Page

On this page

The baseA tasteThe spec
FLUNCLE

Drum & bass bangers from another dimension.

Travel along

  • Log
  • Logbook
  • Galaxies
  • Mixtapes

Browse

  • Artists
  • Albums
  • Labels

Listen

  • Playlist
  • Radio

Crew

  • About
  • Newsletter
  • Docs
Follow Fluncle
CLIDIGGITMCPSSH
checking systems