Live Β· 5 endpoint Β· 6 dil Β· 35+ pazar

AVI API : AVI GBP Koclugunu entegre edin

Basit JSON istekleriyle platformunuza baglamsal GBP koclugu, proaktif ipuclari ve rakip zekasi ekleyin.

Endpointler

POST/chat

AVI Solo & Agency koclugu : gercek profil verisine dayanan baglamsal GBP tavsiyesi

Auth : X-AVI-Key basligi

Istek ornegi
{
  "profile_id": 583,
  "key": "avi_xxx",
  "query": "What should I fix first?",
  "lang": "en",
  "user_type": "solo",
  "intent": "chat"
}
Yanit
{
  "reply": "Your score is 42/100. Priority: publish a post this week (+5 pts), reply to 2 unanswered reviews (+6 pts).",
  "lang": "en"
}

Agency mode : add agency_id for fleet-level Companion & Predictive context:

Istek ornegi Agency
{
  "profile_id": 610,
  "key": "avi_agency_xxx",
  "query": "How is my fleet performing?",
  "lang": "en",
  "user_type": "agency",
  "agency_id": 32,
  "intent": "chat"
}
Yanit Agency
{
  "reply": "Fleet avg score: 54/100. 6 at-risk clients detected. Predicted score J+7: 58 pts if you publish bulk posts this week.",
  "lang": "en"
}
ℹ️ agency_id enables fleet-level AVI context:
β†’ Companion context: AVI remembers your agency goals, detects fleet posting streaks and weekly challenges per client
β†’ Predictive context: AVI calculates 7-day score trend (MA7/MA14) for your entire fleet, identifies which clients are at risk of score drop and names them
β†’ Competitor context: AVI names the top competitors threatening your fleet and how many clients they target
Without agency_id, /chat uses individual profile context only : even with user_type=agency.
⚑ No LLM call β€” sub-100ms response
GET/proactive-hint/{profile_id}

Belirleyici proaktif ipucu : LLM cagrisi yok, profil sinyallerine gore aninda yanit

Auth : X-AVI-Key basligi

Query parametreleri : lang (varsayilan: fr)

Yanit
{
  "hint": "Your last GBP post is over 7 days old : publish this week to recover +5 pts.",
  "trigger_key": "stale_post",
  "lang": "en"
}

Tetikleyici anahtarlar : stale_post | avis_sans_reponse | score<40 | guardian | score_gap

curl https://avision.org/api/v1/avi/proactive-hint/583 \
  -H "X-AVI-Key: YOUR_API_KEY"

Response:

{
  "hint": "Your last GBP post is over 7 days old β€” publish this week to recover +5 pts.",
  "trigger_key": "stale_post",
  "urgency": "medium",
  "lang": "en"
}
GET/proactive-hint-agency/{agency_id}

Filo proaktif ipucu : riskli musterileri tespit eder ve isimlendirir

Auth : X-AVI-Key basligi

Yanit
{
  "hint": "6 at-risk clients: Anthony Verrons, Chamane Guerisseuse, Pura Veda Paris : check their score.",
  "trigger_key": "clients_at_risk",
  "lang": "en"
}
POST/avi-marketing

Herkese acik pazarlama asistani : landing sayfalarinda ziyaretci sorularina yanit (auth yok)

Auth : Yok (IP basina gunde 20 istek)

Istek ornegi
{
  "query": "How much does Solo cost?",
  "lang": "en",
  "page_context": "localedge-local"
}
Yanit
{
  "reply": "Solo is $49 one-time. Optional add-ons: Guardian $4.90/mo, Pro $9.90/mo.",
  "cta": {"text": "Try Solo free", "url": "/localedge-local/en/"},
  "lang": "en"
}
POST/citations/detect

NAP alinti tespiti : yerel dizinlerde isletme bahislerini bulur

Auth : X-AVI-Key basligi

Istek ornegi
{
  "profile_id": 583,
  "business_name": "My Business",
  "city": "London",
  "country": "GB",
  "lang": "en",
  "category": "restaurant"
}
Yanit
{
  "status": "started",
  "profile_id": 583
}

Not : asenkron is. Sonuclar icin /citations/detect/status/{profile_id} yoklayin.

Error Codes

CodeMeaningAction
401Invalid or missing AVI API keyCheck X-AVI-Key header
403Credits exhaustedTop up via dashboard or upgrade plan
422Missing profile_id or queryCheck required fields
429Rate limit exceededMax 30 requests/min per key
500AVI engine errorRetry after 30s

Kimlik dogrulama

curl -X POST https://YOUR_AVI_HOST/chat \
  -H "X-AVI-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"profile_id":583,"query":"What should I fix first?","lang":"en","user_type":"solo"}'

Expected response (200):

{
  "response": "Your last post is 12 days old β€” publish one this week to recover +5 pts on your GBP score.",
  "intent": "score_coach",
  "lang": "en",
  "credits_used": 1,
  "credits_remaining": 49
}
πŸ§ͺ
Sandbox mode

Test without a real GBP profile. Use profile_id: 999999 and key: test_sandbox_999999 β€” returns simulated data instantly.

curl -X POST https://avision.org/api/v1/avi/proactive-hint/999999 \
  -H "X-AVI-Key: test_sandbox_999999"

AVI API Pricing

Start free. Scale when you need. No credit card required.

Free
$0
forever
  • βœ… 50 calls/month
  • βœ… /chat + /proactive-hint
  • βœ… 6 languages
  • βœ… Test all endpoints
Start free
Starter
$19/mo
billed monthly
  • βœ… 500 calls/month
  • βœ… All 5 endpoints
  • βœ… 6 languages Β· 35+ markets
  • βœ… Support < 48h
Get started
POPULAR
Pro
$49/mo
billed monthly
  • βœ… 2 000 calls/month
  • βœ… All endpoints + webhooks
  • βœ… Priority dispatch < 5min
  • βœ… Support < 24h
  • βœ… 90-day logs
Get started
Scale
$99/mo
billed monthly
  • βœ… 10 000 calls/month
  • βœ… White-label responses
  • βœ… SLA 99.9%
  • βœ… Priority support < 8h
  • βœ… Custom context injection
Contact us
Pay as you go Β· $0.05 / call No monthly commitment Β· /proactive-hint = free (deterministic)
Credit usage : /chat = 1 credit Β· /avi-marketing = 1 credit Β· /citations/detect = 5 credits Β· /proactive-hint = 0 credits (free)
🎁 BUNDLE DEAL
Guardian API + AVI API
$39/mo
vs $48 separately Β· save $9/mo Β· Guardian Starter + AVI Starter
Get the bundle

Diller ve pazarlar

  • 6 dil : en, fr, es, de, pt-br, tr
  • Bolge fiyatlama baglamiyla 35+ pazar
  • lang parametresi yanit dilini ve yerel baglami uyarlar (sehir, mevsim, kulturel etkinlikler)

Kullanim senaryolari

🏒
CRM'inize GBP koclugu ekleyin Musteri girisinde /proactive-hint tetikleyin
Client Login β†’ GET /proactive-hint β†’ CRM Alert
πŸ€–
White-label AVI koclugu /chat'i markanizla panelinize gomun
Your Dashboard β†’ POST /chat β†’ AVI Response
⏰
Icerik uyarilarini otomatiklestirin Proaktif ipuclarini cron ile gunluk yoklayin
Daily Cron β†’ GET /proactive-hint β†’ Content Alert

AVI'yi entegre etmeye hazir misiniz?

API anahtarinizi alin