Instagram
BulkPublish
Instagram API
Veröffentliche, plane und verwalte Instagram aus deinem eigenen Code. Eine REST-API und ein Schlüssel decken Instagram und jedes andere verbundene Netzwerk ab, du schreibst die Integration also nur einmal.
Was die Instagram API abdeckt
Alles unten gehört zur veröffentlichten API und funktioniert heute mit Instagram.
| Funktion | Endpunkt |
|---|---|
| Beiträge erstellen, planen, bearbeiten und veröffentlichen | POST /api/posts |
| Bilder und Videos hochladen | POST /api/media |
| Den nächsten freien Slot in deiner Warteschlange finden | GET /api/posts/queue-slot |
| Wiederkehrende Pläne anlegen | POST /api/schedules |
| Neue Einträge aus einem RSS-Feed veröffentlichen | POST /api/rss-feeds |
| Automatisch einen ersten Kommentar posten | platformSpecific._firstComment |
| Einen Beitrag als Story veröffentlichen | POST /api/posts/{id}/story |
| Kennzahlen pro Beitrag lesen | GET /api/posts/{id}/metrics |
| Kommentare unter veröffentlichten Beiträgen lesen und beantworten | GET /api/posts/{id}/engagement, POST /api/posts/{id}/comments/reply |
| Direktnachrichten lesen und beantworten | GET /api/inbox/conversations, POST /api/inbox/conversations/{id}/messages |
| Prüfen, ob die Verbindung in Ordnung ist | GET /api/channels/{id}/health |
| Die Nutzung deines Tarifs prüfen | GET /api/quotas/usage |
Beitragstypen, die du auf Instagram veröffentlichen kannst
Wähle den Typ mit postTypeOverrides. Ein Typ, den Instagram nicht anbietet, wird abgelehnt, bevor etwas eingereiht wird.
| Beitragstyp | Medien |
|---|---|
feed_photo Feed Photo | Erforderlich: 1 Bild |
feed_video Feed Video | Erforderlich: 1 Video |
reel Reel | Erforderlich: 1 Video |
story Story | Erforderlich: 1 Bild oder Video |
carousel Carousel | Erforderlich: 2 bis 10 Bilder oder Videos |
Einen Instagram-Beitrag mit curl planen
Drei Anfragen: Kanal finden, die Datei hochladen, falls der Beitrag eine hat, dann den Beitrag erstellen. Ersetze den Schlüssel durch einen aus Einstellungen, dann API-Schlüssel, und 12 durch deine eigene Kanal-ID.
1. Liste deine Kanäle auf und notiere die ID deines Instagram-Kontos.
curl https://app.bulkpublish.com/api/channels \
-H "Authorization: Bearer bp_your_key_here" 2. Lade die Datei hoch. Die Antwort enthält die Medien-ID, die unten als mediaFiles verwendet wird.
curl -X POST https://app.bulkpublish.com/api/media \
-H "Authorization: Bearer bp_your_key_here" \
-F "file=@clip.mp4" 3. Erstelle den Beitrag.
curl -X POST https://app.bulkpublish.com/api/posts \
-H "Authorization: Bearer bp_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"content": "Behind the scenes of launch day",
"channels": [{ "channelId": 12 }],
"status": "scheduled",
"scheduledAt": "2026-12-01T09:00:00Z",
"mediaFiles": [101],
"postTypeOverrides": {
"instagram": "reel"
},
"platformSpecific": {
"instagram": {
"collaborators": "bulkpublish",
"thumbnailTimestamp": 2
}
}
}' Die Antwort ist der erstellte Beitrag mit ID und Status. Rufe ihn später mit GET /api/posts/{id} ab, um zu sehen, wie es lief.
Instagram-Optionen
Sende diese innerhalb von platformSpecific, unter dem Schlüssel für Instagram.
| Option | Was sie bewirkt | Akzeptiert |
|---|---|---|
collaborators | Nutzernamen, die als Co-Autoren markiert werden | Text |
shareToStory | Zusätzlich in einer Story teilen | true oder false |
trialReel | Als Trial Reel veröffentlichen | true oder false |
graduationStrategy | Wie ein Trial Reel zum normalen Reel wird | manualauto |
thumbnailTimestamp | Titelbild-Frame, in Sekunden ab Beginn | eine Zahl |
coverUrl | Titelbild über eine öffentliche URL | Text |
Instagram-Analysen über die API
Diese Kennzahlen kommen für jeden Instagram-Beitrag über GET /api/posts/{id}/metrics zurück, mit Momentaufnahmen im Zeitverlauf.
- Impressionen
- Reichweite
- Likes
- Kommentare
- Geteilt
- Gespeichert
- Interaktionsrate
Kommentare und Nachrichten
Über die API kannst du Kommentare unter veröffentlichten Beiträgen lesen und beantworten und Direktnachrichten lesen und beantworten.
Antworten auf Instagram werden bis zu 24 Stunden nach der letzten Nachricht der Person angenommen.
Kommentare lesen geht in jedem Tarif. Kommentare beantworten braucht einen bezahlten Tarif, und die Inbox gehört zu Pro und Business. Solange eine Funktion für dein Konto nicht freigeschaltet ist, antwortet die API mit 403 und einem Code, den du abfragen kannst.
API-Zugriff in jedem Tarif
Jeder Tarif enthält API-Schlüssel, auch der Free-Tarif. Das erlaubt jeder Stufe.
| Tarif | API-Schlüssel | Anfragen pro Tag |
|---|---|---|
| Free | 1 | 30 |
| Pro | 5 | 5.000 |
| Business | 10 | 50.000 |
Direkt auf Instagram aufbauen oder BulkPublish nutzen
Der direkte Weg ist eine faire Wahl, besonders wenn du etwas brauchst, das BulkPublish nicht anbietet. Das verlangt Instagram Platform API von dir, geprüft anhand der Dokumentation im Oktober 2026.
- Zum Veröffentlichen ist ein professionelles Konto nötig.
- Dokumentiertes Limit: 100 per API veröffentlichte Beiträge in 24 Stunden.
- Medien werden von einer öffentlichen URL abgerufen, die du selbst bereitstellen musst.
- Ein Beitrag mit Medien braucht mehrere Aufrufe: hochladen oder anlegen, auf die Verarbeitung warten, dann veröffentlichen.
- Zugriffstokens laufen nach etwa 60 Tagen ab, du brauchst also einen eigenen Weg, sie zu erneuern oder die Verbindung neu aufzubauen, bevor sie verfallen.
BulkPublish hält die Verbindung für dich aufrecht: Es erneuert Tokens, prüft jeden Beitrag vor dem Einreihen gegen die Regeln von Instagram und meldet ein fehlgeschlagenes Ziel am Beitrag, sodass dein Code nur eine Anfrage stellt.
Offizielle Dokumentation lesen
Lieber einen Assistenten fragen?
Claude, ChatGPT und Cursor können dasselbe über den Instagram-MCP-Server, mit Prompts statt Code.
Den Instagram-MCP-Server ansehen
Lieber einen Kalender als Code?
Dasselbe Instagram-Konto lässt sich auch in der App planen, mit Content-Kalender und Massen-Upload.
Häufige Fragen
Häufige Fragen zur Instagram API.
Gibt es eine Instagram API, die ich nutzen kann, ohne die Integration selbst zu bauen?
Ja. BulkPublish stellt Instagram über seine REST-API bereit. Verbinde dein Instagram-Konto einmal, dann kannst du es mit einem Schlüssel veröffentlichen, planen und verwalten. Derselbe Schlüssel funktioniert für jedes andere verbundene Netzwerk.
Was kann ich über die API auf Instagram veröffentlichen?
Die Beitragstypen sind Feed Photo, Feed Video, Reel, Story und Carousel. Jeder wird vor dem Einreihen gegen die Medienregeln von Instagram geprüft, eine Anfrage, die Instagram ablehnen würde, scheitert also sofort mit einer klaren Fehlermeldung.
Kann ich Instagram-Beiträge über die API planen?
Ja. Sende den Status "scheduled" mit einer scheduledAt-Zeit und einer timezone, oder frage zuerst nach dem nächsten freien Slot in deiner Warteschlange. Wiederkehrende Pläne und RSS-Feeds gibt es ebenfalls.
Kann ich Instagram-Analysen über die API lesen?
Ja. Zu den Kennzahlen pro Beitrag gehören Impressionen, Reichweite, Likes, Kommentare, Geteilt, Gespeichert und Interaktionsrate, mit Momentaufnahmen im Zeitverlauf.
Kann ich Instagram-Kommentare oder -Nachrichten über die API lesen und beantworten?
Ja. Du kannst Kommentare unter veröffentlichten Beiträgen lesen und beantworten und Direktnachrichten lesen und beantworten. Kommentare beantworten braucht einen bezahlten Tarif, und die Inbox gehört zu Pro und Business.
Kostet die Instagram API extra?
Nein. Der API-Zugriff ist in jedem Tarif enthalten. Free umfasst 1 Schlüssel und 30 Anfragen am Tag, Pro 5 Schlüssel und 5.000 am Tag, Business 10 Schlüssel und 50.000 am Tag.
Brauche ich ein Instagram-Entwicklerkonto oder eine App-Prüfung?
Nicht, um BulkPublish zu nutzen. Du verbindest dein Instagram-Konto auf der Seite Kanäle und veröffentlichst mit einem BulkPublish-Schlüssel. Wenn du stattdessen auf der eigenen API von Instagram aufbaust, steht im Abschnitt oben, was sie von dir verlangt.
Kann das auch ein KI-Assistent erledigen?
Ja. Die Seite zum Instagram-MCP-Server zeigt, wie du Claude, ChatGPT oder Cursor verbindest und was du anfragen kannst.
Weitere Netzwerke
Derselbe Schlüssel und dieselbe Anfrageform funktionieren für 15 Netzwerke.
Per Code auf Instagram veröffentlichen
Erstelle ein kostenloses Konto, verbinde Instagram und erzeuge einen Schlüssel. Keine Karte nötig.