Endpoints

Listar tus proyectos

Devuelve los proyectos de la cuenta ligada a tu clave API, con sus palabras clave y el estado de su agente IA.

GET/api/v1/projectsGratis

Tus proyectos viven en el panel; este endpoint los hace legibles desde fuera. El uso habitual es recuperar las palabras clave y el idioma objetivo de un proyecto y pasárselos al endpoint de escaneo, en lugar de copiarlos en tu script cada vez que cambian.

El alcance viene de la clave

No hay ningún parámetro para elegir una cuenta: la ruta solo devuelve los proyectos de la cuenta a la que pertenece tu clave. Nada que falsificar, y nada que filtrar por tu parte.

Cabeceras

Cabeceras de la petición

Parámetro	Tipo	Obligatorio	Descripción
`Authorization`	`string`	Obligatorio	Tu clave API, precedida de `Bearer`. Una clave ausente, desconocida o revocada devuelve un `401`.

Sin paginación ni orden que pedir: el plan Starter se queda en tres proyectos, y salen del más reciente al más antiguo.

Ejemplo

cURL

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

Respuesta 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"
    }
  ]
}

Encadenar con un escaneo

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,
  }),
});

Campos de la respuesta

Campo	Tipo	Descripción
`projects[].id`	string	Identificador del proyecto (UUID). Es el que aparece en la URL del panel.
`projects[].name`	string	Nombre del proyecto, tal como lo escribiste.
`projects[].target_region`	string	Idioma objetivo del proyecto: `fr`, `en` o `nl`. Cadena vacía si el proyecto no tiene ninguno, y un valor libre («France») en los proyectos creados antes del selector de idioma.
`projects[].keywords`	string[]	Palabras clave de búsqueda del proyecto. Se pasan tal cual a /api/v1/scrape.
`projects[].ai_agent_enabled`	boolean	El agente IA está activado en este proyecto: escanea y publica solo, cada día.
`projects[].created_at`	string	Fecha de creación del proyecto, en formato ISO 8601.

Los campos internos de un proyecto no salen nunca de aquí: perfil de cliente generado, subreddits vigilados, estados de caché del escaneo. Lo que describe esta página es todo lo que devuelve la ruta, hoy y después de que el producto evolucione.

Errores

Una cuenta sin proyectos no es un error: la ruta responde 200 con projects: []. Una lectura fallida responde 500 — nunca un array vacío, que te haría creer que tus proyectos han desaparecido. El detalle de los códigos está en la página códigos de error.