v1Resources/SEO/postQuote or run budgeted keyword research; reconcile saved receipts

Quote or run budgeted keyword research; reconcile saved receipts

Fixed Synup marketing-site pilot only. Preview reads free account pricing and saved data/credits; it buys nothing and reserves no funds. Missing configuration, unsupported tariffs or unverified account/pricing/balance return unsupported_bound. New purchases require the enabled server flag, current quoteHash, sufficient maxEstimatedUsd (at most 5) and sufficient, separate maxEstimatedCredits; admission fields are schema-optional for disabled or already-owned requests. Rates, account, operation/parameters and America/New_York admission day are rechecked; conservative reservations are locked and private child UUIDs durably owned before provider work. USD 5/day covers this wrapper only, not other account spending; it is operational admission control, not a billing guarantee. Reuse the external UUID: changed details return 409; owned work never replays. Unknown outcomes retain holds across midnight; overruns block new work. Reconcile accepts only locationId/requestId/mode and settles saved original receipts/credits: no purchases, adoption, retries or resubmission. Poll GET for that UUID. New purchases also require SYNUP_SEO_PILOT_BUDGET_EXPIRES_AT_MS: finite positive safe-integer milliseconds, no later than 1795119917687 (2026-11-19T20:25:17.687Z), with an exclusive deadline. Missing, invalid or later deadlines disable new execution. Expiry is rechecked under the reservation lock and immediately before provider invocation; owned reads, reconciliation and settlement remain available afterward.

post/api/v1/seo/website-keywords/research-budget
seo:write
Response
dataobjectrequired
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
409The request conflicts with the current state of the resource — for example, changing the email or phone of a recipient who has already been messaged, or a team invite that was already accepted (or hasn't been accepted yet).
422The request is missing a required parameter or is otherwise malformed.
429Too many requests. Retry after the number of seconds in the Retry-After header.
503The service is temporarily unavailable. Follow the retry guidance for this operation.
post/api/v1/seo/website-keywords/research-budget
Your API key
Request body
{}

Guides that use this resource