Une API d’influence pour vos données de gifting.

À quoi sert l’API

Elle s’adresse à la personne en charge des opérations ou au développeur qui veut les données de Pozto ailleurs : une base Airtable, un data warehouse, un tableau de bord, un outil interne. Ou dans l’autre sens : ajouter des créateurs depuis le système qui expédie vos envois, pour que personne ne les saisisse deux fois.

Elle travaille sur votre propre liste, les créateurs à qui vous avez envoyé des produits. Ce n’est pas une base d’influenceurs à explorer. Si c’est ce que vous attendez d’une API influence, Pozto n’est pas la bonne solution.

Clés, URL de base et limites

• URL de base : https://pozto.co/api/v1
• Clés : le propriétaire de l’équipe les crée dans Réglages → API, avec l’offre Brand. Une clé commence par pz_ et ne s’affiche qu’une fois : Pozto n’en garde qu’une empreinte, copiez-la donc tout de suite. Nommez chaque clé selon son usage et révoquez-la quand vous voulez. Les Réglages indiquent la dernière utilisation de chaque clé.
• Envoi : Authorization: Bearer pz_… dans chaque requête.
• Portée : une clé lit et ajoute des données dans toutes les marques de votre équipe.
• Limite de débit : 120 requêtes par minute et par clé.
• Pages : GET /creators et GET /posts renvoient 100 éléments à la fois, ou jusqu’à 500 avec &limit=. Quand il y en a davantage, la réponse contient un next_cursor : renvoyez-le sous la forme &cursor= pour obtenir la page suivante. Il vaut null sur la dernière page.
• Format : JSON en entrée comme en sortie. Les identifiants sont des chaînes et les dates sont au format ISO 8601.

Endpoints

Ce que contiennent un créateur et une publication

Un créateur est renvoyé avec son nom, son e-mail, ses comptes (et si chaque pseudo a été trouvé), ses codes promo, son statut et chacun de ses envois : le produit et le reste du colis, la campagne, les dates d’expédition et de livraison, le délai en jours, le numéro de suivi, la rémunération, le nombre de publications attendues et déjà publiées.

Une publication correspond à une vidéo, avec chaque plateforme où elle a été mise en ligne : lien, légende, date de publication et si elle vous tague. Puis l’envoi et le produit auxquels elle se rattache, et comment Pozto l’a déterminé. Ensuite l’analyse vidéo : si votre produit a été trouvé, chaque moment à l’écran en secondes, chaque mention orale avec la citation, et un court résumé. Enfin la mention de partenariat : claire, faible ou absente, avec la raison.

Ajouter des créateurs et des publications

POST /creators prend brand_id et handles : des @pseudos, des liens de profil ou des liens de type Linktree, jusqu’à six. Il accepte aussi platform, name, email, codes, product (un identifiant ou un nom ; un nouveau nom crée le produit), shipped_at, delivered_at, due_days (21 si vous ne le précisez pas) et tracking. Un créateur déjà dans la liste, reconnu par l’un de ses comptes ou son e-mail, reçoit l’envoi au lieu d’être créé en double. La réponse est 201 pour un nouveau créateur et 200 pour un créateur existant, avec l’identifiant du créateur et celui de l’envoi.

POST /posts prend brand_id et url, et en option creator_id et product_id. La publication est rangée sous le propriétaire du compte, ajouté à votre liste s’il est nouveau, puis mise en file pour l’analyse vidéo. La réponse indique si elle était nouvelle, le pseudo, la plateforme et si elle compte comme une publication sur vous.

# Créateurs en retard, pour une marque
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# Ajouter un créateur et l’envoi que vous lui avez fait
curl -X POST https://pozto.co/api/v1/creators \
  -H "Authorization: Bearer pz_…" \
  -H "Content-Type: application/json" \
  -d '{"brand_id":"BRAND_ID","handles":["@maya.glows"],"product":"Glow Serum","shipped_at":"2026-10-14"}'

# Publications depuis le 1er octobre, les plus récentes d’abord
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# La page suivante : le next_cursor de la réponse précédente
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

Erreurs

Une erreur est renvoyée en JSON avec une phrase simple, comme {"error": "…"}, et un statut 4xx :

• 400 : le corps n’est pas du JSON, ou un champ n’est pas valide, comme une date de livraison dans le futur.
• 401 : pas de clé, ou une clé erronée ou révoquée.
• 403 : votre équipe n’est pas sur l’offre Brand.
• 404 : aucune marque avec ce brand_id dans votre équipe.
• 409 : la marque est verrouillée, car votre offre inclut moins de marques que votre équipe n’en utilise.
• 429 : plus de 120 requêtes en une minute.

Ce que l’API ne fait pas

• Pas de recherche d’influenceurs. Elle lit et complète votre propre liste. La recherche de créateurs, c’est Trouver des créateurs, dans l’application.
• Pas de vues, de likes ni d’EMV dans les réponses. Ils sont dans l’application dès l’offre Starter, et dans le rapport hebdomadaire. Voir le reporting d’influence.
• Pas de webhooks. Pour récupérer les nouvelles publications, appelez GET /posts avec since.
• Pas de modification ni de suppression. L’API lit et ajoute. Les modifications et suppressions se font dans l’application.
• Pas de clés individuelles. Les clés appartiennent à l’équipe, et seul le propriétaire les crée.

Les publications contiennent les mêmes informations que dans l’application : Pozto trouve les publications en regardant la vidéo, les images, l’audio et la légende, donc les publications sans tag remontent aussi. Le suivi des influenceurs explique comment les publications sont trouvées.

Tarifs

L’API est incluse dans l’offre Brand : 999 $ par mois, ou 799 $ par mois en paiement annuel, avec 10 marques, 1 000 créateurs actifs, des utilisateurs illimités et le single sign-on. Tout le reste de Pozto est disponible dès les offres inférieures, et l’offre gratuite couvre vos 10 premiers créateurs. Voir les offres.