Méthodes d’Optimizer

Les demandes d’API liées aux méthodes Optimizer ne consomment généralement aucun crédit de votre compte Toolbox.

Rappelons que l’API est disponible à partir du forfait Plus, grâce auquel vous aurez accès aux données de l’Indice de Visibilité. Avec les forfaits Professionnel ou Premium, vous pourrez utiliser toutes les méthodes de l’API SISTRIX.

optimizer.projects

Cette méthode permet d’obtenir l’ID des projets et les noms des projets existants dans l’Optimizer. Aucun crédit ne sera facturé pour cette demande.

Paramètre requis : api_key

https://api.sistrix.com/optimizer.projects?api_key=$key

optimizer.project

Cette méthode fournit des informations sur un projet Optimizer et sur les balises existantes. Ici, le hachage du projet (qui peut être demandé via la méthode optimizer.projects) sera reporté dans le paramètre « project ». Avec cette requête, aucun crédit n’est utilisé.

Paramètres requis : api_key, project

https://api.sistrix.com/optimizer.project?api_key=$key&project=$hash

optimizer.ranking

Cette méthode permet d’obtenir les mots-clés et les classements existants pour un projet Optimizer. L’ID du projet doit être saisi dans le paramètre « project ». Avec le paramètre « limit », vous pouvez réduire la quantité de résultats (par défaut 100 seront signalés). Grâce au paramètre « tag » vous pouvez filtrer les mots-clés en fonction d’un tag existant.

Cette requête vous permettra également d’obtenir de nombreuses informations complémentaires relatives à l’appareil, au moteur de recherche et au pays sélectionné. Les balises seront séparées par le symbole « | ».

Paramètres requis : api_key, project
Paramètres optionnels : limit, offset, tag

https://api.sistrix.com/optimizer.ranking?api_key=$key&project=$hash

optimizer.visibility

Cette méthode peut être utilisée pour accéder à l’Indice de Visibilité pour un projet Optimizer spécifique. L’ID du projet sera saisi dans le paramètre « project ». Grâce au paramètre « date », il sera possible d’obtenir une valeur transmise, tandis qu’en utilisant « tag », vous pourrez filtrer l’Indice de Visibilité du projet en fonction de balises. En réglant le paramètre « competitors » sur « true », vous aurez un aperçu des concurrents sélectionnés dans le projet.

Paramètres requis : api_key, project
Paramètres optionnels : date, tag, competitors

https://api.sistrix.com/optimizer.visibility?api_key=$key&project=$hash

optimizer.keyword.serps

Cette méthode fournit les SERP pour les mots-clés saisis dans l’Optimizer. L’ID du projet sera saisi dans le paramètre « project ». Vous pourrez également affiner la recherche en filtrant par pays, ville, type d’appareil et moteur de recherche. C’est une fonction utile si vous avez plus d’un mot-clé avec le même nom : sans les filtres précédents, l’API fournira uniquement le premier mot-clé trouvé par défaut.
Vous pouvez également utiliser le paramètre « date » pour obtenir les données passées et « num » pour limiter le nombre de résultats que vous souhaitez obtenir.

Paramètres requis : api_key, project, kw
Paramètres optionnels : country, city, device, searchengine, date, num

https://api.sistrix.com/optimizer.keyword.serps?api_key=$key&project=$hash&kw=$keyword

optimizer.onpage.overview

Cette méthode fournit toutes les données disponibles liées à l’analyse Onpage, y compris l’heure, le nombre de pages analysées, les erreurs, les avertissements et les remarques.

Paramètres requis : api_key, project

https://api.sistrix.com/optimizer.onpage.overview?api_key=$key&project=$hash

optimizer.onpage.crawl

Cette méthode fournit tous les résultats d’une analyse Onpage spécifique. Utilisez le paramètre « date » pour récupérer les données d’un précédent crawl. Vous obtiendrez toutes les dates possibles via la requête : optimiser.onpage.overview.

Paramètres requis : api_key, project
Paramètres optionnels : date

https://api.sistrix.com/optimizer.onpage.crawl?api_key=$key&project=$hash

optimizer.onpage.issue

Cette méthode fournit des résultats détaillés pour une analyse Onpage spécifique. Vous pouvez utiliser le paramètre « issue » pour obtenir des valeurs uniques concernant les données obtenues via la requête optimizer.onpage.crawl. Grâce au paramètre « date », vous pourrez accéder aux résultats des crawls précédents.

