api-referenceGET
GEThttps://analytics.flowsery.com/analytics/api/v1/goals

Obtener datos de análisis segmentados por objetivos personalizados. Los parámetros de filtro acotan qué visitantes aportan las conversiones contadas; limit y offset paginan la lista de objetivos.

Token Bearer (token de workspace o clave API de sitio web)

Los tokens de espacio de trabajo necesitan un selector de sitio web

Los tokens de API del espacio de trabajo pueden acceder a todos los sitios web del espacio de trabajo. Pase websiteId o domain para que Flowsery sepa qué sitio web consultar o mutar. Las claves API del sitio web ya están destinadas a un sitio web, por lo que se puede omitir el selector.

Selector de sitios web

ParámetroTipoDescripción
websiteIdstringID del sitio web para usar con un token de API del espacio de trabajo. Omitir al autenticarse con una clave API de sitio web.
domainstringSitio web domain para usar con un token API de espacio de trabajo cuando no se proporciona websiteId. Omitir al autenticarse con una clave API de sitio web.

Parámetros opcionales

ParámetroTipoDescripción
startAtstringFecha/hora de inicio ISO 8601. El valor predeterminado es los últimos 30 días cuando se omite.
endAtstringFecha/hora de finalización ISO 8601. El valor predeterminado es ahora cuando se omite.
timezonestringZona horaria para la agregación (por ejemplo, UTC, America/New_York). Recurre a la zona horaria configurada de su sitio.
limitnumberMáximo de filas a devolver (1-1000, predeterminado: 100).
offsetnumberFilas a omitir para paginación (mín. 0, predeterminado: 0).

Parámetros de filtro

ParámetroTipoDescripción
filter_countrystringNombre del país tal como lo devuelve /countries, p. ej. United States. Usa | para varios valores, ! para excluir y ~ para una coincidencia parcial.
filter_regionstringNombre de la región o el estado tal como lo devuelve /regions, p. ej. California.
filter_citystringNombre de ciudad.
filter_devicestringTipo de dispositivo: Desktop, Mobile o Tablet. Los valores distinguen mayúsculas y minúsculas.
filter_browserstringNombre del navegador. Safari incluye Mobile Safari automáticamente.
filter_osstringSistema operativo.
filter_referrerstringReferente tal como lo devuelve /referrers: un nombre de fuente como Google para los sitios reconocidos y, si no, el dominio.
filter_refstringEl parámetro de URL ref.
filter_sourcestringEl parámetro de URL source.
filter_viastringEl parámetro de URL via.
filter_utm_sourcestringFuente UTM.
filter_utm_mediumstringMedio UTM.
filter_utm_campaignstringCampaña UTM.
filter_utm_termstringTérmino UTM.
filter_utm_contentstringContenido UTM.
filter_pagestringRuta de página.
filter_entry_pagestringRuta de página de entrada.
filter_hostnamestringNombre de host/dominio.
filter_channelstringCanal de marketing.
filter_goalstringNombre del objetivo.
Solicitud de ejemplo (curl)
curl --request GET \
  --url https://analytics.flowsery.com/analytics/api/v1/goals \
  --header 'Authorization: Bearer <api-key>'
200
{
  "status": "success",
  "data": [
    {
      "id": "goal_123",
      "createdAt": "2026-04-01T10:15:00.000Z",
      "updatedAt": "2026-04-14T08:30:00.000Z",
      "name": "newsletter_signup",
      "description": null,
      "isServer": false,
      "completions": 49730,
      "visitors": 49730
    },
    {
      "id": "goal_124",
      "createdAt": "2026-04-02T09:00:00.000Z",
      "updatedAt": "2026-04-14T08:30:00.000Z",
      "name": "payment",
      "description": "Tracked from the backend",
      "isServer": true,
      "completions": 35100,
      "visitors": 35100
    }
  ],
  "pagination": {
    "limit": 5,
    "offset": 0,
    "total": 48
  }
}