API de Influencity: qué es y cómo usarla
Descubre qué puedes hacer con la API de Influencity
La API de Influencity permite que tus propias herramientas y sistemas trabajen directamente con Influencity, para que tu equipo deje de exportar y copiar datos a mano. Tus desarrolladores (o un asistente de IA) pueden crear Trackings, analizar perfiles y extraer datos de publicaciones directamente en tus dashboards, tu data warehouse o tu herramienta de BI.
Todo lo que se crea a través de la API aparece también en la plataforma de Influencity: los mismos perfiles, las mismas publicaciones, los mismos informes. Tu equipo siguen trabajando en la plataforma mientras los pasos repetitivos se ejecutan en segundo plano.
Este artículo te ayuda a:
- entender qué es la API y en qué se diferencia de un MCP y de los conectores de IA
- ver qué puede hacer hoy
- saber qué necesitas, cuánto cuesta en créditos y cuáles son los límites
- dar tus primeros pasos
Cómo se relaciona la API con MCP y los conectores de IA
La API es la base. El conector de IA de Influencity para Claude y ChatGPT está construido sobre ella, para los equipos que prefieren trabajar con lenguaje natural y sin código. Un MCP no sustituye a la API.

Ambos requieren el add-on de API y ambos consumen los mismos créditos. Para una comparación completa y una guía sobre cuál encaja mejor con tu rol, consulta API vs conector de IA: ¿cuál debes usar? . Para ver los pasos de configuración, consulta Conector de IA de Influencity para Claude y ChatGPT .
Qué puedes hacer con la API
La API de Influencity actualmente, cubre dos áreas de la aplicación: el Tracking de contenido (seguimiento de las publicaciones que genera una campaña) y los perfiles de influencers.

