Zoosial
docs
InicioInvestigación de mercado
Volver al sitio Volver al Dashboard
Zoosial
Buscar en docs...
⌘K
APIs

Investigación de mercado

Qué le funciona a la competencia, qué se publica en un hashtag, qué dicen de tu marca, qué anuncios corren y qué tan grande es un nicho. Todo es de solo lectura y usa una cuenta que ya conectaste como «lente»: :id es el id de esa cuenta. Cada endpoint tiene su herramienta MCP equivalente.

Competencia en Instagram

Perfil público y últimos posts de cualquier cuenta de negocio o creador (las personales y las privadas no salen). Cada post trae like_count, comments_count, view_count (solo cuando Meta lo da) y tres números calculados: interactions, engagementRate (contra seguidores) y vsAverage. vsAverage 2 = ese post tuvo el doble de interacción que lo normal en esa cuenta: así se ve qué le funciona. No trae el texto de los comentarios; si la cuenta ocultó sus likes, solo cuentan los comentarios.

GET
/accounts/:id/research/instagram/:username?limit=25
Cuenta de Instagram conectada. limit máx. 50. Acepta el usuario con o sin @.
MCP: research_instagram_account
bash
curl https://zoosial.com/accounts/acc_ig/research/instagram/starbucksmexico \
  -H "Authorization: Bearer $SC_API_KEY"

Hashtags

Posts públicos de un hashtag: type=top (los de más interacción) o recent (últimas 24 h), con el mismo ranking.

GET
/accounts/:id/research/hashtag/:tag?type=top|recent
Cuenta de Instagram conectada. El tag va sin #.
MCP: research_hashtag
Pendiente de aprobación de Meta («Instagram Public Content Access»). Mientras tanto responde 422 explicándolo; cuando Meta lo apruebe funciona sin cambiar tu integración. Límite de Meta: 30 hashtags distintos por cuenta cada 7 días (repetir uno no gasta).

Menciones de tu marca

GET
/accounts/:id/research/tagged?limit=&after=
Posts de otras cuentas donde etiquetaron a tu Instagram, con el username de quién lo publicó.
MCP: research_tagged

Biblioteca de anuncios

GET
/accounts/:id/research/ad-library?q=&pageIds=&country=MX
Anuncios por palabras (q) o por páginas (pageIds, ids separados por coma). Cada anuncio trae page_name, textos, fechas, plataformas y libraryUrl para verlo.
MCP: research_ad_library
México: fuera de la Unión Europea Meta solo publica por API los anuncios políticos y de temas sociales, así que con marcas normales lo esperable es una lista vacía. Con un país de la UE (ES, FR…) sí trae anuncios comerciales. Requiere que la persona que conectó Facebook haya confirmado su identidad en Meta.

Tamaño de nicho (anuncios)

Con una cuenta publicitaria de Meta conectada. No gastan nada.

GET
/ads/targeting-search?adAccountId=&q=
Intereses de anuncios que coinciden con q, con audience_size_lower_bound / upper_bound.
MCP: targeting_search
POST
/ads/audience-estimate { adAccountId, targeting }
Usuarios activos al mes de un targeting completo (el mismo objeto que un ad set: geo_locations, age_min, flexible_spec…).
MCP: audience_estimate
bash
curl -X POST https://zoosial.com/ads/audience-estimate \
  -H "Authorization: Bearer $SC_API_KEY" -H "Content-Type: application/json" \
  -d '{"adAccountId":"ad_123","targeting":{"geo_locations":{"countries":["MX"]},"age_min":25}}'

Tu audiencia

GET
/accounts/:id/insights?metric=follower_demographics&period=lifetime&metricType=total_value&breakdown=city&timeframe=this_month
Seguidores de Instagram por edad, género, ciudad o país (breakdown). Meta pide 100+ seguidores.
MCP: account_insights
GET
/accounts/:id/insights?metric=online_followers&period=lifetime
Horas en que tus seguidores están conectados: para decidir cuándo publicar.
MCP: account_insights

Lo que Meta no da

Ninguna API de Meta entrega audios en tendencia, una lista de «lo viral» ni posts de cuentas personales. Lo viral se arma combinando competencia + hashtags y quedándose con lo que está muy por encima de su promedio (vsAverage alto).

En esta página
Competencia en Instagram Hashtags Menciones de tu marca Biblioteca de anuncios Tamaño de nicho (anuncios) Tu audiencia Lo que Meta no da
¿Tienes dudas?
Nuestro equipo responde en menos de 2h
Contactar soporte