L'API de Fasterize permet de récupérer les logs d'accès de votre compte pour les sept derniers jours au format JSON ou Apache.


Vous trouverez le token d’API sur votre dashboard et l’identifiant de votre configuration dans l’URL du dashboard de votre configuration.


L'URL de l'API correspondante aux logs d'accès est https://api.fasterize.com/v1/configs/$config_id/logs.


La fenêtre d'extraction est de 15 minutes par défaut.

Paramétrage


Il existe différents paramètres optionnels :


  • from : secondes depuis l'époque unix
  • to : secondes depuis l'époque unix
  • domain : liste des domaines ciblés
  • onlySeoVisit : filtre les logs des visiteurs en provenance d'un moteur de recherche (Google, Bing, Baidu, Yandex)
  • onlySearchBot : filtre les logs provenant du trafic des bots des moteurs de recherche (Google, Bing, Baidu, Yandex)
  • format : json ou apache


Exemple d'appel à l'API


# Récupérer les logs des quinze dernières minutes

curl "https://api.fasterize.com/v1/configs/$config_id/logs" -H"Authorization:$myApiToken"


# Récupérer les logs de la veille

from=$(date -d "yesterday 00:00:00" '+%s')

to=$(date -d "yesterday 23:59:59" '+%s')

curl "https://api.fasterize.com/v1/configs/${configID}/logs?from=${from}&to=${to}" -H"Authorization:${token}"


Format de la réponse


Chaque log est constitué des champs suivants :

  • client_ip (adresse IPv4 du client),
  • content_length
  • content_type
  • domain
  • fstrz_flags  (voir la liste des champs)
  • method
  • protocol
  • referer
  • response_time (in msec)
  • status
  • timestamp
  • url
  • user_agent
  • user_agent_class (mobile / desktop_recent / tablet / bot / old)

Exemple :

{
  "client_ip":"217.167.19.73",
  "content_length":40945,
  "content_type":"text/html;charset=UTF-8",
  "domain":"www.nocibe.fr",
  "fstrz_flags":"o",
  "method":"GET",
  "protocol":"http",
  "referer":"",
  "request_id":"42024b74-f79f-4173-91b5-c2c9f236c57d",
  "response_time":1.552,
  "status":"200",
  "timestamp":"2017-04-10T15:38:18.830Z",
  "url":"/giorgio-armani-si-gel-douche-p-206477",
  "user_agent":"Screaming Frog SEO Spider/7.2","user_agent_class":"desktop_recent"
}


Apache Combined Log Format


Le format de logs Apache utilisé est le format combined :


LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""


Ce format est le seul supporté par des outils d'analyse SEO tels que Screaming Frog Log Analyser.