Synup
Créer une clé
v1Ressources/SEO/getLire le justificatif attribué du budget de recherche

Lire le justificatif attribué du budget de recherche

Lit la demande d’origine dans le périmètre de l’utilisateur actuel, de l’agence et du pilote fixe du site marketing de Synup. Exige locationId et l’UUID externe requestId. Cet appel n’achète jamais de mesures et ne règle aucun crédit. Les travaux réservés ou dont le résultat est inconnu renvoient leur réservation maintenue ; les travaux réglés ou en dépassement peuvent inclure la mesure exacte enregistrée. Un justificatif absent renvoie 404 et ne lève jamais le blocage d’incertitude du client appelant. Les identifiants d’accès du fournisseur et les identifiants privés des demandes secondaires ne sont pas renvoyés.

get/api/v1/seo/website-keywords/research-budget
seo:read
Paramètres de requête
locationIdstringobligatoire
requestIdstringobligatoire
Réponse
dataobjectobligatoire
requestIdstringobligatoire
currencystring (USD)obligatoire
dailyLimitUsdinteger (5)obligatoire
estimateIsAdmissionOnlyboolean (true)obligatoire
providerBillingGuaranteeboolean (false)obligatoire
operationstring (discovery | volumes | serp)obligatoire
statestring (reserved | unknown | settled | overrun)obligatoire
daystringobligatoire
reservedUsdnumberobligatoire
confirmedSpentUsdnumberobligatoire
measurementsobjectfacultatif
Résultat exact enregistré pour la demande d’origine attribuée à ce traitement. GET le renvoie après règlement ou dépassement. L’absence de résultat ne signifie ni un volume de recherche nul, ni une absence de positionnement, ni une mesure terminée avec succès sans résultat. La structure suit l’API des idées de mots-clés enregistrées ou des mesures par lots.
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
409La requête entre en conflit avec l'état actuel de la ressource — par exemple, modifier l'e-mail ou le téléphone d'un destinataire à qui un message a déjà été envoyé, ou une invitation d'équipe déjà acceptée (ou pas encore acceptée).
422Il manque un paramètre requis à la requête, ou elle est invalide.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
503Le service est temporairement indisponible. Suivez les consignes de nouvelle tentative propres à cette opération.
get/api/v1/seo/website-keywords/research-budget
Votre clé API
locationId *
requestId *
{}

Guides qui utilisent cette ressource