Δημογραφικά κοινού TikTok μέσω του API
Το API for Business του TikTok επιστρέφει τα δημογραφικά των ακολούθων ενός λογαριασμού TikTok από το GET /business/get/: audience_ages, audience_genders, audience_countries και audience_cities, το καθένα ως λίστα ποσοστών των ακολούθων, για λογαριασμούς με τουλάχιστον 100 ακολούθους. Η ωριαία δραστηριότητα των ακολούθων έρχεται ως audience_activity στο metrics κάθε ημέρας, για λογαριασμούς με Advanced Access ή Verified Business Accounts και τους ίδιους 100 ακολούθους. Όλα χρειάζονται το scope user.insights.
Το easyCoexistence διαβάζει τα δημογραφικά ακολούθων ενός λογαριασμού TikTok με το get_social_insights από το Claude, το ChatGPT ή τον δικό σας κώδικα: ζητήστε audience_ages, audience_genders, audience_countries, audience_cities ή audience_activity και παίρνετε πίσω τις λίστες του TikTok όπως είναι.
Οι ακόλουθοι που χρειάζεται ένας λογαριασμός πριν το TikTok επιστρέψει τα δημογραφικά του ανά ηλικία, φύλο, χώρα και πόλη.
Ηλικιακές ομάδες στο audience_ages: 18-24, 25-34, 35-44, 45-54 και 55+.
Ζώνη ώρας του audience_activity, δηλαδή το ωριαίο πλήθος των ακολούθων που είναι ενεργοί στο TikTok.
Συνήθης καθυστέρηση για τα audience_countries, audience_genders και audience_activity, τα οποία το TikTok υπολογίζει εκτός σύνδεσης.
Ποια δημογραφικά επιστρέφει το endpoint του λογαριασμού;
Το GET /business/get/ τα επιστρέφει όταν αναφέρονται στο fields. Οι τέσσερις κατανομές βρίσκονται στην κορυφή του data, με μία λίστα για κάθε διάσταση, και η ωριαία δραστηριότητα βρίσκεται στο metrics, με ένα σύνολο για κάθε ημέρα:
audience_ages: το ποσοστό των ακολούθων σε κάθε ηλικιακή ομάδα, 18-24, 25-34, 35-44, 45-54 και 55+.audience_genders: το ποσοστό των ακολούθων ανά φύλο: Female, Male ή Other.audience_countries: το ποσοστό των ακολούθων ανά χώρα ή περιοχή, ως κωδικός ISO 3166-1 alpha-2.audience_cities: το ποσοστό των ακολούθων ανά πόλη, με βάση τοcity_name.audience_activity: για κάθε ημέρα, οι ακόλουθοι που είναι ενεργοί στο TikTok σε κάθε ώρα, ως hour και count.
Πώς τα ζητάτε;
Με τα ονόματα των πεδίων στο fields, ως πίνακα JSON, και με εύρος ημερομηνιών σε UTC για τα ημερήσια metrics που περιέχουν το audience_activity. Τα start_date και end_date φτάνουν έως 60 ημερών πίσω, και χωρίς αυτά το TikTok επιστρέφει τις 7 ημέρες έως την προηγούμενη ημέρα της αίτησης:
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/get/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["audience_ages","audience_genders","audience_countries","audience_cities","audience_activity"]' \
--data-urlencode 'start_date=2026-10-24' \
--data-urlencode 'end_date=2026-10-30'Πώς είναι η απάντηση;
Κάθε κατανομή είναι λίστα αντικειμένων που συνδυάζουν μια ομάδα με το ποσοστό της, και κάθε ημέρα στο metrics φέρει την ημερομηνία της και μια λίστα audience_activity με τις ώρες. Οι τιμές που ακολουθούν είναι τα δικά του παραδείγματα του TikTok, περικομμένα στη λίστα φύλου και σε λίγες ώρες:
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"audience_genders": [
{ "gender": "Female", "percentage": 0.7554470336505679 },
{ "gender": "Male", "percentage": 0.24455296634943213 }
],
"metrics": [
{
"date": "<DATE>",
"audience_activity": [
{ "hour": "20", "count": 1 },
{ "hour": "23", "count": 4 },
{ "hour": "7", "count": 4 }
]
}
]
}
}Ποιοι λογαριασμοί παίρνουν ποιες κατανομές;
Τα ποσοστά ηλικίας, φύλου, χώρας και πόλης εμφανίζονται όταν ο λογαριασμός έχει τουλάχιστον 100 ακολούθους· το δικό του παράδειγμα για λογαριασμό με 13 ακολούθους επιστρέφει αυτές τις λίστες κενές. Το audience_activity θέλει επίσης 100 ακολούθους και, επιπλέον, λογαριασμό με Advanced Access, που προκύπτει από τη σύνδεσή του με λογαριασμό TikTok for Business ή με Business Center χωρίς επαλήθευση, ή έναν Verified Business Account. Κάθε ένα από αυτά τα πεδία χρειάζεται το scope user.insights στο token.
Πόσο επίκαιρα είναι τα δημογραφικά;
Με καθυστέρηση μίας ή δύο ημερών. Το TikTok αναφέρει τα audience_countries, audience_genders και audience_activity μεταξύ των πεδίων που συνήθως καθυστερούν 24 έως 48 ώρες, σε UTC, και δίνει τον ίδιο χρόνο ενημέρωσης για ηλικίες και πόλεις. Τα στοιχεία προέρχονται από το TikTok Analytics, το οποίο ο ιδιοκτήτης ενεργοποιεί στην εφαρμογή μετά τη δημοσίευση του πρώτου βίντεο, και δεδομένα από πριν δεν είναι διαθέσιμα. Το TikTok βασίζει τα δημογραφικά σε πολλούς παράγοντες, μεταξύ των οποίων και όσα οι χρήστες βάζουν στα προφίλ τους.
Σε τι διαφέρουν τα δημογραφικά ακολούθων από τους θεατές ενός βίντεο;
Περιγράφουν διαφορετικούς ανθρώπους. Οι λίστες του λογαριασμού καλύπτουν τους ακολούθους. Το /business/video/list/ επιστρέφει κατανομές για όσους είδαν μία ανάρτηση: audience_genders, audience_countries και audience_cities με έως 10 καταχωρίσεις το καθένα, και audience_types, που χωρίζει τους θεατές σε νέους και επιστρέφοντες, σε ακολούθους και μη ακολούθους. Αυτές χρειάζονται το scope video.insights αντί για user.insights.
Πώς τα διαβάζει το easyCoexistence;
Με το get_social_insights στον λογαριασμό: χωρίς το object_id, τα ονόματα των πεδίων ως metrics, και τα start_date και end_date στο params όταν θέλετε το audience_activity για συγκεκριμένες ημέρες. Επιστρέφει τις λίστες του TikTok όπως είναι, οπότε τα ποσοστά και οι ώρες διαβάζονται ακριβώς όπως παραπάνω.
get_social_insights {
"account_id": "<ACCOUNT_ID>",
"metrics": ["audience_ages", "audience_genders", "audience_countries", "audience_cities", "audience_activity"],
"params": { "start_date": "2026-10-24", "end_date": "2026-10-30" }
}Συνηθισμένα λάθη
- Αναμονή κατανομών για μικρό λογαριασμό. Το TikTok επιστρέφει ποσοστά ηλικίας, φύλου, χώρας και πόλης από 100 ακολούθους, και το παράδειγμά του για λογαριασμό με 13 ακολούθους δείχνει τις λίστες κενές.
- Ανάγνωση των ωρών του audience_activity ως τοπική ώρα. Το TikTok τις αναφέρει σε UTC+0, οπότε μετατοπίστε τις στη ζώνη ώρας του κοινού πριν προγραμματίσετε αναρτήσεις.
- Τα δημογραφικά ακολούθων ως δημογραφικά θεατών. Οι λίστες του λογαριασμού περιγράφουν τους ακολούθους· το audience_countries ενός βίντεο περιγράφει τους ανθρώπους που το είδαν.
- Αναμονή του audience_activity σε προσωπικό λογαριασμό. Το TikTok το επιστρέφει για λογαριασμούς με Advanced Access ή Verified Business Accounts που έχουν τουλάχιστον 100 ακολούθους.
Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση καθώς προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Μπορεί το TikTok API να δείξει την ηλικία και το φύλο των ακολούθων μου;
Ναι. Το GET /business/get/ επιστρέφει τα audience_ages και audience_genders, ποσοστά ακολούθων ανά ομάδα, όταν ο λογαριασμός έχει τουλάχιστον 100 ακολούθους και το token έχει user.insights.
Ποιες ηλικιακές ομάδες χρησιμοποιεί το API του TikTok;
18-24, 25-34, 35-44, 45-54 και 55+, καθεμία με το ποσοστό των ακολούθων της.
Το TikTok API λέει πότε είναι online οι ακόλουθοί μου;
Το audience_activity δίνει τους ακολούθους που είναι ενεργοί στο TikTok ανά ώρα, σε UTC+0, μέσα στο metrics κάθε ημέρας, για λογαριασμούς με Advanced Access ή Verified Business Accounts με 100 ακολούθους ή περισσότερους.
Πώς το TikTok API δίνει τις χώρες των ακολούθων;
Ως κωδικούς χώρας ή περιοχής ISO 3166-1 alpha-2 στο audience_countries, καθένας με το ποσοστό των ακολούθων από εκεί.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις