Pinterest User Boards
Un tablero de Pinterest es una colección con nombre de Pins guardados, con descripción, imagen de portada y fecha de creación, además de los conteos de sus Pins, seguidores, secciones y colaboradores y un indicador de si otras cuentas pueden agregar contenido. Vistos en conjunto dentro de un perfil, esos tableros revelan qué temas cura la cuenta con más dedicación, qué colecciones atraen seguidores propios y dónde abre la puerta a aportes compartidos.
Funcionalidades de la Pinterest User Boards API
- Todos los tableros de un perfilEnvíe uno o más enlaces de perfiles de Pinterest en urls y cada tablero de esos perfiles vuelve como una fila propia, con el id y la url del tablero.
- Tamaño y audiencia de cada tablerometrics.pins_count muestra cuánto se ha guardado en un tablero y metrics.followers_count cuántas personas lo siguen, lo que distingue un archivo muy activo de una colección con audiencia real.
- Tableros grupales y seccionesis_collaborative marca los tableros a los que otras cuentas pueden agregar Pins, metrics.collaborators_count indica cuántas pueden hacerlo y metrics.sections_count muestra qué tan subdividido está un tablero.
- Nombre, descripción, portada y fecha de creaciónname, text y cover_url dicen de un vistazo de qué trata un tablero, mientras que published_at registra cuándo se creó y, por lo tanto, cuándo ese tema llegó a la cuenta.
- Hasta 500 tableros por perfilresults_limit se aplica a cada perfil por separado, vale 25 de forma predeterminada y acepta hasta 500, así que las cuentas que mantienen cientos de tableros se pueden listar completas.
Parámetros de la Pinterest User Boards API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Enlaces de perfiles de Pinterest con un solo nombre de usuario en la ruta, como https://www.pinterest.com/marthastewart/; también funcionan dominios de país como pinterest.co.uk o de.pinterest.com. |
results_limit | Opcional | Cantidad máxima de tableros que se devuelven por perfil, un entero de 1 a 500. El valor predeterminado es 25. |
Cómo usar la Pinterest User Boards API
Envíe enlaces de perfiles, espere a que termine la tarea y recorra las páginas con una fila por tablero.
- Envíe los enlaces de perfiles y un results_limit opcional a POST /v1/pinterest/user-boards y guarde el task_id de la respuesta.
- Llame a GET /v1/tasks/{task_id} cada pocos segundos hasta que status pase a succeeded.
- Lea los tableros en results.items; mientras has_more sea true, pida la página siguiente con results.next_cursor.
curl -X POST "https://api.socq.ai/v1/pinterest/user-boards" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.pinterest.com/marthastewart/"],"results_limit":25}'
# Each board returned costs 0.5 credits.Casos de uso de la Pinterest User Boards API
- Auditar los temas de un competidor en Pinterest: Compare el name y el text de cada tablero con pins_count para ver en qué temas sigue guardando contenido una marca, y con followers_count para ver cuáles de esas colecciones sigue la gente.
- Preseleccionar creadores por nicho: Reúna los tableros de los creadores candidatos y compare sus nombres y descripciones con su tema, quedándose con las cuentas que lo curan en varios tableros.
- Encontrar tableros grupales en los que vale la pena participar: Conserve las filas donde is_collaborative es true y compare collaborators_count con followers_count para elegir tableros compartidos que tengan seguidores.
- Seguir qué colecciones crecen: Vuelva a recopilar los mismos perfiles de forma periódica y compare pins_count y followers_count por id de tablero para ver cuáles ganan Pins o seguidores.
Consejos de expertos para la Pinterest User Boards API
- Recorte los enlaces de tableros y Pins hasta la raíz del perfil antes de enviarlos, ya que urls recibe https://www.pinterest.com/{username}/; los enlaces de tableros corresponden a Pinterest Board Pins API.
- Suba results_limit por encima de los 25 predeterminados cuando un perfil tenga más tableros; el límite cuenta por perfil y solo se cobran los tableros que realmente se devuelven.
- Agrupe las filas por author.username cuando una tarea abarque varios perfiles, porque cada tablero trae los datos de la cuenta propietaria.
- Pase la url de cada tablero a Pinterest Board Pins API para obtener sus Pins, y use metrics.pins_count para decidir qué tan alto fijar el results_limit de ese endpoint.
APIs relacionadas
Además de la Pinterest User Boards 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 Search API — Busca Pins públicos por consulta de texto con un límite de resultados, y devuelve contenido normalizado, creador, contenido multimedia, taxonomía, marcas de tiempo y métricas visibles.
- 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.