ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
easyCoexistence Επίσημα API

Instagram hashtag search API: εύρεση δημοσιεύσεων ανά hashtag

Η αναζήτηση hashtag του Instagram βρίσκει δημόσιες φωτογραφίες και βίντεο που φέρουν ένα hashtag, σε δύο κλήσεις. Το GET /ig_hashtag_search με user_id και q επιστρέφει το ID του hashtag, και έπειτα το GET /<HASHTAG_ID>/top_media εμφανίζει τις πιο δημοφιλείς δημοσιεύσεις, ενώ το /recent_media εκείνες που δημοσιεύτηκαν τις τελευταίες 24 ώρες. Ένας λογαριασμός μπορεί να αναζητήσει 30 μοναδικά hashtags σε κυλιόμενη περίοδο 7 ημερών, με Facebook Login ή Unified Login.

Το easyCoexistence συνδέει το Instagram με Instagram Login, ώστε το Claude, το ChatGPT ή ο δικός σας κώδικας να δουλεύει με τις δικές του δημοσιεύσεις, σχόλια, αναφορές και insights μέσω του επίσημου API της Meta, ενώ τα σχόλια και οι αναφορές του μπορούν να προωθούνται στο endpoint σας καθώς φτάνουν.

30

Μοναδικά hashtags που μπορεί να αναζητήσει ένας επιχειρηματικός ή δημιουργικός λογαριασμός σε κυλιόμενη περίοδο 7 ημερών.

24 hours

Το recent_media επιστρέφει μόνο περιεχόμενο που δημοσιεύτηκε μέσα σε 24 ώρες από το ερώτημα.

50

Τα περισσότερα αποτελέσματα ανά σελίδα προέρχονται από το top_media, το οποίο σελιδοποιείται μόνο με after cursor.

Not supported

Η αναζήτηση hashtag με το Instagram API και Instagram Login, στη σύγκριση των τριών ρυθμίσεων της Meta.

Static

Τα ID των hashtags είναι στατικά και καθολικά: ένα hashtag διατηρεί το ίδιο ID για κάθε εφαρμογή και χρήστη.

Πώς λειτουργεί η αναζήτηση hashtag;

Σε δύο βήματα, για λογαριασμό ενός επιχειρηματικού ή δημιουργικού λογαριασμού Instagram, του οποίου το ID μπαίνει στο user_id. Το GET /ig_hashtag_search με q ορισμένο στο όνομα του hashtag επιστρέφει το ID του, το οποίο, σύμφωνα με τη Meta, είναι στατικό και καθολικό, οπότε μπορεί να αποθηκευτεί. Έπειτα, το GET /<HASHTAG_ID>/top_media ή /recent_media, με user_id και fields, εμφανίζει τις δημοσιεύσεις.

Finding a hashtag's ID, then its recent posts
GET /ig_hashtag_search?user_id=<IG_ID>&q=coffee

{ "data": [ { "id": "<HASHTAG_ID>" } ] }

GET /<HASHTAG_ID>/recent_media
  ?user_id=<IG_ID>
  &fields=id,media_type,permalink,timestamp,like_count,comments_count

Ποια είναι η διαφορά μεταξύ top_media και recent_media;

Το top_media επιστρέφει τις πιο δημοφιλείς φωτογραφίες και βίντεο με το hashtag, όπου η Meta κρίνει τη δημοτικότητα με συνδυασμό προβολών και αλληλεπίδρασης θεατών. Το recent_media επιστρέφει τις πιο πρόσφατα δημοσιευμένες, περιορισμένες σε περιεχόμενο που δημοσιεύτηκε μέσα σε 24 ώρες από το ερώτημα, και η Meta σημειώνει ότι οι απαντήσεις του δεν είναι πάντα σε χρονολογική σειρά. Και τα δύο επιστρέφουν μόνο δημόσιο περιεχόμενο, αφήνουν εκτός τα προωθημένα, ενισχυμένα και διαφημιστικά μέσα, και σελιδοποιούνται 50 τη φορά με after cursor.

Ποια πεδία επιστρέφονται;