Paramètres requis : api_key, project, issue
Paramètres optionnels : date, limit, offset

https://api.sistrix.com/optimizer.onpage.issue?api_key=$key&project=$hash&issue=$issue

optimizer.start.onpage.check

Avec cette méthode, vous pouvez lancer un crawl Onpage pour un projet Optimizer via l’API. Le crawl est alors effectué comme s’il avait été lancé manuellement depuis le frontend de SISTRIX. Les requêtes URL utilisées sont déduites du contingent du compte SISTRIX.

Paramètres requis : api_key, project

https://api.sistrix.com/optimizer.start.onpage.check?project=[PROJECT]&api_key=[API_KEY]

optimizer.competitors

Cette méthode permet d’obtenir les concurrents du domaine sur la base de l’ensemble des mots-clés saisis. En plus du nom de domaine, le degré de correspondance (0-100) est également fourni. Le nombre de domaines renvoyés peut être réduit avec le paramètre « num » ; si rien n’est spécifié, 100 résultats sont renvoyés.

Paramètres requis : api_key, project

https://api.sistrix.com/optimizer.competitors?api_key=[API_KEY]&project=[PROJECT]

optimizer.project.urls

Cette méthode vous fournit toutes les pages HTML crawlées du projet. Elle correspond au tableau « URL » dans Onpage > Expert Mode sur le frontend de SISTRIX. En plus de l’URL, les autres champs du tableau (tels que la taille du fichier, la balise titre et autres) sont également fournis.

Paramètres requis : api_key, project

https://api.sistrix.com/optimizer.project.urls?api_key=[API_KEY]&project=[PROJECT]

optimizer.project.links

Cette méthode vous fournit tous les liens trouvés du projet. Cela inclut les liens internes et externes. Elle correspond au tableau « Liens » dans Onpage > Mode expert sur le frontend de SISTRIX.

Paramètres requis : api_key, project

https://api.sistrix.com/optimizer.project.links?api_key=[API_KEY]&project=[PROJECT]

optimizer.project.resources

Cette méthode vous fournit toutes les ressources trouvées (images, fichiers javascript et CSS) du projet. Elle correspond au tableau « Ressources » dans Onpage > Mode Expert sur le frontend de SISTRIX.

Paramètres requis : api_key, project

https://api.sistrix.com/optimizer.project.resources?api_key=[API_KEY]&project=[PROJECT]

optimizer.project.resources.usage

Cette méthode vous fournit toutes les ressources trouvées (images, fichiers javascript et CSS) du projet. Elle correspond au tableau « Ressources » sous Onpage > Mode Expert sur le frontend de SISTRIX.

Paramètres requis : api_key, project

https://api.sistrix.com/optimizer.project.resources.usage?api_key=[API_KEY]&project=[PROJECT]

optimizer.project.cookies

Cette méthode vous montre quels cookies sont utilisés dans le projet crawlé. Le crawler onpage de SISTRIX collecte tous les cookies que le serveur web veut définir, mais ne fait que les enregistrer et ne les utilise pas. Il correspond au tableau « Cookies » sous Onpage > Expert Mode sur le frontend de SISTRIX.

Paramètres requis : api_key, project

https://api.sistrix.com/optimizer.project.cookies?api_key=[API_KEY]&project=[PROJECT]

optimizer.create.onpage.project

Cette méthode permet de créer un projet Onpage avec des mots-clés. Les limites du forfait choisi seront également prises en compte.

Le paramètre crawl_limit permet de spécifier le nombre maximum d’URLs à explorer dans le projet. L’API permet de sélectionner un maximum de 25 000 pages.

Le nom du projet peut être défini à l’aide du paramètre project_name. Si le paramètre n’est pas ajouté, nous prendrons l’objet du projet comme nom.

Le paramètre frequency permet de définir la fréquence d’exploration du projet. Par défaut, un crawl hebdomadaire est défini, mais vous pouvez choisir la valeur « manuel ». Cette fréquence d’exploration n’affecte que le projet Onpage, et non la mise à jour des SERPs pour les mots-clés.

Jusqu’à 40 mots-clés peuvent être ajoutés via le paramètre keywords. Le format JSON est utilisé pour cela dans l’API.

Paramètres requis : api_key ; domain, host, path ou url

Paramètres optionnels : acknowledge_extra_cost, crawl_limit, project_name, frequency, keywords