Check an Instagram profile or Facebook page before tracking it
social_competitors.lookup.preview
LecturaIdempotenteDesde 2026-11-01
Checks, live against Meta, that an Instagram profile (platform instagram) or a Facebook page (platform facebook) can be tracked, and returns its public card: display_name, handle (the identifier to save: the Instagram username or the page id), avatar_url, followers, verified and extra (e.g. post count). identifier accepts a username, @handle, page id or profile URL. Instead of failing it returns ok=false with error: NOT_FOUND (no such profile), NOT_BUSINESS (a personal Instagram account: Instagram only exposes Business/Creator accounts), NO_OWN_IG (the organization has no Instagram Business account of its own connected, needed to look up others), META_NOT_CONNECTED, EMPTY, or LOOKUP_FAILED with the provider's detail. For YouTube use social_competitors.lookup.youtube_channel. Spends Meta quota. Requires edit access to Competitors.
Alcance
social_competitors:read
Permiso
Editar en el módulo
Tool del MCP
social_competitors_lookup_previewEn la superficie completa; en la compacta, mb_execute_operation con id: "social_competitors.lookup.preview".
Costo declarado: hasta 3 lecturas y 0 escrituras por llamada (cuentan en el cupo diario). Toca una plataforma externa (meta): cuenta en el cupo de operaciones externas.
Parámetros
platformenumqueryrequerido
instagram or facebook (for YouTube use social_competitors.lookup.youtube_channel).
Valores: instagram, facebook
identifierstringqueryrequerido
Username, @handle, page id or profile URL (it is normalized: https://instagram.com/nike → nike).
Respuesta
okboolean
true when the profile was found and can be tracked.
errorstring
Why not, when ok is false: NOT_FOUND, NOT_BUSINESS (not an Instagram Business or Creator account), NO_OWN_IG (the organization has no Instagram of its own connected), META_NOT_CONNECTED, EMPTY or LOOKUP_FAILED (then detail).
detailstring
With LOOKUP_FAILED: what the network said.
display_namestring
handlestring
The identifier to send in social_competitors.competitors.create.
avatar_urlstring
followersnumber
verifiedboolean
Facebook only: whether the Page is verified (Instagram does not say).
post_countnumber
Instagram: the profile's posts.
extrastring
The line the screen shows under the profile (in Spanish); use post_count instead.
Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.En la práctica esta operación no se simula (toca otra plataforma): responde 409 sandbox_external_unavailable.
GET/v1/social-competitors/lookup/facebook-pages
Search Facebook pages by name
social_competitors.lookup.facebook_pages
LecturaIdempotenteDesde 2026-11-01
Searches public Facebook pages by name through Meta (up to 8 results: id, name, verified, link), to find the page_id of a competitor's page. If the person already has the page URL or username, social_competitors.lookup.preview with platform facebook resolves it directly. Errors: 409 integration_not_connected (details.platform meta: connect Meta in Settings → Integrations), 409 external_rejected (Meta rejected the search: its code in details.provider_code and its text in provider_message), 429 external_rate_limited or 503 external_unavailable (Meta is limiting or not answering: retry after retry_after), 409 integration_reconnect_required (the Meta connection expired). Spends Meta quota. Requires edit access to Competitors.
Alcance
social_competitors:read
Permiso
Editar en el módulo
Tool del MCP
social_competitors_lookup_facebook_pagesEn la superficie completa; en la compacta, mb_execute_operation con id: "social_competitors.lookup.facebook_pages".
Costo declarado: hasta 2 lecturas y 0 escrituras por llamada (cuentan en el cupo diario). Toca una plataforma externa (meta): cuenta en el cupo de operaciones externas.
Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.En la práctica esta operación no se simula (toca otra plataforma): responde 409 sandbox_external_unavailable.
GET/v1/social-competitors/lookup/prerequisites
Which platforms the organization can track
social_competitors.lookup.prerequisites
LecturaIdempotenteDesde 2026-11-01
Says which competitor platforms this organization can track right now, without calling any platform: meta (Meta connected, its own or inherited from its agency: needed for Instagram and Facebook), own_instagram (its own Instagram Business account connected: needed to read other Instagram profiles) and youtube (YouTube connected or the server's public key available). Use it before adding a competitor to tell the person what to connect in Settings → Integrations. Requires view access to Competitors.
Alcance
social_competitors:read
Permiso
Ver el módulo
Tool del MCP
social_competitors_lookup_prerequisitesEn la superficie completa; en la compacta, mb_execute_operation con id: "social_competitors.lookup.prerequisites".
Costo declarado: hasta 6 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).
