Ένα influencer API για τα δεδομένα των δώρων σας.

Σε τι χρησιμεύει το API

Είναι για τον υπεύθυνο operations ή τον developer που θέλει τα δεδομένα του Pozto κάπου αλλού: σε μια βάση Airtable, σε ένα data warehouse, σε ένα dashboard, σε ένα εσωτερικό εργαλείο. Ή το αντίστροφο: να προσθέτει δημιουργούς από το σύστημα που στέλνει τα δώρα σας, ώστε κανείς να μην τους πληκτρολογεί δύο φορές.

Λειτουργεί πάνω στη δική σας λίστα, στους δημιουργούς στους οποίους έχετε στείλει προϊόν. Δεν είναι βάση δεδομένων influencers για αναζήτηση. Αν αυτό χρειάζεστε από ένα influencer API, το Pozto δεν είναι η λύση.

Κλειδιά, base URL και όρια

• Base URL: https://pozto.co/api/v1
• Κλειδιά: τα δημιουργεί ο κάτοχος της ομάδας στις Ρυθμίσεις → API, στο πλάνο Brand. Ένα κλειδί ξεκινά με pz_ και εμφανίζεται μία φορά: το Pozto κρατά μόνο ένα αποτύπωμα, οπότε αντιγράψτε το τότε. Δώστε σε κάθε κλειδί όνομα ανάλογα με τη χρήση του και ανακαλέστε το όποτε θέλετε. Οι Ρυθμίσεις δείχνουν πότε χρησιμοποιήθηκε τελευταία φορά κάθε κλειδί.
• Αποστολή: Authorization: Bearer pz_… σε κάθε αίτημα.
• Εμβέλεια: ένα κλειδί διαβάζει και προσθέτει σε κάθε μάρκα της ομάδας σας.
• Όριο αιτημάτων: 120 αιτήματα το λεπτό ανά κλειδί.
• Σελίδες: τα GET /creators και GET /posts επιστρέφουν 100 τη φορά, ή έως 500 με &limit=. Όταν υπάρχουν περισσότερα, η απάντηση έχει ένα next_cursor: στείλτε το πίσω ως &cursor= για την επόμενη σελίδα. Στην τελευταία σελίδα είναι null.
• Μορφή: JSON στην είσοδο και στην έξοδο. Τα ids είναι strings και οι ημερομηνίες ISO 8601.

Endpoints

Τι περιλαμβάνουν ένας δημιουργός και μια ανάρτηση

Ένας δημιουργός έρχεται με το όνομα, το email, τους λογαριασμούς του (και αν βρέθηκε κάθε handle), τους εκπτωτικούς κωδικούς, την κατάσταση και κάθε δώρο: το προϊόν και το υπόλοιπο περιεχόμενο του κουτιού, την καμπάνια του, τις ημερομηνίες αποστολής και παράδοσης, την προθεσμία σε ημέρες, τον αριθμό αποστολής, την αμοιβή, τις αναρτήσεις που ζητήθηκαν και όσες έγιναν μέχρι στιγμής.

Μια ανάρτηση είναι ένα βίντεο, με κάθε πλατφόρμα όπου ανέβηκε: σύνδεσμος, λεζάντα, ημερομηνία δημοσίευσης και αν σας έκανε tag. Μετά το δώρο και το προϊόν για τα οποία μετράει, και πώς το αποφάσισε το Pozto. Μετά ο έλεγχος βίντεο: αν βρέθηκε το προϊόν σας, κάθε στιγμή στην οθόνη σε δευτερόλεπτα, κάθε φορά που ειπώθηκε με την ακριβή φράση και μια σύντομη περίληψη. Και η δήλωση: σαφής, αδύναμη ή καμία, με την αιτία.

Προσθήκη δημιουργών και αναρτήσεων

