API de plataforma de EveryData
API de Facebook
Consulta contenido público de Facebook: publicaciones, páginas, comentarios, grupos, anuncios, Marketplace y reseñas. Cada acción exige el identificador adecuado y no amplía la visibilidad del objeto.
Contadores agregados no equivalen a listas nominales, y una URL pública no abre perfiles o grupos privados. Los anuncios devuelven creatividad visible, no gasto, segmentación o conversiones internas.
- Endpoint
- POST /api/v1/social
- Funciones
- 10
- Por 1.000
- 1,389 US$–2,778 US$
Funciones disponibles
Compara las acciones de Facebook por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar publicaciones públicas en Facebook Busca publicaciones públicas de Facebook mediante | keyword | content_type, since, until | Entrega síncrona | El catálogo declara `defaultLimit = 10` y `maxLimit = 200` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · text · author_name · author_username · like_count · comment_count · share_count · posted_at · platform |
profileConsultar una página o perfil público Abre la | url | — | Entrega asíncrona | — | $2.78 por 1.000 solicitudes | id · name · url · bio · category · like_count · follower_count · is_verified · phone · email · website · rating · rating_scale · avatar_url · platform |
user_postsListar publicaciones de una cuenta Lee publicaciones públicas asociadas a la | url | — | Entrega asíncrona | El catálogo declara `defaultLimit = 10` y `maxLimit = 50` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $2.78 por 1.000 solicitudes | id · url · text · author_name · author_username · like_count · comment_count · share_count · posted_at · platform |
postConsultar una publicación de Facebook Consulta por | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · text · author_name · author_username · like_count · comment_count · share_count · posted_at · platform |
commentsLeer comentarios de una publicación Obtiene comentarios de la | url | — | Entrega asíncrona | El catálogo declara `defaultLimit = 10` y `maxLimit = 50` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $2.78 por 1.000 solicitudes | id · text · author_name · author_username · like_count · reply_count · posted_at · reply_to_id · platform |
followersRevisar métricas de seguidores Recibe | username | channel | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform |
adsBuscar anuncios visibles de Facebook Busca anuncios visibles por | keyword | country, status | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 200` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · text · title · cta_text · link_url · is_active · started_at · ended_at · platforms · variant_count · advertiser_id · advertiser_name · advertiser_url · advertiser_likes · image_url · platform |
group_postsLeer publicaciones de un grupo Lee publicaciones del grupo indicado por | url | sort | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 200` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · text · posted_at · like_count · comment_count · share_count · author_id · author_name · author_url · group_url · platform |
marketplaceBuscar anuncios de Marketplace Busca listings de Marketplace con | keyword | location | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 200` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · name · price · currency · city · state · condition · image_url · posted_at · platform |
reviewsConsultar recomendaciones y reseñas Consulta recomendaciones o reseñas de la | url | — | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 200` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · text · is_recommended · rating · rating_scale · posted_at · like_count · comment_count · author_id · author_name · author_url · platform |
¿Qué acepta cada acción de Facebook?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
¿Qué significan los parámetros de Facebook search?
Busca publicaciones públicas de Facebook mediante keyword, con tipo de contenido y fechas opcionales. Devuelve autor, texto e interacciones observadas; no busca mensajes privados ni garantiza cobertura histórica.
keywordObligatorio- Para
search, busca publicaciones públicas. Paraads, busca palabras clave de anuncios; también puedes enviar la URL de la biblioteca de anuncios o de la página. Paramarketplace, busca términos de productos; también puedes enviar la URL completa de una búsqueda de Marketplace. Estas tres acciones tienen alcances diferentes y no devuelven los mismos resultados. content_typeOpcional- Criterio de orden para
search:latestpara las publicaciones más recientes omost_popularpara las más populares. Aunque el parámetro se llamacontent_type, no filtra por formato de imagen o vídeo.Valores permitidos:latestmost_popularFacebook: alcance de publicaciones e información públicasLa ayuda de Facebook describe la visibilidad de publicaciones públicas, contenido de páginas y comentarios públicos. La visibilidad ayuda a definir el objeto, pero no demuestra cobertura total ni concede permiso automático para reutilizar la información.Consultada sinceOpcional- Fecha de inicio del periodo de publicación para
search. Se recomienda el formato YYYY-MM-DD. No filtra por la fecha de inicio de una campaña publicitaria ni por la fecha de los comentarios. untilOpcional- Fecha de fin del periodo de publicación para
search. Se recomienda el formato YYYY-MM-DD y define un rango de fechas junto consince. No controla la fecha de finalización de los anuncios.
¿Qué significan los parámetros de Facebook profile?
Abre la url de una página o perfil público y recoge categoría, biografía, seguidores y datos de contacto expuestos. No amplía la visibilidad, acredita identidad ni autoriza el uso de teléfonos o correos.
urlObligatorio- Envía la URL correspondiente a la acción: para
profileouser_posts, la de una página pública; parapostocomments, la de una publicación; paragroup_posts, la de un grupo o su identificador; parareviews, la de una página de empresa (se añadirá/reviews). No todos los enlaces de Facebook sirven para todas las acciones.Facebook: visibilidad pública de la información, publicaciones y comentarios de una páginaLa documentación oficial trata por separado la información pública en páginas y perfiles, las publicaciones compartidas públicamente y los comentarios. La definición de visibilidad no implica que todos los enlaces sean accesibles o que se devuelvan todos los campos, ni que esta API posea una licencia de acceso de Meta.ConsultadaMeta: la recopilación automatizada de datos requiere permiso previoMeta especifica claramente que obtener datos de Facebook de forma automatizada sin su permiso previo infringe sus condiciones, incluso si los datos son públicamente visibles. La cita de una fuente oficial no constituye una prueba de autorización para la recopilación o reutilización por parte de este servicio.Consultada
¿Qué significan los parámetros de Facebook user_posts?
Lee publicaciones públicas asociadas a la url de una cuenta o página. Conserva autor, fecha y contadores por pieza; el resultado no representa necesariamente todo su Timeline.
urlObligatorio- Envía la URL correspondiente a la acción: para
profileouser_posts, la de una página pública; parapostocomments, la de una publicación; paragroup_posts, la de un grupo o su identificador; parareviews, la de una página de empresa (se añadirá/reviews). No todos los enlaces de Facebook sirven para todas las acciones.Facebook: visibilidad pública de la información, publicaciones y comentarios de una páginaLa documentación oficial trata por separado la información pública en páginas y perfiles, las publicaciones compartidas públicamente y los comentarios. La definición de visibilidad no implica que todos los enlaces sean accesibles o que se devuelvan todos los campos, ni que esta API posea una licencia de acceso de Meta.ConsultadaMeta: la recopilación automatizada de datos requiere permiso previoMeta especifica claramente que obtener datos de Facebook de forma automatizada sin su permiso previo infringe sus condiciones, incluso si los datos son públicamente visibles. La cita de una fuente oficial no constituye una prueba de autorización para la recopilación o reutilización por parte de este servicio.Consultada
¿Qué significan los parámetros de Facebook post?
Consulta por url una publicación concreta de Facebook y devuelve texto, autor, fecha e interacciones visibles. No incluye automáticamente comentarios, reacciones detalladas ni contenido privado.
urlObligatorio- Envía la URL correspondiente a la acción: para
profileouser_posts, la de una página pública; parapostocomments, la de una publicación; paragroup_posts, la de un grupo o su identificador; parareviews, la de una página de empresa (se añadirá/reviews). No todos los enlaces de Facebook sirven para todas las acciones.Facebook: visibilidad pública de la información, publicaciones y comentarios de una páginaLa documentación oficial trata por separado la información pública en páginas y perfiles, las publicaciones compartidas públicamente y los comentarios. La definición de visibilidad no implica que todos los enlaces sean accesibles o que se devuelvan todos los campos, ni que esta API posea una licencia de acceso de Meta.ConsultadaMeta: la recopilación automatizada de datos requiere permiso previoMeta especifica claramente que obtener datos de Facebook de forma automatizada sin su permiso previo infringe sus condiciones, incluso si los datos son públicamente visibles. La cita de una fuente oficial no constituye una prueba de autorización para la recopilación o reutilización por parte de este servicio.Consultada
¿Qué significan los parámetros de Facebook comments?
Obtiene comentarios de la url de una publicación y conserva autor, fecha, likes y referencia de respuesta cuando existe. No publica respuestas ni garantiza reconstruir el árbol completo.
urlObligatorio- Envía la URL correspondiente a la acción: para
profileouser_posts, la de una página pública; parapostocomments, la de una publicación; paragroup_posts, la de un grupo o su identificador; parareviews, la de una página de empresa (se añadirá/reviews). No todos los enlaces de Facebook sirven para todas las acciones.Facebook: visibilidad pública de la información, publicaciones y comentarios de una páginaLa documentación oficial trata por separado la información pública en páginas y perfiles, las publicaciones compartidas públicamente y los comentarios. La definición de visibilidad no implica que todos los enlaces sean accesibles o que se devuelvan todos los campos, ni que esta API posea una licencia de acceso de Meta.ConsultadaMeta: la recopilación automatizada de datos requiere permiso previoMeta especifica claramente que obtener datos de Facebook de forma automatizada sin su permiso previo infringe sus condiciones, incluso si los datos son públicamente visibles. La cita de una fuente oficial no constituye una prueba de autorización para la recopilación o reutilización por parte de este servicio.Consultada
¿Qué significan los parámetros de Facebook followers?
Recibe username y devuelve contadores y señales de conexión de la cuenta, con channel compatible. Es una lectura agregada, no la lista nominal de todos los seguidores.
usernameObligatorio- Identificador de la cuenta o página de Facebook para
followers, sin @. Esta acción devuelve un objeto con el número de seguidores, no la lista de seguidores, por lo que no se puede usar para exportarla.Facebook: seguir una página y darle «Me gusta» no es lo mismoLa documentación oficial explica que seguir (`Follow`) una página sirve para recibir sus actualizaciones y aclara las diferencias cuando una página pasa de usar «Me gusta» a «Seguir». Se usa para distinguir entre `follower_count` y `like_count`, sin que esto demuestre que se pueda exportar la lista de seguidores.Consultada channelOpcional- Parámetro compatible con el identificador de cuenta en
followers. Si ya se proporcionausername, este tiene prioridad. La petición pública debe incluir igualmente el parámetro obligatoriousername. No se refiere a un ID de un canal de chat.
¿Qué significan los parámetros de Facebook ads?
Busca anuncios visibles por keyword y permite acotar país o estado. Devuelve creatividad textual, CTA, destino y fechas publicadas; no revela segmentación privada, gasto, impresiones ni conversiones.
keywordObligatorio- Para
search, busca publicaciones públicas. Paraads, busca palabras clave de anuncios; también puedes enviar la URL de la biblioteca de anuncios o de la página. Paramarketplace, busca términos de productos; también puedes enviar la URL completa de una búsqueda de Marketplace. Estas tres acciones tienen alcances diferentes y no devuelven los mismos resultados.Meta: anuncios y búsqueda de páginas en la Biblioteca de anunciosEl anuncio original explica cómo ver anuncios por palabra clave o página, distinguiendo los datos de transparencia para anuncios generales de los de temática social o política. También especifica los requisitos de acceso a la API oficial. No se puede deducir de esto que todos los anuncios incluyan datos de gasto, impresiones o un historial completo, ya que esta API no cuenta con esos campos de forma estable.Consultada countryOpcional- Código de país para la búsqueda de palabras clave en
ads, comoUS(por defecto). Se convierte a mayúsculas al construir la URL. Sikeywordya es una URL completa, se usan directamente sus condiciones y se ignora este parámetro. statusOpcional- Estado de la campaña publicitaria:
all(todas, por defecto),active(activas) oinactive(inactivas). Es el estado de la campaña, no el de revisión del anuncio. El parámetroactive_statusde la URL de la biblioteca de anuncios y este parámetro son formas de entrada diferentes; no se garantiza que el filtrado sea equivalente en ambos casos.
¿Qué significan los parámetros de Facebook group_posts?
Lee publicaciones del grupo indicado por url, con orden opcional, y devuelve contenido, autor e interacciones públicas. No permite unirse a grupos privados ni garantiza recuperar todas las conversaciones.
urlObligatorio- Envía la URL correspondiente a la acción: para
profileouser_posts, la de una página pública; parapostocomments, la de una publicación; paragroup_posts, la de un grupo o su identificador; parareviews, la de una página de empresa (se añadirá/reviews). No todos los enlaces de Facebook sirven para todas las acciones.Meta: el contenido privado de un grupo sigue protegido aunque este se haga públicoLa documentación oficial aclara que, cuando un grupo se hace público, el contenido nuevo es público, pero las publicaciones y listas de miembros de su etapa privada siguen restringidas. Por tanto, no se puede garantizar el acceso a todo el historial de publicaciones y miembros solo porque un grupo sea público ahora.ConsultadaMeta: la recopilación automatizada de datos requiere permiso previoMeta especifica claramente que obtener datos de Facebook de forma automatizada sin su permiso previo infringe sus condiciones, incluso si los datos son públicamente visibles. La cita de una fuente oficial no constituye una prueba de autorización para la recopilación o reutilización por parte de este servicio.Consultada sortOpcional- Para
group_posts, usatoppara las publicaciones populares orecentpara las que tienen actividad reciente. Si se omite, se ordena por fecha.recentno se basa solo en la fecha de publicación; cualquier otro valor usará el orden cronológico en lugar de devolver un error.
¿Qué significan los parámetros de Facebook marketplace?
Busca listings de Marketplace con keyword y ubicación opcional, conservando precio, moneda, condición e imagen. No compra, contacta al vendedor ni confirma que el artículo siga disponible.
keywordObligatorio- Para
search, busca publicaciones públicas. Paraads, busca palabras clave de anuncios; también puedes enviar la URL de la biblioteca de anuncios o de la página. Paramarketplace, busca términos de productos; también puedes enviar la URL completa de una búsqueda de Marketplace. Estas tres acciones tienen alcances diferentes y no devuelven los mismos resultados. locationOpcional- Identificador de la ruta de la ciudad para
marketplace, comonyc(por defecto). No es una dirección en texto libre. Sikeywordes una URL completa de Marketplace, se usará esa URL y se ignorará el parámetrolocation.Meta: anuncios y búsqueda por ubicación en MarketplaceLa presentación original define Marketplace como una plataforma para anunciar y descubrir productos locales, distinguiendo el nombre del producto, su precio y su ubicación. Solo sirve para definir la semántica de los objetos, sin que las opciones de filtro de la interfaz oficial o el alcance geográfico histórico se consideren capacidades actuales de esta API.Consultada
¿Qué significan los parámetros de Facebook reviews?
Consulta recomendaciones o reseñas de la url de una página y separa texto, valoración y autor. La ausencia de estrellas no invalida una recomendación y el lote no representa a toda la clientela.
urlObligatorio- Envía la URL correspondiente a la acción: para
profileouser_posts, la de una página pública; parapostocomments, la de una publicación; paragroup_posts, la de un grupo o su identificador; parareviews, la de una página de empresa (se añadirá/reviews). No todos los enlaces de Facebook sirven para todas las acciones.Facebook: recomendaciones y reseñas de una páginaLa documentación oficial explica que las recomendaciones se ven en la sección de reseñas (`Reviews`) de una página y señala que la eliminación de comentarios que infringen las normas puede afectar a su puntuación. La puntuación general de la página es distinta de una recomendación individual; el campo `is_recommended` no se puede convertir automáticamente a una valoración por estrellas.ConsultadaMeta: la recopilación automatizada de datos requiere permiso previoMeta especifica claramente que obtener datos de Facebook de forma automatizada sin su permiso previo infringe sus condiciones, incluso si los datos son públicamente visibles. La cita de una fuente oficial no constituye una prueba de autorización para la recopilación o reutilización por parte de este servicio.Consultada
Cómo usar la API de Facebook
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo devuelto si la acción es asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"facebook","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Facebook
¿Cómo llamo a la API de Facebook?
Envía POST /api/v1/social con platform igual a facebook, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Facebook?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye text, author_name, author_username y like_count. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros de origen contengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Facebook?
La ayuda de Facebook describe la visibilidad de publicaciones públicas, contenido de páginas y comentarios públicos. La visibilidad ayuda a definir el objeto, pero no demuestra cobertura total ni concede permiso automático para reutilizar la información.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; profile requiere url; user_posts requiere url; consulta las demás acciones en la lista de funciones.