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

À quoi sert l’API

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

Elle fonctionne sur votre propre liste, les créateurs à qui vous avez envoyé des produits. Ce n’est pas une base de données d’influenceurs où chercher. Si c’est ce que vous attendez d’une API d’influence, Pozto n’est pas le bon outil.

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 Paramètres → API, avec le forfait Brand. Une clé commence par pz_ et n’est affichée qu’une fois : Pozto n’en garde qu’une empreinte, alors copiez-la à ce moment-là. Nommez chaque clé selon son usage, et révoquez-la en tout temps. Paramètres indique quand chaque clé a été utilisée pour la dernière fois.
• L’envoyer : Authorization: Bearer pz_… dans chaque requête.
• Portée : une clé lit et ajoute dans toutes les marques de votre équipe.
• Limite de requêtes : 120 requêtes par minute 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 et en sortie. Les identifiants sont des chaînes, et les dates sont en ISO 8601.

Points de terminaison

Ce que contiennent un créateur et une publication

Un créateur arrive avec son nom, son courriel, ses comptes (et si chaque nom d’utilisateur a été trouvé), ses codes de réduction, son statut et chaque cadeau : le produit et le reste de la boîte, sa campagne, les dates d’expédition et de livraison, le délai en jours, le numéro de suivi, le cachet, les publications attendues et les publications jusqu’ici.

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 identifiait. Puis le cadeau et le produit pour lesquels elle compte, et comment Pozto l’a déterminé. Puis l’analyse vidéo : si votre produit a été trouvé, chaque moment à l’écran en secondes, chaque fois qu’il a été dit avec la citation, et un court résumé. Et la divulgation : claire, faible ou absente, avec la raison.

Ajouter des créateurs et des publications

POST /creators reçoit brand_id et handles : des @noms, 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 ajoute le produit), shipped_at, delivered_at, due_days (21 si vous l’omettez) et tracking. Un créateur déjà dans la liste, reconnu par l’un de ses comptes ou son courriel, reçoit le cadeau au lieu d’être dupliqué. 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 du cadeau.

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

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

# Ajouter un créateur et le cadeau que vous lui avez envoyé
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 revient 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 : aucune clé, ou une clé erronée ou révoquée.
• 403 : votre équipe n’est pas au forfait Brand.
• 404 : aucune marque avec ce brand_id dans votre équipe.
• 409 : la marque est verrouillée, parce que votre forfait compte 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 votre propre liste et y ajoute. La recherche de créateurs, c’est Trouver des créateurs, dans l’application.
• Pas de vues, de mentions J’aime ni d’EMV dans les réponses. Ils sont dans l’application à partir de Starter, et dans le rapport hebdomadaire. Voyez les rapports 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 changements et les retraits se font dans l’application.
• Pas de clés personnelles. Les clés appartiennent à l’équipe, et seul le propriétaire les crée.

Le contenu des publications est le même 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 identification arrivent aussi. Le suivi d’influenceurs explique comment les publications sont trouvées.

Tarifs

L’API vient avec le forfait Brand : $999 par mois, ou $799 par mois à l’année, avec 10 marques, 1,000 créateurs actifs, des utilisateurs illimités et l’authentification unique (SSO). Tout le reste de Pozto commence avec des forfaits inférieurs, et le forfait gratuit couvre vos 10 premiers créateurs. Voir les forfaits.