Rank tracking API, by country and language

curl "https://api.metrik.example/v1/rankings?site=example.com&market=de-DE&date=2026-10-02" \
  -H "Authorization: Bearer $METRIK_API_KEY"

// Node 18 or later, as an ES module: fetch is built in
const params = new URLSearchParams({ site: 'example.com', market: 'de-DE', date: '2026-10-02' });

const res = await fetch(`https://api.metrik.example/v1/rankings?${params}`, {
  headers: { Authorization: `Bearer ${process.env.METRIK_API_KEY}` },
});
if (!res.ok) throw new Error(`Metrik API error ${res.status}`);

const { data } = await res.json();
for (const row of data) console.log(row.keyword, row.position, row.change);

{
  "site": "example.com",
  "market": "de-DE",
  "date": "2026-10-02",
  "data": [
    {
      "keyword": "wanderschuhe damen",
      "position": 4,
      "change": 2,
      "url": "https://example.com/de/wanderschuhe-damen/",
      "ai_cited": true
    },
    {
      "keyword": "regenjacke herren",
      "position": 11,
      "change": -3,
      "url": "https://example.com/de/regenjacken/",
      "ai_cited": false
    }
  ],
  "next_cursor": null
}

curl https://api.metrik.example/v1/webhooks \
  -H "Authorization: Bearer $METRIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/hooks/metrik", "events": ["ranking.changed", "citation.lost"]}'

{
  "id": "evt_01J9ZK4T7Q",
  "type": "ranking.changed",
  "created": "2026-10-03T06:12:09Z",
  "data": {
    "site": "example.com",
    "market": "fr-FR",
    "keyword": "chaussures de randonnée",
    "position": 3,
    "previous_position": 7,
    "url": "https://example.com/fr/chaussures-randonnee/"
  }
}

import crypto from 'node:crypto';

// rawBody: the request body exactly as received (Buffer or string)
// signature: the value of the Metrik-Signature header
export function verifyWebhook(rawBody, signature, secret) {
  const expected = crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
  const a = Buffer.from(expected);
  const b = Buffer.from(String(signature ?? ''));
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}