Το POST /creators δέχεται brand_id και handles: @ονόματα, συνδέσμους προφίλ ή συνδέσμους τύπου Linktree, έως έξι. Δέχεται επίσης platform, name, email, codes, product (ένα id ή ένα όνομα· ένα νέο όνομα προσθέτει το προϊόν), shipped_at, delivered_at, due_days (21 αν το παραλείψετε) και tracking. Ένας δημιουργός που είναι ήδη στη λίστα, αναγνωρισμένος από οποιονδήποτε λογαριασμό του ή το email του, παίρνει το δώρο αντί να δημιουργηθεί διπλότυπο. Απαντά 201 για νέο δημιουργό και 200 για υπάρχοντα, με το id του δημιουργού και το id του δώρου.

Το POST /posts δέχεται brand_id και url, και προαιρετικά creator_id και product_id. Η ανάρτηση καταχωρίζεται στον κάτοχο του λογαριασμού, ο οποίος προστίθεται στη λίστα σας αν είναι νέος, και μπαίνει στην ουρά για τον έλεγχο βίντεο. Απαντά με το αν ήταν νέα, το handle, την πλατφόρμα και το αν μετράει ως ανάρτηση για εσάς.

# Δημιουργοί που καθυστερούν, σε μία μάρκα
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# Προσθήκη δημιουργού και του δώρου που του στείλατε
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"}'

# Αναρτήσεις από την 1η Οκτωβρίου, οι νεότερες πρώτες
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# Η επόμενη σελίδα: το next_cursor από την προηγούμενη απάντηση
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

Σφάλματα

Ένα σφάλμα επιστρέφεται ως JSON με μία απλή πρόταση, όπως {"error": "…"}, και κατάσταση 4xx:

• 400: το σώμα δεν είναι JSON ή ένα πεδίο δεν είναι έγκυρο, π.χ. ημερομηνία παράδοσης στο μέλλον.
• 401: δεν υπάρχει κλειδί ή το κλειδί είναι λάθος ή έχει ανακληθεί.
• 403: η ομάδα σας δεν είναι στο πλάνο Brand.
• 404: δεν υπάρχει μάρκα με αυτό το brand_id στην ομάδα σας.
• 409: η μάρκα είναι κλειδωμένη, επειδή το πλάνο σας περιλαμβάνει λιγότερες μάρκες από όσες χρησιμοποιεί η ομάδα σας.
• 429: περισσότερα από 120 αιτήματα σε ένα λεπτό.

Τι δεν κάνει το API

• Δεν κάνει αναζήτηση influencers. Διαβάζει και προσθέτει στη δική σας λίστα. Η αναζήτηση δημιουργών γίνεται στην Εύρεση δημιουργών, μέσα στην εφαρμογή.
• Δεν επιστρέφει προβολές, likes ή EMV. Αυτά υπάρχουν στην εφαρμογή από το Starter και στην εβδομαδιαία αναφορά. Δείτε τις αναφορές influencer.
• Δεν έχει webhooks. Για νέες αναρτήσεις, καλέστε το GET /posts με since.
• Δεν κάνει αλλαγές ή διαγραφές. Το API διαβάζει και προσθέτει. Οι αλλαγές και οι αφαιρέσεις γίνονται στην εφαρμογή.
• Δεν έχει προσωπικά κλειδιά. Τα κλειδιά ανήκουν στην ομάδα και μόνο ο κάτοχος τα δημιουργεί.

Οι αναρτήσεις περιέχουν ό,τι και στην εφαρμογή: το Pozto βρίσκει αναρτήσεις παρακολουθώντας το βίντεο, καρέ, ήχο και λεζάντα, οπότε περνούν και οι αναρτήσεις χωρίς tag. Η παρακολούθηση influencers εξηγεί πώς βρίσκονται οι αναρτήσεις.

Τιμές

Το API περιλαμβάνεται στο πλάνο Brand: $999 τον μήνα ή $799 τον μήνα με ετήσια πληρωμή, με 10 μάρκες, 1.000 ενεργούς δημιουργούς, απεριόριστες θέσεις χρηστών και single sign-on. Όλα τα υπόλοιπα στο Pozto ξεκινούν από χαμηλότερα πλάνα, και το δωρεάν πλάνο καλύπτει τους πρώτους 10 δημιουργούς σας. Δείτε τα πλάνα.