Synup
Schlüssel erstellen
v1Ressourcen/SEO/postBudgetierte Keyword-Recherche kalkulieren oder ausführen; gespeicherte Belege abgleichen

Budgetierte Keyword-Recherche kalkulieren oder ausführen; gespeicherte Belege abgleichen

Nur für den festen Synup-Marketingwebsite-Piloten. Die Vorschau liest kostenlose Kontopreise sowie gespeicherte Daten/Credits; sie kauft nichts und reserviert kein Geld. Fehlende Konfiguration, ungeeignete Tarife oder ungeprüfte Konto-/Preis-/Guthabendaten ergeben unsupported_bound. Neue Käufe brauchen das aktivierte Serverflag, den aktuellen quoteHash, ausreichende maxEstimatedUsd (höchstens 5) und separate, ausreichende maxEstimatedCredits; bei deaktivierter Ausführung oder bereits eigener UUID sind diese Felder im Schema optional. Preise, Konto, Vorgang/Parameter und Zulassungstag in America/New_York werden erneut geprüft; konservative Reservierungen werden gesperrt und private untergeordnete UUIDs vor Anbieterarbeit dauerhaft zugeordnet. USD 5/Tag gilt nur für diesen Wrapper, nicht für andere Kontoausgaben: operative Zulassungskontrolle, keine Abrechnungsgarantie. Externe UUID wiederverwenden: geänderte Angaben ergeben 409; eigene Arbeit wird nie wiederholt. Unklare Ergebnisse halten Reservierungen über Mitternacht; Überschreitungen sperren neue Arbeit. Reconcile akzeptiert nur locationId/requestId/mode und gleicht gespeicherte Originalbelege/Credits ab: keine Käufe, Übernahme, Wiederholung oder Neueinreichung. GET mit dieser UUID abfragen. Neue Käufe brauchen außerdem SYNUP_SEO_PILOT_BUDGET_EXPIRES_AT_MS: endliche positive sichere Ganzzahl in Millisekunden, höchstens 1795119917687 (2026-11-19T20:25:17.687Z); der Endzeitpunkt selbst ist ausgeschlossen. Fehlende, ungültige oder spätere Fristen deaktivieren neue Ausführung. Die Frist wird unter der Reservierungssperre und direkt vor Anbieteraufruf geprüft; eigene Lesezugriffe, Abgleiche und Abrechnungen bleiben danach verfügbar.

post/api/v1/seo/website-keywords/research-budget
seo:write
Antwort
dataobjecterforderlich
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
409Die Anfrage steht im Widerspruch zum aktuellen Zustand der Ressource — zum Beispiel beim Ändern der E-Mail-Adresse oder Telefonnummer eines Empfängers, dem bereits eine Nachricht gesendet wurde, oder bei einer Team-Einladung, die bereits akzeptiert wurde (oder noch nicht akzeptiert wurde).
422Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
503Der Dienst ist vorübergehend nicht verfügbar. Befolgen Sie die Hinweise zur Wiederholung für diesen Vorgang.
post/api/v1/seo/website-keywords/research-budget
Ihr API-Schlüssel
Anfragetext
{}

Anleitungen, die diese Ressource verwenden