Pinterest User Boards
Un tableau Pinterest est une collection nommée de Pins enregistrés, avec une description, une image de couverture et une date de création, ainsi que les nombres de Pins, d’abonnés, de sections et de collaborateurs et un indicateur précisant si d’autres comptes peuvent y contribuer. Lus sur l’ensemble d’un profil, ces tableaux révèlent les thèmes que le compte alimente le plus, les collections qui attirent leurs propres abonnés et les endroits où il ouvre la porte aux contributions partagées.
Fonctionnalités de la Pinterest User Boards API
- Tous les tableaux d’un profilEnvoyez un ou plusieurs liens de profils Pinterest dans urls : chaque tableau de ces profils revient sous forme d’une ligne distincte, avec son id et son url.
- Taille et audience de chaque tableaumetrics.pins_count montre le volume enregistré dans un tableau et metrics.followers_count le nombre de personnes qui le suivent, ce qui distingue une archive bien remplie d’une collection qui a un vrai public.
- Tableaux de groupe et sectionsis_collaborative signale les tableaux auxquels d’autres comptes peuvent ajouter des Pins, metrics.collaborators_count indique combien de comptes le peuvent et metrics.sections_count montre le degré de subdivision d’un tableau.
- Nom, description, couverture et date de créationname, text et cover_url disent d’un coup d’œil de quoi parle un tableau, tandis que published_at enregistre sa date de création, donc le moment où ce thème est entré dans le compte.
- Jusqu’à 500 tableaux par profilresults_limit s’applique à chaque profil séparément, vaut 25 par défaut et accepte jusqu’à 500, de sorte que les comptes qui entretiennent des centaines de tableaux peuvent être listés en entier.
Paramètres de la Pinterest User Boards API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liens de profils Pinterest avec un seul nom d’utilisateur dans le chemin, comme https://www.pinterest.com/marthastewart/ ; les domaines nationaux tels que pinterest.co.uk ou de.pinterest.com fonctionnent aussi. |
results_limit | Facultatif | Nombre maximal de tableaux renvoyés pour chaque profil, entier de 1 à 500. 25 par défaut. |
Comment utiliser la Pinterest User Boards API
Envoyez des liens de profils, attendez la fin de la tâche, puis parcourez une ligne par tableau.
- Envoyez les liens de profils et un results_limit facultatif en POST à /v1/pinterest/user-boards, puis conservez le task_id de la réponse.
- Appelez GET /v1/tasks/{task_id} toutes les quelques secondes jusqu’à ce que status passe à succeeded.
- Lisez les tableaux dans results.items ; tant que has_more vaut true, demandez la page suivante avec 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.Cas d’usage de la Pinterest User Boards API
- Auditer les thèmes Pinterest d’un concurrent : Mettez en regard le name et le text des tableaux avec pins_count pour voir les sujets qu’une marque continue d’alimenter, et avec followers_count pour savoir lesquelles de ces collections sont suivies.
- Présélectionner des créateurs par niche : Collectez les tableaux des créateurs candidats et rapprochez noms et descriptions de votre sujet, en gardant les comptes qui le traitent dans plusieurs tableaux.
- Trouver des tableaux de groupe à rejoindre : Gardez les lignes où is_collaborative vaut true et comparez collaborators_count à followers_count pour choisir des tableaux partagés qui ont un public.
- Suivre les collections qui grandissent : Recollectez régulièrement les mêmes profils et comparez pins_count et followers_count par id de tableau pour voir lesquels gagnent des Pins ou des abonnés.
Conseils d’expert pour la Pinterest User Boards API
- Ramenez les liens de tableaux et de Pins à la racine du profil avant l’envoi, puisque urls attend https://www.pinterest.com/{username}/ ; les liens de tableaux relèvent de Pinterest Board Pins API.
- Augmentez results_limit au-delà des 25 par défaut lorsqu’un profil compte davantage de tableaux ; la limite s’applique par profil et seuls les tableaux effectivement renvoyés sont facturés.
- Regroupez les lignes par author.username quand une tâche couvre plusieurs profils, car chaque tableau porte les informations du compte qui le possède.
- Transmettez l’url de chaque tableau à Pinterest Board Pins API pour en récupérer les Pins, en vous fondant sur metrics.pins_count pour fixer le results_limit de cet endpoint.
API associées
En complément de la Pinterest User Boards API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Pinterest.
- Pinterest Pins API — Transformez des URL de Pins publics en contenu, créateur, médias, taxonomie, horodatages et indicateurs visibles normalisés.
- Pinterest User Pins API — Repérez les Pins publics à partir d’URL de profils, avec limite par profil, contenu, créateur, médias, horodatages et indicateurs visibles normalisés.
- Pinterest Profiles API — Collectez l’identité publique d’un profil, sa bio, son image, son site web, ses nombres visibles et le contexte de collecte à partir d’URL de profils.
- Pinterest Search API — Recherchez des Pins publics par requête textuelle avec limite de résultats, et obtenez contenu, créateur, médias, taxonomie, horodatages et indicateurs visibles normalisés.
- Pinterest Board Pins API — Collectez les Pins d’un tableau Pinterest à partir de son URL, dans l’ordre du tableau, avec le texte, le compte qui a enregistré chaque Pin, les images en taille réelle et les liens des Pins.
- Pinterest Topic API — Lisez des URL de pages d’idées Pinterest pour obtenir le nombre mensuel de recherches de chaque sujet, sa date d’actualisation et les sous-sujets suggérés.