FLUNCLE
  1. Docs
  2. Api Overview

Search the archive

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

Join the crew
FLUNCLE / docs
FLUNCLE / docs
FindingsGetting startedThe Log IDIdentityThe 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

A taste

The findings, newest first:

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

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

Every track Fluncle holds, newest release first:

curl "https://www.fluncle.com/api/v1/tracks?page=1&certified=true"

A single finding by its Log ID:

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

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.

Identity

Look a recording up by a Spotify or Deezer link, an ISRC, a MusicBrainz id, or a Log ID: the links Fluncle found, and where he looked and found nothing.

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
  • Fresh

Listen

  • Playlist
  • Radio

Crew

  • About
  • Reach
  • Newsletter
  • Docs
  • Pipeline
Follow Fluncle
CLIDIGGITMCPSSH
checking systems
Privacy·Terms