Τα πεδία media που αναφέρουν οι οδηγοί της Meta και για τα δύο edges, τα οποία επιστρέφουν μόνο δημόσιες φωτογραφίες και βίντεο:

  • id, media_type (CAROUSEL_ALBUM, IMAGE ή VIDEO), permalink και timestamp.
  • caption και comments_count, καθώς και like_count, εκτός αν ο ιδιοκτήτης έχει αποκρύψει τους μετρητές «Μου αρέσει».
  • children για περιεχόμενο άλμπουμ και media_url για άλλο περιεχόμενο, αλλά όχι για βίντεο με προστατευμένο ή αδειοδοτημένο ήχο.
  • Όχι username: η Meta δεν το επιτρέπει σε περιεχόμενο που επιστρέφεται από την αναζήτηση hashtag.

Ποια είναι τα όρια;

Η Meta τα ορίζει ανά λογαριασμό και ανά hashtag:

  • 30 μοναδικά hashtags σε κυλιόμενη περίοδο 7 ημερών. Ένα hashtag μετράει από το πρώτο του ερώτημα· νέο ερώτημα για αυτό μέσα σε εκείνη την περίοδο δεν μετράει και δεν επανεκκινεί τις 7 ημέρες του.
  • Η λήψη top_media ή recent_media μετράει ως ερώτημα για το hashtag, ακόμη και όταν το ID του είναι ήδη αποθηκευμένο.
  • Το GET /<IG_ID>/recently_searched_hashtags εμφανίζει τα μοναδικά hashtags που έψαξε ο λογαριασμός την τρέχουσα εβδομάδα.
  • Τα hashtags σε Stories και τα emoji στα ερωτήματα δεν υποστηρίζονται, και τα hashtags που η Meta θεωρεί ευαίσθητα ή προσβλητικά επιστρέφουν γενικό σφάλμα.
  • Το περιεχόμενο που βρίσκεται με αυτόν τον τρόπο δεν μπορεί να σχολιαστεί μέσω του API.

Τι χρειάζεται η αναζήτηση hashtag;

Την έγκριση App Review για τη λειτουργία Instagram Public Content Access και την άδεια instagram_basic, που η Meta απαιτεί πριν μια εφαρμογή μπορέσει να τις χρησιμοποιήσει, και ένα user access token από Facebook Login για πρόσωπο που μπορεί να εκτελεί εργασίες στη συνδεδεμένη Σελίδα, ή ένα token Unified Login. Η επισκόπηση της Meta αναφέρει ότι η αναζήτηση hashtag δεν υποστηρίζεται με Instagram Login, και οι κλήσεις της υπάγονται στα όρια ρυθμού της Platform της Meta και όχι στον προϋπολογισμό κλήσεων ανά λογαριασμό του Instagram. Οι επιτρεπόμενες χρήσεις που αναφέρει η Meta περιλαμβάνουν την εύρεση περιεχομένου από τις καμπάνιες hashtag σας, την κατανόηση της δημόσιας γνώμης για τη μάρκα σας και τον εντοπισμό συμμετεχόντων σε διαγωνισμούς.

Μπορείτε να αναζητήσετε hashtags μέσω του easyCoexistence;

Το easyCoexistence συνδέει το Instagram με Instagram Login, το οποίο φτάνει στις δικές του δημοσιεύσεις, στα σχόλια, στις αναφορές και στα insights του συνδεδεμένου λογαριασμού. Η Meta προσφέρει αναζήτηση hashtag μόνο με Facebook Login και Unified Login, οπότε βρίσκεται εκτός αυτής της σύνδεσης. Η σύνδεση καλύπτει αντί γι' αυτό: τις δικές του δημοσιεύσεις μέσω του list_social_posts, και τα σχόλια και τις αναφορές του, που προωθούνται στο endpoint σας καθώς φτάνουν.

