v1Recursos/SEO/postCotizar o ejecutar investigación de palabras clave con presupuesto; conciliar comprobantes guardados

Cotizar o ejecutar investigación de palabras clave con presupuesto; conciliar comprobantes guardados

Solo para el piloto fijo del sitio de marketing de Synup. La vista previa consulta gratis los precios de la cuenta y datos/créditos guardados; no compra ni reserva fondos. Configuración ausente, tarifas incompatibles o cuenta/precios/saldo sin verificar devuelven unsupported_bound. Cada compra exige la opción del servidor activada, quoteHash actual, maxEstimatedUsd suficiente (máximo 5) y maxEstimatedCredits separado y suficiente; estos campos son opcionales en el esquema para ejecución desactivada o una UUID ya propia. Se revalidan precios, cuenta, operación/parámetros y día de admisión America/New_York; las reservas conservadoras se bloquean y la UUID hija privada se registra antes de llamar al proveedor. USD 5/día cubre solo este wrapper, no otros gastos: control operativo de admisión, no garantía de facturación. Reutilice la UUID externa: datos distintos dan 409; el trabajo propio nunca se repite. Resultados inciertos mantienen la reserva tras medianoche; excesos bloquean nuevas tareas. Reconcile solo acepta locationId/requestId/mode y liquida recibos/créditos originales guardados: sin compras, adopción, reintentos ni reenvíos. Consulte GET con esa UUID. Nuevas compras también exigen SYNUP_SEO_PILOT_BUDGET_EXPIRES_AT_MS: entero seguro positivo y finito en milisegundos, como máximo 1795119917687 (2026-11-19T20:25:17.687Z), con vencimiento exclusivo. Si falta, es inválido o posterior, se desactiva la ejecución nueva. Se comprueba bajo el bloqueo de reserva y justo antes de invocar al proveedor; lecturas, conciliación y liquidación propias siguen disponibles después.

post/api/v1/seo/website-keywords/research-budget
seo:write
Respuesta
dataobjectobligatorio
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
409La solicitud entra en conflicto con el estado actual del recurso — por ejemplo, cambiar el correo electrónico o el teléfono de un destinatario al que ya se le ha enviado un mensaje, o una invitación de equipo que ya fue aceptada (o que aún no ha sido aceptada).
422A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
503El servicio no está disponible temporalmente. Siga las indicaciones de reintento para esta operación.
post/api/v1/seo/website-keywords/research-budget
Su clave de API
Cuerpo de la solicitud
{}

Guías que usan este recurso