Developers

Your AI visibility data, in your own tools

Pull your AI visibility metrics into any dashboard with the REST API, or run the same GEO scanner in your own code with the open-source threadly-geo package.

  • Bearer-key auth

    Keys start with thly_, are hashed at rest and revocable anytime.

  • 120 requests an hour

    Per workspace, with Retry-After on limits.

  • Open source on npm

    threadly-geo: library and CLI, Node 18+, MIT.

  • Your own AI keys

    Scans run on your OpenAI, Anthropic and Gemini accounts.

terminal
curl https://www.gothreadly.live/api/v1/summary \
  -H "Authorization: Bearer thly_your_key"

{
  "brand": { "name": "Acme", "domain": "acme.io", "competitors": [...] },
  "latestRun": { "id": "run_...", "queryCount": 25, "providerStatus": {...} },
  "metrics": {
    "mentionRate": 48, "citationShare": 22,
    "shareOfVoice": 31, "avgPosition": 2.4, "perProvider": {...}
  }
}

Your workspace's latest visibility metrics, for dashboards and reports.

REST API

Create a key in Settings, API access. It opens after your first credit pack.

  • GET/api/v1/summary

    Brand, competitors, latest scan run and headline metrics: mention rate, citation share, share of voice, average position, per provider.

Read the API reference →

threadly-geo package

Open source on npm. Node 18+, zero dependencies, bring your own AI keys.

  • scanAll({ query, brand, providers?, keys? })

    Scan every provider and roll up the metrics.

  • scanQuery({ provider, query, brand, apiKey?, model? })

    One provider: chatgpt, claude or gemini.

  • analyzeAnswer(provider, { answer, citations }, brand)

    Mention, citation and position analysis of any answer text.

View on npm ↗