Tracking de contenido
Un Tracking recopila las publicaciones que coinciden con los hashtags, menciones o palabras clave de una campaña, o que provienen de creadores concretos.
|
Qué quieres hacer |
Qué hace la API |
Endpoint |
|
Iniciar el tracking de una campaña |
Crea un Tracking con un nombre único, fechas de inicio y fin y al menos un hashtag, mención o palabra clave (hasta 5 de cada uno). Puedes añadir perfiles al crearlo |
POST /content-tracking/v1/trackings |
|
Hacer Tracking de un perfil |
Crea un Tracking de perfil para uno de tus propios perfiles |
POST /content-tracking/v1/trackings/profile |
|
Ver tus Trackings |
Lista los Trackings página a página, ordenados por nombre, fechas, estado o tipo |
GET /content-tracking/v1/trackings |
|
Extraer las publicaciones |
Devuelve las publicaciones de un Tracking con sus métricas, hasta 100 por página |
GET /content-tracking/v1/trackings/{trackingId}/publications |
|
Editar perfiles en el tracking |
Añade perfiles a un Tracking o los elimina |
POST o DELETE /content-tracking/v1/trackings/{trackingId}/profiles |
|
Pausar o reanudar |
Pausa Trackings activos o reanuda Trackings pausados |
POST /content-tracking/v1/trackings/pause o /resume |
|
Actualizar datos bajo demanda |
Solicita una actualización de los datos de un Tracking |
POST /content-tracking/v1/trackings/{trackingId}/refresh |
|
Consultar tus espacios disponibles de Tracking |
Muestra cuántos slots de perfil te quedan |
GET /content-tracking/v1/trackings/quota |
Perfiles de creadores
|
Qué quieres hacer |
Qué hace la API |
Endpoint |
|
Añadir un creador |
Añade un perfil a tu IRM a partir de un nombre de usuario o una URL pública, con o sin análisis |
POST /profiles/v1/profiles |
|
Leer los datos de un creador |
Devuelve un perfil por red y nombre de usuario, o por ID de perfil |
GET /profiles/v1/profiles o /profiles/v1/profiles/{profileId} |
|
Analizar o volver a analizar |
Inicia un análisis para un perfil que has añadido, o actualiza uno ya analizado |
POST /profiles/v1/profiles/{profileId}/analyze o /refresh |
|
Eliminar un creador |
Elimina un perfil. No es posible mientras esté incluído en otros trackings, reportes, campañas activas… |
DELETE /profiles/v1/profiles/{profileId} |
|
Consultar tus análisis restantes |
Muestra los análisis de perfil restantes del periodo actual |
GET /profiles/v1/profiles/quota |
Cuando un perfil ha sido analizado, la respuesta puede incluir seguidores, media de likes, comentarios y visualizaciones, el género, la edad, el país y la ciudad predominantes de la audiencia, los intereses del creador y los precios estimados. Los precios estimados son estimaciones, no las tarifas reales del creador. El análisis de perfiles está disponible para Instagram, TikTok, YouTube y Twitch; otras redes pueden añadirse sin análisis.
Algunas acciones dependen de tu plan. Si una funcionalidad no está activada para tu marca, la API devuelve un error 403. La actualización bajo demanda de un Tracking, por ejemplo, puede no estar disponible en todos los planes.
Puedes consultar todos los detalles de solicitudes y respuestas en la documentación de la API de Influencity.
Casos de uso ilustrativos
Estos son ejemplos de cómo los equipos pueden usar la API, construidos a partir de lo que soportan los endpoints. No son casos de éxito de clientes y no se afirma ningún resultado.
Agencias: reporting para clientes en tu propio dashboard
- Problema: cada semana alguien exporta métricas de campaña y las pega en los informes de los clientes.
- Flujo de trabajo: tus desarrolladores listan los Trackings activos, extraen las publicaciones de cada Tracking página a página y las cargan en tu portal de reporting con tu marca, junto a los datos de paid media y de analítica web.
- Qué consigues: métricas a nivel de publicación (likes, comentarios… todo lo que ves en la plataforma) en el lugar donde tus clientes ya miran. Tu equipo sigue decidiendo qué significan los números.
Marcas: datos de influencers en tu data warehouse
- Problema: los resultados de influencers viven en una herramienta, mientras que los datos de ventas y de medios viven en otra.
- Flujo de trabajo: una función programada lee las publicaciones y los datos de perfil a través de la API y los escribe en tu data warehouse o herramienta de BI, como BigQuery o Snowflake, donde pueden combinarse con el resto de tus datos de marketing.
- Qué consigues: un único conjunto de cifras compartido por la plataforma y tus dashboards, porque ambos leen los mismos datos de Influencity.
Plataformas y herramientas internas: configuración de campañas sin clics
- Problema: cada nueva campaña implica crear un Tracking y añadir creadores a mano.
- Flujo de trabajo: tu herramienta crea el Tracking, añade los perfiles de los creadores y mantiene ambos sistemas alineados mientras la campaña está en marcha. El Tracking aparece en Influencity al instante.
- Qué consigues: una configuración repetible. Cada creador añadido a un Tracking activo usa un slot de Tracking, así que revisa tu cuota antes (consulta «Créditos, límites y costes»).
¿No tienes desarrolladores disponibles? El conector de IA ofrece una vía sin código para parte de esto. Consulta el artículo sobre el conector de IA.
Antes de empezar
|
Necesitas |
Detalles |
|
El add-on de API |
El acceso a la API se añade a tu plan actual y está disponible para planes anuales. Consulta los precios con tu Account Manager o solicita acceso a través de la web de Influencity |
|
Un token de API |
Una clave secreta que identifica a tu marca. Tus solicitudes se limitan a los datos de esa marca |
|
Alguien que pueda enviar solicitudes web |
Tus desarrolladores, tu equipo de datos o una herramienta de integración. La API es una API REST que intercambia JSON, así que sirve cualquier cosa que pueda enviar solicitudes HTTP |
|
Créditos que gastar |
Los análisis y los espacios de Tracking provienen de tu plan, igual que en la plataforma (consulta «Créditos, límites y costes») |
Trata tu token como una contraseña. Cualquier persona que lo tenga puede leer y modificar los datos de tu marca a través de la API. Guárdalo en un gestor de secretos, nunca en documentos compartidos ni en código público, y revócalo si crees que ha quedado expuesto.
Quién hace qué: tu Account Manager activa el add-on de API, una persona con acceso a los ajustes de tu marca crea el token, y tu equipo técnico desarrolla y prueba la integración.
Empieza en cuatro pasos
- Solicita acceso a la API. Contacta con tu Account Manager o solicita acceso a través de la web de Influencity. Activarán el add-on de API para tu marca.
- Obtén tu token de API. Una persona con acceso a los ajustes de tu marca lo crea en Influencity, en Ajustes → API Key, donde también se listan y se revocan los tokens. Una marca puede tener hasta 10 tokens activos a la vez, y los tokens revocados no cuentan para ese límite.
- Envía una primera solicitud simple. Consulta tus análisis de perfil restantes. Solo lee datos.
- Construye paso a paso. Continúa listando tus Trackings, después leyendo las publicaciones de uno de ellos y, por último, creando o modificando elementos.

