Skip to main content
GET
/
usage
Get My Usage
curl --request GET \
  --url https://api.zinc.com/usage \
  --header 'Authorization: <api-key>'
import requests

url = "https://api.zinc.com/usage"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.zinc.com/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.zinc.com/usage",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);

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

curl_close($curl);

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

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://api.zinc.com/usage"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("Authorization", "<api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.zinc.com/usage")
.header("Authorization", "<api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.zinc.com/usage")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body
{
  "window_days": 123,
  "since": "<string>",
  "metrics": {},
  "recent": [
    {
      "endpoint": "<string>",
      "at": "<string>",
      "query": "<string>",
      "result_count": 123,
      "retailer": "<string>",
      "product_id": "<string>"
    }
  ]
}
{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}
Retrieve your own data-API usage over a trailing window, broken down per endpoint.
Use this endpoint to monitor your request volume and track usage against your plan limits.

Authorizations

Authorization
string
header
required

Zinc API key (Bearer zn_...)

Headers

authorization
string | null

Query Parameters

window_days
integer
default:30

Trailing window in days (max 90).

Required range: 1 <= x <= 90
recent
integer
default:50

How many recent calls to return.

Required range: 0 <= x <= 200

Response

Successful Response

window_days
integer
required
since
string
required
metrics
Metrics · object
required
recent
RecentCall · object[]
required