Endpoints

Je projecten opvragen

Geeft de projecten terug van het account achter je API-sleutel, met hun zoekwoorden en de staat van hun AI-agent.

GET/api/v1/projectsGratis

Je projecten leven in het dashboard; dit endpoint maakt ze van buitenaf leesbaar. Het gangbare gebruik: de zoekwoorden en de doeltaal van een project ophalen en doorgeven aan het scan-endpoint, in plaats van ze bij elke wijziging opnieuw in je script over te typen.

Het bereik komt van de sleutel

Er is geen parameter om een account te kiezen: de route geeft nooit meer terug dan de projecten van het account waar je sleutel bij hoort. Niets te vervalsen dus, en aan jouw kant niets te filteren.

Headers

Headers van de aanvraag

Parameter	Type	Verplicht	Beschrijving
`Authorization`	`string`	Verplicht	Je API-sleutel, voorafgegaan door `Bearer`. Een ontbrekende, onbekende of ingetrokken sleutel geeft een `401`.

Geen paginering en geen sortering om op te vragen: het Starter-plan houdt het bij drie projecten, en ze komen van nieuw naar oud terug.

Voorbeeld

cURL

curl -s https://subreply.io/api/v1/projects \
  -H "Authorization: Bearer sr_live_UW_API_SLEUTEL"

Antwoord 200

{
  "projects": [
    {
      "id": "9d5d550a-5f41-4762-b3cf-6e6e25bb8121",
      "name": "SubReply",
      "target_region": "fr",
      "keywords": ["prospection reddit", "acquisition", "social selling"],
      "ai_agent_enabled": true,
      "created_at": "2026-07-03T12:32:55.820434+00:00"
    }
  ]
}

Doorschakelen naar een scan

const { projects } = await (
  await fetch("https://subreply.io/api/v1/projects", {
    headers: { Authorization: `Bearer ${process.env.SUBREPLY_API_KEY}` },
  })
).json();

const project = projects[0];

const scan = await fetch("https://subreply.io/api/v1/scrape", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${process.env.SUBREPLY_API_KEY}`,
  },
  body: JSON.stringify({
    subreddits: ["r/entrepreneur"],
    keywords: project.keywords,
    // /api/v1/scrape n'accepte que fr et en : toute autre valeur part sans
    // filtre de langue plutôt qu'en erreur 400.
    target_language: ["fr", "en"].includes(project.target_region)
      ? project.target_region
      : null,
  }),
});

Velden van het antwoord

Veld	Type	Beschrijving
`projects[].id`	string	Identificatie van het project (UUID). Dezelfde die in de URL van het dashboard staat.
`projects[].name`	string	Naam van het project, precies zoals ingevoerd.
`projects[].target_region`	string	Doeltaal van het project: `fr`, `en` of `nl`. Een lege tekenreeks als het project er geen heeft, en een vrije waarde (« France ») bij projecten van vóór de taalkiezer.
`projects[].keywords`	string[]	Zoekwoorden van het project. Ze gaan zo door naar /api/v1/scrape.
`projects[].ai_agent_enabled`	boolean	De AI-agent staat aan voor dit project: hij scant en publiceert elke dag zelfstandig.
`projects[].created_at`	string	Aanmaakdatum van het project, in ISO 8601-formaat.

De interne velden van een project verlaten de server nooit: het gegenereerde klantprofiel, de gevolgde subreddits, de cachestatus van de scan. Wat deze pagina beschrijft is alles wat de route teruggeeft, vandaag en na elke volgende productwijziging.

Fouten

Een account zonder projecten is geen fout: de route antwoordt 200 met projects: []. Een mislukte lezing antwoordt 500 — nooit een lege lijst, want die zou je laten denken dat je projecten verdwenen zijn. De codes staan in detail op de pagina foutcodes.