pinterest/
search

Busque Pins públicos de Pinterest por consulta de texto con un límite de resultados, con contenido, contexto del creador, contenido multimedia, taxonomía e interacción visible normalizados.

Pinterest Search API

Entrada de consulta de texto
1–2,000 resultados solicitados
Pins públicos normalizados
0.6 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Pinterest Search

Los resultados de Pinterest Search son Pins públicos que coinciden con una consulta de texto, con títulos, descripciones, datos del creador, referencias multimedia, categorías, hashtags, fechas e interacción visible. Estos registros sirven para descubrir temas, investigar temáticas visuales, analizar el contexto de los creadores y comparar contenido a partir de consultas.

Funcionalidades de la Pinterest Search API

  • Descubrimiento de Pins por consultaAcepta una consulta de texto no vacía y un results_limit de 1 a 2,000 para solicitar una recopilación acotada de registros de Pins públicos.
  • Registros normalizados de Pin, creador y contenido multimediaDevuelve los ID de Pin, las URL, los títulos, el texto, los campos públicos del creador y las referencias de imagen o video en una estructura de resultado coherente.
  • Contexto de taxonomía y señales visiblesConserva las categorías, los hashtags, el tipo de Pin, los metadatos de origen, los conteos visibles de Me gusta, comentarios y seguidores del creador, la hora de publicación, la hora de recopilación y el contexto de la consulta enviada, cuando están disponibles.

Parámetros de la Pinterest Search API

ParámetrosObligatorioDescripción
queryObligatorioConsulta de texto obligatoria y no vacía que se usa para descubrir Pins públicos de Pinterest; los espacios iniciales y finales se eliminan antes del envío.
results_limitOpcionalCantidad máxima de Pins solicitados para la consulta; el valor predeterminado es 100 y acepta enteros de 1 a 2,000.

Cómo usar la Pinterest Search API

Envíe una consulta de texto de Pinterest con un límite de resultados, siga la tarea asíncrona y lea los Pins normalizados con paginación por cursor.

  1. Prepare una consulta de texto no vacía y elija un results_limit de 1 a 2,000.
  2. Envíe query y results_limit por POST a /v1/pinterest/search y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
  4. Lea data.results.items y solicite el next_cursor devuelto mientras has_more siga siendo true.
curl -X POST "https://api.socq.ai/v1/pinterest/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"home office ideas","results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la Pinterest Search API

  • Conjuntos de datos de Pins por tema: Use una consulta definida con los ID de Pin, las URL de origen, los títulos, el texto, las referencias multimedia y discovery_input para construir una colección temática trazable.
  • Investigación visual y de taxonomía: Compare imágenes o videos, post_type, categorías, hashtags, títulos y descripciones para examinar los formatos y temas dentro de los resultados de una consulta.
  • Comparación de creadores y señales visibles: Combine los campos públicos del creador con los conteos de Me gusta, comentarios y seguidores, y con collected_at, para comparar el contexto observado de los resultados entre colecciones de consultas.

Consejos de expertos para la Pinterest Search API

  • Envíe una consulta no vacía después de eliminar los espacios accidentales alrededor, y mantenga results_limit entre 1 y 2,000 para cumplir la validación de entrada.
  • Siga next_cursor hasta que has_more sea false cuando los resultados almacenados superen la primera página de respuesta de 50 elementos.
  • Conserve extra.discovery_input y collected_at para que cada Pin siga vinculado a la palabra clave enviada y a la hora de observación.
  • Maneje title, text, los datos del autor, media, created_at, categories, hashtags, source y cada métrica como campos opcionales, en lugar de tratar los valores ausentes como errores de la solicitud.

Además de la Pinterest Search API, use estas APIs cuando necesite otro tipo de datos públicos de Pinterest.

  • Pinterest Pins API — Convierte URLs de Pins públicos en contenido normalizado, creador, contenido multimedia, taxonomía, marcas de tiempo y métricas visibles.
  • Pinterest User Pins API — Descubre Pins públicos desde URLs de perfiles con un límite por perfil, y devuelve contenido normalizado, creador, contenido multimedia, marcas de tiempo y métricas visibles.
  • Pinterest Profiles API — Recolecta desde URLs de perfiles la identidad del perfil público, la biografía, la imagen, el sitio web, los conteos visibles de la cuenta y el contexto de recolección.
  • Pinterest User Boards API — Lista los tableros de perfiles de Pinterest a partir de sus URL, con nombre, descripción, portada, fecha de creación y conteos de Pins, seguidores, secciones y colaboradores.
  • Pinterest Board Pins API — Recolecta los Pins de un tablero de Pinterest a partir de su URL y en el orden del tablero, con el texto del Pin, la cuenta que lo guardó, imágenes en tamaño completo y enlaces a cada Pin.
  • Pinterest Topic API — Lee URL de páginas de ideas de Pinterest para obtener las búsquedas mensuales de cada tema, su fecha de actualización y los temas más específicos sugeridos.

Explorar otras plataformas

Combine los datos de Pinterest con datos públicos de otras plataformas sociales compatibles.

Pinterest Search API — FAQ

Pinterest Search API descubre registros de Pins públicos a partir de una consulta de texto no vacía y un límite de resultados opcional. Devuelve la identidad del Pin, el contenido, los creadores, el contenido multimedia, la taxonomía, las fechas y la interacción visible, todo normalizado.

El endpoint acepta únicamente query y results_limit. No expone parámetros de ordenamiento, fecha, idioma, tablero ni tipo de resultado.

Cada resultado normalizado es un Pin público con resource definido como search y type definido como pin. Los perfiles, tableros, productos y sugerencias no son tipos de resultado independientes en esta respuesta.

Los registros pueden incluir el ID del Pin, la URL, el título, el texto, los datos públicos del autor, las referencias de imagen o video, los conteos visibles de Me gusta, comentarios y seguidores, created_at, collected_at, y los campos extra de taxonomía, origen y descubrimiento. Los valores opcionales de origen pueden ser null o estar vacíos.

results_limit tiene un valor predeterminado de 100 y acepta enteros de 1 a 2,000 como máximo solicitado para la consulta. Las respuestas de tareas exitosas devuelven los resultados almacenados en páginas de 50 de forma predeterminada; siga next_cursor mientras has_more sea true y use un límite de página de 1 a 500 si llama directamente al endpoint de tareas.

Cada registro de Pin devuelto cuesta 0.6 créditos de SocQ. La estimación previa a la solicitud usa results_limit, o 100 cuando se omite, y un conjunto de resultados vacío no tiene cargo por resultados.