API Endpoints

HypeAuditor For Instagram

Endpoint

Get metrics history of an Instagram account

GET https://hypeauditor.com/api/method/auditor.instagramHistory/?username={username}

Username is Instagram username from the url of Instagram account (https://www.instagram.com/<username>). Returns the metrics history if it’s ready.

📘

Note:

  • By requesting Metrics History, user UNLOCKS report (auditor.report method).
  • Disclaimer: HypeAuditor only provides historical data from the moment when the account to be searched was added to our database.

Response Object

AttributesType
metrics_historyobjectMetrics history data

Metrics History Object

Contains er metrics history.

AttributesType
historyarrayarray of {value: float, timestamp: int} objects. Time is unix timestamp.

Requests

Set YOUR_ID and YOUR_TOKEN from HypeAuditor.

curl -X GET \
  https://hypeauditor.com/api/method/auditor.instagramHistory?username=<username> \
  -H 'x-auth-id: %YOUR_ID%' \
  -H 'x-auth-token: %YOUR_TOKEN%' \
<?php
$curl = curl_init();
curl_setopt_array($curl, [
   CURLOPT_URL => 'https://hypeauditor.com/api/method/auditor.instagramHistory?username=<username>',
   CURLOPT_CUSTOMREQUEST => 'GET',
   CURLOPT_HTTPHEADER => [
       'x-auth-id: YOUR_ID',
       'x-auth-token: YOUR_TOKEN'
   ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
   echo 'cURL Error #:' . $err;
} else {
   echo $response;
}

Sample request

GET https://hypeauditor.com/api/method/auditor.instagramHistory/?username=<username>

Sample response

{
    "result": {
        "metrics_history": {
            "er": {
                "history": [
                    {
                        "value": 0.82,
                        "timestamp": 1676505600
                    },
                    {
                        "value": 0.82,
                        "timestamp": 1676419200
                    },
                    ...
                ]
            },
        },
        "restTokens": 6
    }
}