Developers
Avanciq API
Read your results and receive alerts in your own tools. For paying customers. Keys are issued by us, not by sign-up.
Keys
- We send you a key once, by a secure channel. We store only its SHA-256 fingerprint, so we cannot show it again.
- Keys are read-only. Scopes:
read:resultsandread:alerts. - Ask us to rotate or revoke a key at any time. A revoked key stops working within about a minute.
- Limit: 60 requests a minute per key. Over the limit you get
429.
Read your results
curl -H "Authorization: Bearer $AVANCIQ_KEY" \
https://avanciq.com/api/v1/results
Read your alerts
curl -H "Authorization: Bearer $AVANCIQ_KEY" \
"https://avanciq.com/api/v1/alerts?since=2026-11-01"
Answers
200JSON with your rows only.401missing, wrong or revoked key.403the key does not have the scope.429too many requests; wait and try again.
Alert webhooks
We can POST each alert to your HTTPS address. Every call carries a header Avanciq-Signature: t=TIMESTAMP,v1=SIGNATURE, where SIGNATURE is HMAC-SHA256 of TIMESTAMP + "." + body with the webhook secret we gave you. Reject calls older than 5 minutes. Each alert has an id; ignore one you have already handled, because we retry if your server does not answer.
import hmac, hashlib, time
def verify(secret, header, body):
parts = dict(p.split("=", 1) for p in header.split(","))
if abs(time.time() - int(parts["t"])) > 300: return False
mac = hmac.new(secret.encode(), (parts["t"] + "." + body).encode(), hashlib.sha256).hexdigest()
return hmac.compare_digest(mac, parts["v1"])
Private results link
Each customer can also get a private link to a results page. It is long and random, not listed by search engines, and can be set to expire.
Private agents
To test your own agent, you give us an HTTPS endpoint and we generate a token for you to accept. We never ask for your AI provider keys.