Paso 3: tu primera solicitud
Cada solicitud envía tu token en la cabecera Authorization, usando el esquema Bearer:
curl "<API BASE URL>/profiles/v1/profiles/quota" \-H "Authorization: Bearer <YOUR_API_TOKEN>"
Qué deberías ver: una respuesta JSON breve con dos números: los análisis que te quedan en este periodo y tu límite. En el ejemplo de la documentación son 42 y 100. Un valor null significa ilimitado.
{"remainingAnalysisPerPeriod": 42,"analysisLimitPerPeriod": 100}
Si falla: un error 401 significa que el token falta o no es válido. Un 403 significa que la funcionalidad no está activada en el plan de tu marca. Consulta «Resolución de problemas» más abajo.
Consejos para tu primera semana
- Empieza con llamadas de solo lectura y un Tracking de prueba antes de automatizar nada.
- Leer datos y consultar cuotas no consume créditos de análisis ni espacios de Tracking. Analizar un perfil o añadir creadores a un Tracking activo sí.
- Mantén tus solicitudes por debajo del límite de frecuencia (consulta la siguiente sección) y lee las cabeceras de respuesta X-RateLimit-Limit y X-RateLimit-Reset para regular el ritmo.
Créditos, límites y costes
La API usa los mismos créditos que la plataforma. No hay un saldo aparte y se aplican los mismos límites que en la app. Hay dos tipos de créditos principales:
- Análisis de perfil: una cuota por periodo, que se usa cuando analizas o actualizas un perfil de creador.
- Espacios de Tracking: el número de perfiles que puedes tener en Trackings activos al mismo tiempo.
|
Acción |
Qué consume |
|
Leer datos (perfiles, Trackings, publicaciones, cuotas) |
Ningún crédito de análisis ni espacio de Tracking |
|
Añadir un perfil sin análisis |
Ningún crédito de análisis |
|
Analizar o actualizar un perfil |
1 análisis de perfil |
|
Crear un Tracking |
Nada en sí mismo; los espacios de Tracking los usan los perfiles a los que se trackea |
|
Añadir un creador a un Tracking activo, o reanudar un Tracking pausado |
Espacios de Tracking, hasta 1 por perfil |
|
Pausar un Tracking o eliminar creadores de él |
Ningún crédito |
|
Actualizar un Tracking |
Ningún crédito. Requiere que tu plan incluya la funcionalidad y hay un tiempo mínimo entre actualizaciones |
Pregunta tu cuota antes de las acciones masivas, para que un trabajo grande no se detenga a medias.
Límites de solicitudes
Los límites se cuentan por organización, así que todos los tokens de una misma marca los comparten.
|
Límite |
Valor |
|
Frecuencia estándar |
10 solicitudes por segundo (ráfaga de 10) |
|
Cuota diaria |
100.000 solicitudes |
|
Actualizar un Tracking |
1 solicitud por segundo |
|
Añadir un perfil |
2 solicitudes por segundo |
A modo orientativo, añadir 100 perfiles a un Tracking lleva unos 10 segundos con la frecuencia estándar. Si superas la frecuencia, la API responde 429 con el código RATE_LIMIT_EXCEEDED; espera y vuelve a intentarlo. Si agotas la cuota diaria, responde 429 con QUOTA_EXCEEDED, y se restablece al día siguiente. Los límites documentados pueden cambiar e Influencity comunicará las actualizaciones relevantes.

