Eine zweite Social-Media-Plattform in ein Produkt einzubinden, verdoppelt den Integrationsaufwand selten. Jedes Netzwerk bringt ein anderes Authentifizierungsmodell, ein eigenes Vokabular für Ressourcen, eine andere Antwortstruktur, ein eigenes Paginierungsschema, eine eigene Fehlersystematik und einen eigenen Wartungsrhythmus mit. Aus siebenundzwanzig einzelnen Integrationen können siebenundzwanzig einzelne Systeme werden.
Die SocQ Social Media API stellt öffentliche Daten hinter einen API-Schlüssel, einen asynchronen Aufgaben-Workflow und ein normalisiertes Datensatzmodell. Der aktuelle Katalog umfasst mehr als 170 fokussierte Endpunkte auf 27 Plattformen: soziale Netzwerke, Werbebibliotheken, Commerce, Karten, App-Stores und SEO.

Kurzantwort: Rufen Sie
POST /v1/{platform}/{resource}mit den Eingaben auf, die diese Ressource verlangt, speichern Sie die zurückgegebene Aufgaben-ID und fragen Sie den gemeinsamen Aufgaben-Endpunkt ab. Die Datensätze folgen gemeinsamen normalisierten Konventionen für Plattform, Ressource, Identität, Autor, Kennzahlen, Medien und Zeitstempel und behalten quellenspezifische Werte in eigenen Feldern und inextra.
Was ist eine einheitliche Social-Media-API?
Eine einheitliche API ist eine Abstraktionsschicht über mehreren Plattform-Integrationen. Statt Ihrer Anwendung für jede Quelle ein neues Authentifizierungssystem und eine inkompatible Antwortstruktur beizubringen, binden Sie eine gemeinsame Spezifikation ein und wählen Plattform und Ressource in der Route.
„Einheitlich“ sollte nicht bedeuten, so zu tun, als wären alle Plattformen gleich. Ein LinkedIn-Job ist kein TikTok-Video, eine Marketplace-Anzeige ist kein Instagram-Profil, und ein Ort auf Google Maps hat auf Reddit keine sinnvolle Entsprechung. Ein verantwortungsvolles einheitliches Modell standardisiert die Konzepte, die tatsächlich gemeinsam sind, und bewahrt die quellenspezifische Semantik dort, wo sie sich unterscheidet.
API für öffentliche Daten im Vergleich zu API für verbundene Konten
Unter dem Suchbegriff „einheitliche Social-Media-API“ erscheinen zwei verschiedene Produkte.
Eine API für verbundene Konten nutzt OAuth, damit autorisierte Nutzer Beiträge veröffentlichen, planen, Kommentare oder Nachrichten verwalten und private Konto-Insights lesen können. Sie ist die richtige Kategorie für Software zur Verwaltung von Social Media.
Eine API für öffentliche Daten erfasst unterstützte, öffentlich sichtbare Ressourcen für Recherche, Monitoring, Analyse oder Anreicherung. SocQ gehört zu dieser zweiten Kategorie. Die Endpunkte veröffentlichen keine Beiträge, senden keine Direktnachrichten, verwalten keine Werbung und ersetzen keine offiziellen APIs für autorisierte Kontoaktionen.
Viele Produkte brauchen beides: offizielle APIs oder APIs für verbundene Konten für Schreibzugriffe und berechtigungspflichtige Daten sowie eine Schicht für öffentliche Daten für unterstützte externe Quellen.
27 Plattformen und mehr als 170 Endpunkte
Die Abdeckung lässt sich besser nach Kategorien beurteilen als anhand einer kurzen Liste von Logos.
| Kategorie | Beispiele im Katalog | Was typischerweise erfasst wird |
|---|---|---|
| Social | Instagram (17+), TikTok (18), X (15), Facebook (14), YouTube (12), LinkedIn (11), Reddit (6), Pinterest (4), Threads (3) sowie Douyin, Rednote, Snapchat, Bluesky, Twitch, Truth Social, Kwai | Personen, Beiträge, Kommentare, Suche |
| Werbebibliotheken | Facebook, TikTok, Google und LinkedIn Ad Library | Öffentliche Creatives und Werbetreibenden-Seiten, kein Werbemanager |
| Commerce | TikTok Shop, Facebook Marketplace, Amazon | Produkte, Anzeigen und Bewertungen, kein Verkäufer-Backend |
| Karten | Google Maps | Orte, Suche und Bewertungen |
| App-Stores | Google Play, Apple App Store | Öffentliche App-Details, Rankings und Bewertungen |
| SEO | SEO-Keyword- und SERP-Ressourcen | Suchergebnis- und Keyword-Datensätze |
Die Tiefe zählt dennoch mehr als ein Plattformname. Instagram ist nicht „die eine Instagram-API“. TikTok Shop ist nicht der TikTok-Videokatalog. Welche Eingaben jede Ressource akzeptiert und welche Felder sie zurückgibt, sehen Sie im API-Katalog.
REST ist nur ein Zugang. MCP, die CLI und der Agent Skill sind weitere Zugänge zum selben Katalog. Dieser Artikel bleibt beim HTTP-Vertrag.
Ein Muster für Authentifizierung und Aufgaben
Alle aktuellen Endpunkte des Katalogs verwenden Bearer-Authentifizierung:
Authorization: Bearer $SOCQ_API_KEY
Content-Type: application/json
Das Anlegen einer Ressource folgt einer vorhersehbaren Route:
POST /v1/{platform}/{resource}
Beispiele:
POST /v1/tiktok/profiles
POST /v1/instagram/reels
POST /v1/x/search
POST /v1/linkedin/jobs
POST /v1/tiktok-shop/search
POST /v1/facebook-ad-library/search
POST /v1/google-maps/search
Die Eingaben bleiben ressourcenspezifisch. Profile akzeptieren möglicherweise Benutzernamen, bekannte Entitäten verlangen eventuell URLs, und Such-Endpunkte nehmen Suchanfragen samt unterstützten Filtern entgegen. Eine einheitliche API sollte das operative Verhalten normalisieren, ohne ungültige Eingaben in einen einzigen generischen Body zu pressen.
Der gemeinsame asynchrone Workflow
Eine langlaufende Erfassung sollte keine HTTP-Verbindung offen halten. SocQ legt eine Aufgabe an:
Client
└─ POST platform resource
└─ task_id
└─ poll common task endpoint
├─ queued
├─ running
├─ succeeded → paginated records
└─ failed/cancelled → normalized error
Speichern Sie die Aufgaben-ID, bevor Sie abfragen. Verwenden Sie exponentielles Backoff, behandeln Sie queued und running als Normalfall, verarbeiten Sie Datensätze erst nach dem Erfolg und fahren Sie fort, wenn das Ergebnis weitere Seiten anzeigt.
Dank dieses gemeinsamen Zustandsautomaten kann ein einziger Worker den gesamten Katalog orchestrieren:
def submit(platform, resource, payload):
return post(f"/v1/{platform}/{resource}", json=payload)["data"]["task_id"]
def wait_for_task(task_id):
while True:
task = get(f"/v1/tasks/{task_id}")["data"]
if task["status"] == "succeeded":
return task
if task["status"] in {"failed", "cancelled"}:
raise CollectionError(task)
backoff()
Produktivcode sollte außerdem Cursor speichern, Wiederholungen begrenzen, Fehler klassifizieren und nachgelagerte Schreibvorgänge idempotent gestalten.
Ein normalisiertes Datensatzmodell
Wo sinnvoll, folgen Datensätze gemeinsamen Konventionen:
{
"id": "source-id",
"platform": "tiktok",
"resource": "videos",
"type": "video",
"url": "https://source.example/item",
"author": {
"id": "author-id",
"username": "creator",
"name": "Creator"
},
"metrics": {
"likes_count": 120,
"comments_count": 8
},
"media": [],
"created_at": "2026-09-09T08:00:00Z",
"collected_at": "2026-09-10T08:00:00Z",
"extra": {}
}
Nicht jede Ressource hat jedes Feld. Ein Profil kann name, description und avatar_url enthalten, ein Beitrag text, ein Video eine Dauer oder Audio, ein Job Beschäftigungsdaten, und ein Shop-Ergebnis trägt Preis- und SKU-Kontext in extra. Modellieren Sie optionale Felder als nullbar und verzweigen Sie nach resource oder type, wenn quellenspezifische Logik nötig ist.
Was sich vereinheitlichen lässt
Authentifizierung
Ein SocQ-API-Schlüssel kann Anfragen für den gesamten Katalog authentifizieren.
Aufgabenzyklus
Übermittlung, Abfrage, Endzustände, Paginierung und Nachvollziehbarkeit der Aufgaben lassen sich mit einem einzigen Worker-Muster abdecken.
Herkunft
Jeder gespeicherte Datensatz sollte platform, resource, Quell-URL oder Suchanfrage, Erfassungszeit und die Aufgaben-ID der Quelle behalten.
Gemeinsame Entitäten
IDs, URLs, Autoren, öffentliche Kennzahlen, Medienverweise, Veröffentlichungszeiten und Erfassungszeiten können gemeinsamen Konventionen folgen, soweit die Quelle sie bereitstellt.
Fehlerbehandlung
Ihre Anwendung kann Eingabevalidierung, nicht verfügbare öffentliche Ressourcen, vorübergehende Fehler der Quelle, Ratenbegrenzungen und endgültige Erfassungsfehler auf eine interne Systematik abbilden.
Was sich nicht in eine einzige Form zwingen lässt
Kennzahlen sind nicht austauschbar
Ein TikTok-Play, eine Instagram-Ansicht, ein YouTube-Aufruf, eine X-Impression, ein Reddit-Score, eine LinkedIn-Reaktion, eine Werbe-Impression, eine Verkaufszahl bei Produkten und eine Kartenbewertung können unterschiedlich definiert und unterschiedlich verfügbar sein. Behalten Sie den ursprünglichen Kennzahlennamen bei, statt eine einzige irreführende engagement-Zahl zu bilden.
Die Tiefe der Ressourcen unterscheidet sich
YouTube hat Transkripte und Kanäle. LinkedIn hat Jobs und Unternehmen. Reddit hat Subreddits. TikTok hat Hashtags. Werbebibliotheken haben Creatives. Karten haben Orte. Eine Abdeckungsmatrix sollte diese Unterschiede sichtbar machen.
Die Semantik der Entdeckung unterscheidet sich
Such-Ranking, historische Reichweite, Lokalisierung, Ergebnislimits und Aktualität variieren je nach Plattform. Dieselbe Suchanfrage über mehrere Netzwerke – oder über Shop, Ad Library und Karten – ist keine Messung, bei der Gleiches mit Gleichem verglichen wird.
Zugriff und Sichtbarkeit unterscheiden sich
Öffentliche Verfügbarkeit, gelöschte Inhalte, private Konten, Alters- oder Regionsbeschränkungen und Ansichten mit Anmeldung sind plattformspezifisch. Eine einheitliche API darf nicht suggerieren, dass Zugriffskontrollen verschwinden.
Anfragebeispiele aus verschiedenen Kategorien
TikTok-Profile erfassen:
curl -X POST "https://api.socq.ai/v1/tiktok/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["tiktok","natgeo"]}'
TikTok Shop durchsuchen:
curl -X POST "https://api.socq.ai/v1/tiktok-shop/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"running shoes","results_limit":100,"region":"US"}'
Facebook Ad Library durchsuchen:
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"running shoes","results_limit":100,"country":"US","status":"ACTIVE","media_type":"VIDEO","sort_by":"total_impressions"}'
Google Maps durchsuchen:
curl -X POST "https://api.socq.ai/v1/google-maps/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"coffee","location":"New York, NY","country":"US","results_limit":3}'
Autorisierung und Aufgaben-Workflow bleiben gleich; nur die gültigen Eingaben der Ressource ändern sich. Plattformspezifische Anleitungen gibt es unter anderem für TikTok, X und SocQ MCP.
Muster für einen TypeScript-Client
Verwenden Sie diskriminierte Anfragetypen statt einer untypisierten generischen Nutzlast:
type RequestMap = {
"tiktok/profiles": { usernames: string[] };
"instagram/reels": { usernames: string[]; results_limit?: number };
"x/search": { query: string; results_limit?: number; sort_by?: "latest" | "top" };
"linkedin/jobs": { urls: string[] };
"tiktok-shop/search": { query: string; results_limit?: number; region?: string };
"facebook-ad-library/search": { query: string; results_limit?: number; country?: string };
"google-maps/search": { query: string; location: string; country?: string; results_limit?: number };
};
async function submit<K extends keyof RequestMap>(
endpoint: K,
payload: RequestMap[K],
) {
const response = await fetch(`https://api.socq.ai/v1/${endpoint}`, {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.SOCQ_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify(payload),
});
if (!response.ok) throw new Error(`SocQ ${response.status}`);
return response.json();
}
Erzeugen oder pflegen Sie diese Typen aus einer internen Endpunkt-Registry, damit Dokumentation, Validierung und Clients nicht unabhängig voneinander auseinanderlaufen.
Datenbankdesign
Ein praxistaugliches Warehouse verwendet eine gemeinsame Hülle plus Tabellen je Ressource:
social_record
platform
resource
source_id
canonical_url
author_id
created_at
collected_at
source_task_id
raw_json
social_metric_snapshot
platform
resource
source_id
collected_at
metric_name
metric_value
resource-specific tables
transcript segments
job details
profile attributes
product and listing fields
place and review fields
media metadata
Packen Sie nicht jedes denkbare Plattformfeld in eine Tabelle mit 200 Spalten. Behalten Sie die normalisierte Hülle bei und nutzen Sie dann typisierte Ressourcentabellen oder validiertes JSON für quellenspezifische Tiefe.
Fehlernormalisierung und Wiederholungen
Trennen Sie:
- Ungültige Eingaben, die nie erfolgreich sein werden.
- Nicht unterstützte oder nicht verfügbare öffentliche Ressourcen.
- Fehler bei Authentifizierung und Konto.
- Raten- oder Credit-Limits.
- Vorübergehende Fehler der Quelle.
- Fehler des Anbieters oder fehlgeschlagene Schema-Validierungen.
Wiederholen Sie nur vorübergehende Fehlerklassen. Verwenden Sie begrenztes exponentielles Backoff mit Jitter. Halten Sie Versuch und Aufgaben-ID fest und gestalten Sie Upserts idempotent, damit eine Wiederholung keine Datensätze dupliziert.
Einheitliche API im Vergleich zu nativen Plattform-APIs
| Entscheidungsfaktor | Einheitliche API für öffentliche Daten | Native Plattform-APIs |
|---|---|---|
| Integration | Ein Muster für Authentifizierung und Aufgaben | Je nach Plattform unterschiedlich |
| Schema | Normalisierter Kern | Plattformeigene Objekte |
| Wartung | Der Anbieter fängt viele Änderungen der Quellen auf | Ihr Team folgt jeder Plattform |
| Öffentliche externe Daten | Abdeckung unterstützter Ressourcen | Oft durch Produkt und Berechtigung eingeschränkt |
| Veröffentlichung und Kontoaktionen | Von SocQ nicht angeboten | Offizielle APIs sind erforderlich |
| Plattformspezifische Tiefe | Auf den Katalog begrenzt | Am größten bei genehmigtem Zugang |
| Governance | Ein Anbieter plus Pflichten gegenüber den Quellen | Direkte Beziehung zur Plattform |
Das ist keine Entweder-oder-Entscheidung. Nutzen Sie native APIs für Schreibzugriffe, eigene Analysen und berechtigungspflichtige Workflows und eine einheitliche API für öffentliche Daten für unterstützte öffentliche Lesezugriffe, wenn dieses Zugangsmodell passt.
Häufige Anwendungsfälle
- Marken- und Themenmonitoring in sozialen Netzwerken.
- Recherche zu Influencern und Creatorn.
- Analyse von Wettbewerbsinhalten und Creatives.
- Recherche zu öffentlichen Shops, Marketplaces und Produkten.
- Erfassung von Orten und Bewertungen.
- Datensätze zu App-Stores und SEO.
- Recherche-Tools für KI-Agenten, die einen gemeinsamen Katalog nutzen.
- Datensätze zu Kommentaren, Beiträgen, Videos und Transkripten.
- Anreicherung öffentlicher Profile oder Unternehmen mit angemessenen Schutzmaßnahmen.
Richten Sie die Pipeline an den Daten aus, die für den Anwendungsfall unbedingt nötig sind, nicht an allen Feldern, die die Quelle möglicherweise bereitstellt.
Wann Sie keine einheitliche API für öffentliche Daten verwenden sollten
Verwenden Sie SocQ nicht, wenn:
- Sie veröffentlichen, antworten, Direktnachrichten senden oder Werbung verwalten müssen.
- Sie private Konto-Insights mit Nutzerautorisierung benötigen.
- Ein offizielles Partnerprogramm zwingend vorgeschrieben ist.
- Eine einzelne plattformspezifische Funktion unverzichtbar ist und im Katalog fehlt.
- Ihre rechtlichen, vertraglichen oder Governance-Vorgaben die geplante Erfassung untersagen.
Die richtige Antwort kann eine offizielle API, ein Anbieter für verbundene Konten, ein lizenzierter Datensatz oder gar keine Erfassung sein.
Von einer Plattform zum Katalog migrieren
- Definieren Sie eine normalisierte interne Hülle, bevor Sie Quellen hinzufügen.
- Binden Sie eine besonders wertvolle Ressource an und bewahren Sie die Rohantworten auf.
- Validieren Sie IDs, Zeitstempel, Kennzahlen, Medien und den Umgang mit Nullwerten.
- Fügen Sie über denselben Aufgaben-Worker eine zweite Plattform oder Kategorie hinzu.
- Halten Sie quellenspezifische Adapter an der Validierungsgrenze.
- Betreiben Sie alte und neue Pipeline parallel mit einer festen Stichprobe.
- Vergleichen Sie akzeptierte eindeutige Datensätze, Aktualität und Kosten.
- Migrieren Sie schrittweise und halten Sie Rückfallpfade bereit.
Das Hinzufügen von Plattformen wird erst dann zu Konfigurationsarbeit, wenn Datenbedeutung, Beobachtbarkeit und Fehlerbehandlung tatsächlich standardisiert sind.
Sicherheit, Datenschutz und verantwortungsvolle Nutzung
Bewahren Sie API-Schlüssel in einem Secret-Manager auf, vergeben Sie Zugriff auf gespeicherte Daten nach dem Prinzip der minimalen Rechte, verschlüsseln Sie Übertragung und Speicherung, protokollieren Sie administrative Zugriffe und legen Sie Verfahren für Aufbewahrung und Löschung fest.
Erfassen Sie nur unterstützte öffentliche Daten, die für einen legitimen Zweck nötig sind. Umgehen Sie keine privaten Konten, Anmeldehürden, Zielgruppenbeschränkungen oder sonstigen Einschränkungen. Prüfen Sie Plattformbedingungen, Datenschutzpflichten, Regeln zum geistigen Eigentum und das geltende Recht. Eine einheitliche technische Schnittstelle vereinheitlicht oder beseitigt keine rechtlichen Pflichten.
Häufig gestellte Fragen (FAQ)
Ersetzt eine einheitliche Social-Media-API die offiziellen APIs?
Nein. SocQ übernimmt unterstützte öffentliche Lesezugriffe. Für Veröffentlichung, OAuth-Nutzeraktionen, private Insights und Partnerprodukte der Plattformen bleiben offizielle APIs erforderlich.
Geben alle 27 Plattformen exakt dieselben Felder zurück?
Nein. Sie teilen normalisierte Konventionen, wo die Konzepte übereinstimmen, während ressourcenspezifische Felder eigenständig bleiben.
Brauche ich einen API-Schlüssel pro Plattform?
Ein SocQ-Schlüssel deckt den SocQ-Katalog ab. Offizielle Integrationen oder solche anderer Anbieter erfordern weiterhin eigene Zugangsdaten.
Kann SocQ Social-Media-Beiträge veröffentlichen?
Nein. Die aktuellen Endpunkte sind rein lesende Operationen für öffentliche Daten.
Wie werden Ratenbegrenzungen gehandhabt?
Ihre Anwendung sollte die Limits des SocQ-Kontos einhalten, den Zustand asynchroner Aufgaben speichern, beim Abfragen ein Backoff verwenden und nur vorübergehende Fehler wiederholen.
Ist das für KI-Agenten geeignet?
Ja, wenn der Agent typisierte Tools, eingeschränkte Eingaben, gespeicherten Aufgabenzustand, Validierung und eine menschliche Freigabe für folgenreiche nachgelagerte Aktionen nutzt. Beginnen Sie mit MCP, wenn der Client dieses Protokoll spricht.
Was deckt der aktuelle Katalog ab?
27 Plattformen und mehr als 170 Endpunkte in sozialen Netzwerken, Werbebibliotheken, Commerce, Karten, App-Stores und SEO. Die aktuelle Liste finden Sie unter /apis.
MULTI-PLATTFORM API
Workflow mit einer öffentlichen Multi-Plattform-URL testen
Senden Sie öffentliche Eingaben und erhalten Sie normalisierte Datensätze mit nachvollziehbarem Quellkontext.
Multi-Plattform-APIs ansehen