v1Recursos/SEO/postCotar ou executar pesquisa de palavras-chave com orçamento; conciliar comprovantes salvos

Cotar ou executar pesquisa de palavras-chave com orçamento; conciliar comprovantes salvos

Somente para o piloto fixo do site de marketing da Synup. A prévia consulta gratuitamente preços da conta e dados/créditos salvos; não compra nem reserva fundos. Configuração ausente, tarifas incompatíveis ou conta/preços/saldo não verificados retornam unsupported_bound. Compras exigem a opção do servidor ativada, quoteHash atual, maxEstimatedUsd suficiente (máximo 5) e maxEstimatedCredits separado e suficiente; os campos são opcionais no esquema com execução desativada ou UUID já própria. Preços, conta, operação/parâmetros e dia de admissão America/New_York são revalidados; reservas conservadoras ficam bloqueadas e a UUID filha privada é registrada antes da chamada ao provedor. USD 5/dia cobre só este wrapper, não outros gastos: controle operacional de admissão, sem garantia de cobrança. Reutilize a UUID externa: detalhes diferentes retornam 409; trabalho próprio nunca é repetido. Resultados incertos mantêm a reserva após meia-noite; excessos bloqueiam novo trabalho. Reconcile aceita apenas locationId/requestId/mode e liquida recibos/créditos originais salvos: sem compras, adoção, novas tentativas ou reenvios. Consulte GET com essa UUID. Compras também exigem SYNUP_SEO_PILOT_BUDGET_EXPIRES_AT_MS: inteiro seguro positivo e finito em milissegundos, no máximo 1795119917687 (2026-11-19T20:25:17.687Z), com prazo exclusivo. Valor ausente, inválido ou posterior desativa nova execução. Verificação sob o bloqueio da reserva e imediatamente antes da chamada ao provedor; leituras, conciliação e liquidação próprias continuam após o prazo.

post/api/v1/seo/website-keywords/research-budget
seo:write
Resposta
dataobjectobrigatório
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
409A solicitação entra em conflito com o estado atual do recurso — por exemplo, alterar o e-mail ou telefone de um destinatário que já recebeu uma mensagem, ou um convite de equipe que já foi aceito (ou que ainda não foi aceito).
422Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
503O serviço está temporariamente indisponível. Siga as orientações de nova tentativa para esta operação.
post/api/v1/seo/website-keywords/research-budget
Sua chave de API
Corpo da solicitação
{}

Guias que usam este recurso