Συνηθισμένα λάθη

  • Σπατάλη της εβδομαδιαίας ποσόστωσης σε δοκιμές. Κάθε νέο hashtag μετράει στα 30 των 7 ημερών, και η λήψη των δημοσιεύσεών του μετράει ακόμη και με αποθηκευμένο ID.
  • Ζήτηση του username στα αποτελέσματα hashtag. Η Meta δεν το επιστρέφει για περιεχόμενο που βρέθηκε μέσω αναζήτησης hashtag.
  • Αντιμετώπιση του recent_media ως αρχείου. Καλύπτει περιεχόμενο που δημοσιεύτηκε στις 24 ώρες πριν από το ερώτημα, και όχι αυστηρά με χρονολογική σειρά.
  • Κλήση με token Instagram Login. Η Meta σημειώνει ότι η αναζήτηση hashtag δεν υποστηρίζεται σε αυτή τη ρύθμιση.
Κάντε το με EasyCoexistence

US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και με τις πρώτες 3 ημέρες δωρεάν.

Συχνές ερωτήσεις

Μπορεί το Instagram API να αναζητά hashtags χωρίς App Review;

Όχι. Η Meta απαιτεί έγκριση App Review για τη λειτουργία Instagram Public Content Access και για το instagram_basic, πριν μια εφαρμογή μπορέσει να καλέσει την αναζήτηση hashtag.

Μπορώ να δω ποιος δημοσίευσε με ένα hashtag;

Όχι με username, το οποίο η Meta αφήνει εκτός των αποτελεσμάτων hashtag. Το permalink κάθε δημοσίευσης την ανοίγει στο Instagram.

Η αναζήτηση hashtag περιλαμβάνει Stories;

Όχι. Η Meta δεν υποστηρίζει hashtags σε Stories, και τα δύο edges επιστρέφουν μόνο δημόσιες φωτογραφίες και βίντεο.

Μετράει διπλά η νέα αναζήτηση του ίδιου hashtag;

Όχι. Τα επαναλαμβανόμενα ερωτήματα μέσα στις 7 ημέρες του δεν μετράνε στα 30 και δεν επανεκκινούν το χρονόμετρο του hashtag.

Συνεχίστε την ανάγνωση

Instagram Business Discovery: ανάγνωση των δημοσιεύσεων και του αριθμού ακολούθων άλλου λογαριασμούΠώς το Business Discovery του Instagram διαβάζει τον αριθμό ακολούθων, το προφίλ και τις δημοσιεύσεις άλλου λογαριασμού με username.Mentions στο Instagram μέσω του API: εύρεση και απάντηση σε @mentionsΠώς φτάνουν τα @mentions του Instagram μέσω του API, στο webhook των σχολίων με Instagram Login, και πώς απαντάτε σε σχόλια και λεζάντες.Λήψη των αναρτήσεων ενός λογαριασμού Instagram μέσω του APIΠώς το API του Instagram εμφανίζει τις αναρτήσεις με GET /<IG_ID>/media: πεδία, στοιχεία καρουζέλ, σελιδοποίηση και ροή για ιστότοπο.Επισήμανση ατόμων και προσθήκη τοποθεσίας σε ανάρτηση Instagram μέσω του APIΕπισήμανση ατόμων με user_tags και τοποθεσίας με location_id στο API του Instagram: ποιες αναρτήσεις τις δέχονται και πώς βρίσκεται την τοποθεσία.Όρια ρυθμού Instagram API: κλήσεις ανά 24 ώρες και ρυθμός DMsΌρια ρυθμού Instagram API: 4.800 κλήσεις ανά εμφάνιση σε 24 ώρες, 100 DMs ανά δευτερόλεπτο, 750 ιδιωτικές απαντήσεις την ώρα και σφάλμα 80002.Δικαιώματα του Instagram API: τα scopes κάθε λειτουργίαςΤα δικαιώματα του Instagram API με Instagram Login, από το instagram_business_basic έως το manage_insights, και ποια χρειάζεται κάθε λειτουργία.

Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.

Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.

  • 3 ημέρες δωρεάν
  • Ακύρωση ανά πάσα στιγμή
  • Μόνο επίσημα API
  • Παρακολούθηση 24/7

Επαληθεύτηκε στις