Synup
Criar chave
v1Recursos/SEO/postPreview, execute or reconcile volumes measurement

Preview, execute or reconcile volumes measurement

Exact caller list, including tracked keywords. One result per input reports measured (including zero), no_data, omitted or unsupported. Caller/provider keyword mapping uses case and whitespace normalization only. Search volume is an average monthly estimate; monthlySearches and dataMonth describe the available data period. Close variants may share volume; values must not be added together. Preview does not purchase or persist. Execute requires a stable UUID requestId and maxEstimatedCredits. Same-ID retries reuse saved status without another provider call; changed details return 409. GET never purchases. Reconcile only settles saved delivered receipts; unconfirmed provider outcomes remain held across discovery, volumes and SERP requests. Provider task IDs, costs and billing identities remain private. Existing credit gates apply.

post/api/v1/seo/website-keywords/volumes
seo:write
Resposta
dataobjectopcional
requestIdstringopcional
statusstring (pending | ready | partial | failed | unknown)opcional
keywordsarray of stringopcional
estimatedCreditsnumberopcional
recordedCreditsnumberopcional
Known ledger credits after settlement, with internal/staging exemption applied. Null for unknown or unsettled outcomes; never infer provider USD from credits.
settlementstring (pending | settled | unknown)opcional
generatedAtstringopcional
Record update time; use each observation timestamp for measurement age.
stepsarray of objectopcional
Join keywords against results and steps. Failed or skipped measurements have no result; absence is not zero volume or outside-depth ranking.
keywordsarray of stringopcional
statusstring (queued | submitting | ready | failed | skipped | unknown)opcional
deliveredbooleanopcional
closeVariantsMayShareVolumebooleanopcional
volumesAreAdditivebooleanopcional
keywordMatchingstring (trim_whitespace_case_only)opcional
volumeDefinitionstring (average_monthly_searches)opcional
dataMonthDefinitionstring (latest_monthly_series_entry)opcional
resultsarray of objectopcional
callerKeywordstringopcional
providerKeywordstringopcional
collectedAtstringopcional
statusstring (measured | no_data | omitted | unsupported)opcional
volumenumberopcional
Average monthly estimate; measured zero is different from null.
dataMonthstringopcional
Newest monthlySearches entry, not the single-month basis of volume.
monthlySearchesarray of objectopcional
yearintegeropcional
monthintegeropcional
volumenumberopcional
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.
409Request identity mismatch, concurrent request or pending/unknown research hold.
422A valid website or adequate maxEstimatedCredits is required.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
503Measurement or durable credit settlement unavailable. Preserve the requestId and read saved status before retrying.
post/api/v1/seo/website-keywords/volumes
Sua chave de API
{}

Guias que usam este recurso