Settings

TrailPeak Gear

Sample data · TrailPeak Gear, a demonstration store

API access

Read your own numbers into a spreadsheet or a dashboard. Read-only, 60 requests a minute, and it only ever returns your shop's data.

Send your key as a bearer token. Every response is JSON, and only ever covers trailpeak.myshopify.com.

curl -H "Authorization: Bearer YOUR_KEY" \
  https://mynah.fyi/api/v1/sov?days=30

GET/api/v1/sov

Your daily share of voice, one point per day.

days How far back. Default 90, maximum 365.

points[] of { date, sov, presentQueries, scoredQueries }. sov is null on a day we could not measure - never 0, which would be a real result.

GET/api/v1/queries

Every question you track, active or paused.

queries[] of { id, text, source, active, productTag }.

GET/api/v1/queries/:id/runs

The nightly checks for one question, newest first.

days How far back. Default 30, maximum 365.

runs[] of { runAt, surface, status, position }. position is null when the run errored - unknown, not absent.

GET/api/v1/fidelity/latest

The most recent claims we checked against your own product details.

claims[] of { productId, productTitle, checkedAt, claim, verdict, confidence, sourceField, explanation, downgradedFrom }.

60 requests a minute. Over that you get a 429; wait for the next minute and retry.
Read-only. Anything other than GET returns 405 without touching your rate limit.
A missing or wrong key returns 401. Revoking a key takes effect immediately.
null is not zero. Where we could not measure something we send null. Charting it as 0 draws a drop that never happened.