Resolución de problemas
Los errores llegan en un único formato JSON, con un código de error y un mensaje. El estado HTTP te indica por dónde empezar a buscar.
|
Estado |
Qué suele significar |
Qué hacer |
|
400 |
La solicitud no es válida: falta un campo, el formato es incorrecto o el valor no es válido. Por ejemplo, un Tracking necesita fechas de inicio y fin y al menos un hashtag, mención o palabra clave |
Revisa la solicitud con la documentación |
|
401 |
El token falta o no es válido |
Revisa la cabecera de la petición y que el token no haya sido revocado |
|
403 |
La funcionalidad no está activada en el plan de tu marca, o los perfiles de IRM no están activados |
Contacta con tu Account Manager |
|
404 |
El perfil o el Tracking no existe o no pertenece a tu marca, o no se ha podido encontrar el perfil |
Revisa el ID, o el nombre de usuario y la red |
|
409 |
Un conflicto: ya existe un Tracking con ese nombre, un perfil ya tiene su propio Tracking, un perfil ya está siendo analizado, un Tracking ha finalizado y no admite nuevos perfiles, o un perfil no puede eliminarse por Trackings o campañas activos |
Usa el elemento existente o resuelve antes el conflicto. En el caso de un perfil duplicado, el error puede incluir el ID del perfil existente |
|
422 |
Se ha incumplido una regla de negocio, por ejemplo, no quedan análisis en este período, no hay suficientes espacios de Tracking, o se intenta pausar un Tracking que no está activo |
Revisa tus cuotas y el estado del Tracking |
|
429 |
Demasiadas solicitudes (RATE_LIMIT_EXCEEDED), la cuota diaria está agotada (QUOTA_EXCEEDED), o se actualizó un Tracking hace muy poco |
Espera y vuelve a intentarlo. Si la actualización es demasiado pronto, la respuesta indica cuántas horas esperar |
|
502, 503, 504 |
Un problema temporal del servicio o un timeout |
Inténtalo de nuevo en unos minutos. Pide páginas más pequeñas si los timeouts continúan |
Consejo: reintenta automáticamente solo ante errores de límite de frecuencia y en solicitudes de lectura. Si una solicitud que crea o modifica algo da timeout, comprueba el resultado antes de volver a enviarla, para no repetir la acción.
Preguntas frecuentes
¿Necesito saber programar? Para usar la API directamente, sí, o necesitas a un compañero o una herramienta de integración que pueda enviar solicitudes web. Si prefieres una vía sin código, usa el conector de IA para Claude o ChatGPT.
¿Lo que cree a través de la API aparecerá en la plataforma? Sí. Los Trackings, perfiles y publicaciones creados a través de la API son los mismos que ve tu equipo en Influencity.
¿La API consume mis créditos? Sí, usa los mismos análisis y espacios de Tracking que la plataforma, y no hay un saldo aparte. Leer datos no los consume.
¿La API es lo mismo que el conector de IA? El conector usa la API por debajo y cubre perfiles, Trackings y créditos. La API es la base para construir tus propias integraciones.
¿Qué asistentes de IA funcionan con el conector de Influencity? Claude y ChatGPT.
¿Cuántos tokens de API puede tener mi marca? Hasta 10 tokens activos a la vez. Los tokens revocados no cuentan.