Skip to main content
GET
/
api
/
v1
/
sources
List available data sources (partner API)
curl --request GET \
  --url https://app.puffle.ai/api/v1/sources \
  --header 'Authorization: Bearer <token>'
{
  "sources": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "config_schema": {}
    }
  ]
}

​
Overview

Returns every data source the Puffle platform can ingest signals from — LinkedIn posts, Reddit, HackerNews, news, SEC filings, G2/Capterra, BlueSky, X/Twitter, web mentions, etc. Each entry includes a config_schema that describes what fields updateSourceConfigV1 accepts for that source. Sources are system-defined; they can’t be created or deleted. This endpoint is a catalog.

​
AI agent notes

Use this first, then configure. Always call listSourcesV1 before updateSourceConfigV1 — the returned config_schema tells you what shape the config object needs to be for that specific source (e.g., Reddit wants { subreddits: string[] }, LinkedIn Jobs wants { location, work_type }).Cache the result. Sources don’t change often. Safe to cache for an entire session.Related:

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Every available source with its config schema.

​
sources
object[]
required