Facebook Marketplace API
Convierta lugares en coordenadas de búsqueda, descubra artículos públicos de Marketplace por palabra clave y ubicación, o consulte datos detallados de precio, vendedor, contenido multimedia, atributos y disponibilidad a partir de URL conocidas de artículos.
API de Facebook Marketplace disponibles
Use Location Search para resolver un lugar, Search para descubrir artículos alrededor de unas coordenadas o Item para obtener registros detallados a partir de URL conocidas de artículos de Marketplace.
¿Qué datos de Facebook Marketplace se pueden obtener?
SocQ devuelve candidatos de ubicación públicos, resultados de búsqueda de artículos y detalles de artículos normalizados para investigación de mercados locales, análisis de precios, seguimiento de inventario y enriquecimiento de artículos.
Candidatos de ubicación de Marketplace
Convierta el nombre de una ciudad, región, barrio o lugar en ID de ubicación de Facebook, etiquetas, contexto de dirección, latitud y longitud.
Identidad del artículo público
Obtenga los ID de artículos, títulos, descripciones, URL de origen, categorías, el texto de la fecha de publicación y las marcas de tiempo de recolección cuando estén disponibles.
Precios y monedas
Conserve los importes de precio, los códigos de moneda, los precios con formato y los precios tachados disponibles junto con cada artículo normalizado.
Datos de ubicación y entrega
Obtenga las etiquetas de lugar, los valores de ciudad y estado, las coordenadas, los tipos de entrega, las señales de envío y el contexto de retiro en persona que estén disponibles.
Contenido multimedia, atributos y contexto del vendedor
Obtenga las imágenes públicas del artículo, sus atributos, los valores de condición y los campos de identidad del vendedor cuando la fuente los expone.
Disponibilidad y estado del artículo
Conserve las señales de disponible, vendido, pendiente, oculto, activo, mensajería y compra inmediata para analizar los artículos en un momento dado.
SocQ vs Meta Graph API
SocQ se centra en la recolección pública compatible de Marketplace. La Graph API de Meta está diseñada para activos de Meta autorizados y no ofrece una API pública general de búsqueda en Marketplace.
| Funcionalidad | SocQ | Meta Graph API |
|---|---|---|
| Uso principal | Recolección pública de ubicaciones, búsquedas y artículos de Marketplace | Administrar los activos compatibles que una persona o una empresa ha autorizado |
| OAuth del cliente | Clave de API de SocQ; sin OAuth de Facebook del cliente | App de Meta, permisos y tokens de acceso |
| Búsqueda pública de artículos | Compatible con una palabra clave y una ubicación resuelta | Sin un endpoint público general de búsqueda de artículos de Marketplace |
| Crear o editar artículos | No compatible | Sin un endpoint general de publicación en Marketplace para consumidores |
| Formato de respuesta | Registros normalizados de SocQ | Objetos nativos de la Graph API para los productos compatibles |
Cómo funciona la API de Facebook Marketplace
Resuelva un centro de búsqueda cuando haga falta, envíe una búsqueda de artículos o la URL de un artículo conocido y lea los registros normalizados mediante el flujo de tareas asíncronas compartido.
1. Preparar la entrada inicial
Convierta el nombre de un lugar en coordenadas, use coordenadas que ya conozca o comience directamente con la URL pública de un artículo de Marketplace.
2. Enviar y dar seguimiento a la tarea
Envíe la solicitud POST correspondiente, guarde el task_id devuelto y consulte /v1/tasks/{task_id} hasta que el procesamiento termine.
3. Leer los resultados normalizados
Procese data.results.items y siga next_cursor mientras has_more sea true.
Primero resuelva el nombre de un lugar y luego use las coordenadas del candidato elegido para buscar artículos públicos de Marketplace.
# Resolve a place name
curl -X POST "https://api.socq.ai/v1/facebook-marketplace/location-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Austin"}'
# Search listings around the selected coordinates
curl -X POST "https://api.socq.ai/v1/facebook-marketplace/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"bike","latitude":30.2677,"longitude":-97.7475,"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso frecuentes de la API de Facebook Marketplace
Descubrimiento de artículos locales
Resuelva una zona de mercado y busque artículos públicos por palabra clave, coordenadas, radio, precio, condición, método de entrega, fecha o disponibilidad.
Comparación de precios locales
Compare los precios solicitados, las monedas, los títulos, las categorías, las condiciones y las ubicaciones normalizados de artículos públicos similares.
Monitoreo de inventario regional
Obtenga instantáneas acotadas de artículos de mercados seleccionados y compare con el tiempo el inventario público, las opciones de entrega y la disponibilidad.
Enriquecimiento de artículos conocidos
Convierta URL conocidas de artículos en registros detallados con descripciones, contexto del vendedor, precios, ubicaciones, contenido multimedia, atributos y campos de estado.
Límites y política de datos públicos
Los resultados de Marketplace son registros públicos de un momento dado. Estas API no reproducen la interfaz de Marketplace para consumidores ni administran artículos o cuentas.
- Location Search requiere una sola consulta con el nombre de un lugar, no acepta results_limit y puede devolver varios candidatos con nombres parecidos.
- Verifique el contexto de dirección y las coordenadas antes de usar un candidato de ubicación como centro de una búsqueda de artículos.
- Search requiere una palabra clave no vacía, latitude y longitude; results_limit tiene un valor predeterminado de 100 y acepta enteros de 1 a 2,000.
- Los resultados de Search pueden omitir descripciones, datos del vendedor, coordenadas precisas, atributos y horas de creación, y los ID de artículo duplicados se guardan una sola vez.
- Item requiere URL compatibles con el formato /marketplace/item/{numeric_id}; cada URL válida devuelve como máximo un registro y los artículos no disponibles pueden omitirse.
- Un resultado vacío puede deberse a que no hay coincidencias públicas, a filtros restrictivos, a la disponibilidad regional, a un artículo no disponible o a un límite de la fuente pública.
Preguntas frecuentes sobre la API de Facebook Marketplace
¿Qué es la Facebook Marketplace API?
La Facebook Marketplace API es un conjunto de endpoints de SocQ para resolver ubicaciones de Marketplace, buscar artículos públicos y obtener registros detallados a partir de URL conocidas de artículos.
¿Qué API de Facebook Marketplace debo usar?
Use Location Search para resolver un lugar, Search para descubrir artículos alrededor de unas coordenadas e Item cuando ya tenga URL públicas de artículos de Marketplace.
¿Cómo se busca en Facebook Marketplace por ubicación?
Envíe a Location Search el nombre de una ciudad, región, barrio o lugar, elija el candidato correcto y luego pase su latitud y longitud a Search.
¿Qué devuelve Facebook Marketplace Search?
Search puede devolver la identidad del artículo, el título, la descripción, el precio, la ubicación, las imágenes, el contexto del vendedor, la categoría, las opciones de entrega, los campos de estado, la URL de origen y la hora de recolección.
¿Cuándo debo usar Facebook Marketplace Item?
Use Item con URL públicas conocidas de artículos cuando necesite campos detallados de descripción, vendedor, precio, ubicación, contenido multimedia, atributos, entrega y disponibilidad.
¿Por qué la cantidad de resultados puede ser menor que results_limit?
El límite es un máximo solicitado. La recolección puede detenerse cuando no hay otra página pública disponible, cuando los filtros excluyen registros o cuando se eliminan ID de artículo duplicados.
¿Cuánto cuestan los resultados de Facebook Marketplace?
Los candidatos de ubicación cuestan 0.3 créditos, los artículos de Search cuestan 0.7 créditos y los registros de Item cuestan 0.6 créditos por resultado devuelto. Los resultados vacíos no tienen cargo.
Combine datos de varias plataformas para obtener información de negocio más completa
Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.
X API
Recopile perfiles públicos, relaciones de seguidores y seguidos, posts, respuestas, citas, quienes hicieron repost, resultados de búsqueda y tendencias actuales. Use resultados consistentes para investigación y monitoreo.
LinkedIn API
Obtenga datos públicos de perfiles, empresas, publicaciones y empleos de LinkedIn a partir de URL conocidas, con campos normalizados de identidad, trayectoria profesional, empresa, contenido, interacción y empleo.
Reddit API
Obtenga publicaciones y comentarios públicos de Reddit a partir de URL conocidas, explore publicaciones nuevas, principales o populares de un subreddit, o busque conversaciones por palabra clave y período de publicación.
Pinterest API
Obtenga datos de perfiles públicos de Pinterest, resuelva Pins conocidos, recopile Pins de perfiles seleccionados o busque por palabra clave para investigar creadores de contenido, contenidos y tendencias visuales.
Threads API
Obtenga perfiles públicos de Threads, resuelva publicaciones conocidas o recopile publicaciones de perfiles seleccionados con campos normalizados de identidad, contenido, multimedia, interacción y marca de tiempo.
Bluesky API
Obtenga perfiles públicos de Bluesky, resuelva URL de publicaciones conocidas o recopile una página de publicaciones de una cuenta con identidad, contenido, contenido multimedia, marcas de tiempo y campos visibles de interacción normalizados.


