Dla programistów i agencji

API CitationOne

Uruchamiaj audyty programatycznie i pobieraj wynik jako JSON. Ten sam silnik, który liczy raporty w panelu - tylko wpięty w Twój workflow, CMS albo dashboard klienta.

Dokumentacja APIWersja Markdown dla agentów
REST · JSON · api/v1
# 1. Zleć audyt
curl -X POST https://app.citationone.com/api/v1/audits \
  -H "Authorization: Bearer co_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/artykul", "keyword": "fraza kluczowa" }'

# 202 { "id": "job_V1StGXR8", "status": "queued" }

# 2. Odbierz wynik
curl https://app.citationone.com/api/v1/audits/job_V1StGXR8 \
  -H "Authorization: Bearer co_live_..."

# Albo pomiń krok 2: podaj "webhookUrl" przy zleceniu,
# a wynik wyślemy POST-em, podpisany HMAC-SHA256.

Klucz API zamiast logowania

Nagłówek Authorization: Bearer. Klucz tworzysz i cofasz w panelu, pokazywany jest raz - w bazie trzymamy wyłącznie jego hash.

Model asynchroniczny

POST zwraca 202 z identyfikatorem zadania i nie blokuje połączenia. Audyt liczy się w tle, wynik odbierasz przez GET.

Webhooki zamiast odpytywania

Podaj webhookUrl, a wynik przyjdzie do Ciebie POST-em - podpisany HMAC-SHA256. Błędy też są wysyłane, a paczka daje osobne zdarzenie per audyt.

Audyt treści przed publikacją

Zamiast url wyślij content (50-200 000 znaków) i zaudytuj szkic, przeredagowany tekst albo copy dla strony, której jeszcze nie ma. Te same wymiary, ten sam 1 kredyt.

Pełny wynik jako JSON

CQS, AI Citability, 10 wymiarów z problemami, E-E-A-T, rekomendacje Przed i Po, benchmark SERP i pokrycie Fan-Out.

Zlecenia masowe

Do 50 adresów jednym żądaniem. Kolejka po stronie serwera, jedno zbiorcze zapytanie o dane fraz, status i anulowanie paczki.

Publiczny link do raportu

Opcjonalnie audyt dostaje adres read-only, który wyślesz klientowi bez zakładania mu konta. Z terminem ważności albo bezterminowo.

Rozliczenie w kredytach

Jeden audyt z API kosztuje 1 kredyt - dokładnie tyle samo, co audyt zlecony w panelu. Bez osobnego abonamentu; saldo i historię czytasz z GET /credits/usage.

Dokumentacja czytelna dla agentów AI

Ta sama dokumentacja jest wystawiona jako czysty Markdown pod adresem /api-docs.md. Wskaż ten adres asystentowi (Claude, ChatGPT, Cursor), a dostanie kontrakt API bez zdzierania layoutu ze strony HTML - z zachowanymi tabelami i blokami kodu. Obie wersje powstają z jednego źródła, więc nie da się ich rozjechać.

https://app.citationone.com/api-docs.md

Dokumentacja jest po angielsku - razem z opisami pól i przykładami.

Klucze API tworzysz w panelu, w zakładce dla programistów. Pierwsze 3 audyty są darmowe - również przez API.

Utwórz klucz API