GEO-analüüs

Käivita domeeni täielik GEO/SEO-analüüs ja saa kliendile valmis PDF-aruanne: AI-nähtavus (kas brändi soovitavad ChatGPT / Google AI), sügav turu-uuring ja konkurentsimaastik.

Õhuke ümbris Enceptioni kliendianalüüsi API ümber. Kolm toimingut: start, status, report (pluss valikuline brändinime korrigeerimine).

Avalikustamine: panustanud Enception AI ja kutsub Enceptioni tasulist välist API-d. Dokumentatsioon: https://www.enception.ai/doc/api-client-analysis

Nõuded

• ENCEPTION_ANALYSIS_API_KEY — saadetakse päisena x-api-key. Ise teenindus: registreeru aadressil https://www.enception.ai, seejärel loo tasuta taseme võti jaotises Account → API Key (2 analüüsi kuus tasuta; suuremate limiitide jaoks võta ühendust meeskonnaga). Kiirusepiirang: 10 päringut minutis.

1. Start

POST https://www.enception.ai/api/external/client-analysis/start

Kohustuslik: website_url, primary_region, core_goals. Mõistlikud vaikeväärtused: primary_region=us, core_goals=traffic, output_language=en, competitors=[]. API normaliseerib URL-id tavaliseks domeeniks ja lükkab IP-d tagasi. Tagastab { id, message } — salvesta id.

Vali output_language kõigepealt selgesõnalisest soovist, seejärel kasutaja vestluskeelest, seejärel domeeni TLD-st (.cn → zh; muul juhul en).

curl -s -X POST "https://www.enception.ai/api/external/client-analysis/start" \
  -H "x-api-key: $ENCEPTION_ANALYSIS_API_KEY" -H "Content-Type: application/json" \
  -d '{"website_url":"https://example.com/","primary_region":"us","competitors":[],"core_goals":"traffic","output_language":"en"}'

Muuda primary_region / core_goals / competitors ainult siis, kui kasutaja seda täpsustab. core_goals on vaba tekst (nt traffic, ranking). Konkurendid: [{"name":"X","domain":"x.com"}, ...] (max 5). Mitme domeeni korral tee igaühele üks POST ja kogu id-d kokku.

2. Status

POST https://www.enception.ai/api/external/client-analysis/status kehaga { "id": "<id>" } ja sama x-api-key päisega. Tagastab { status: 'pending' | 'failed' | 'succeeded', progress_percent?, pdf_url? }.

Täielik jooks võtab ~20–45 minutit — pudelikael on sügava turu-uuringu samm. Küsi staatust pika intervalliga (minutites, mitte sekundites). succeeded ⇒ aruanne on valmis allalaadimiseks. Kui jooks ebaõnnestub või jääb lõputult seisma, teata sellest kasutajale, ära leiuta tulemusi.

3. Report

GET https://www.enception.ai/api/external/client-analysis/report/<id> — avalik, autentimist ei vaja; jagatav id järgi. Töötab, kui staatus on succeeded (serveerib ka osalisi jookse).

curl -s -o geo-analysis-example.pdf \
  "https://www.enception.ai/api/external/client-analysis/report/<id>"

Kinnita, et tegu on päris PDF-iga (file geo-analysis-example.pdf), seejärel anna kasutajale fail ja/või avalik URL.

4. Paranda „nullnähtavus“ (brändinime korrigeerimine)

POST https://www.enception.ai/api/external/client-analysis/update-brand kehaga { "id", "brand_name"?, "alternative_names": [...] } ja x-api-key päisega.

Kui aruanne näitab null- või madalat AI-nähtavust, aga brändi SIISKI soovitavad ChatGPT/Google, on peaaegu alati põhjuseks see, et bränd on tuntud ainult kokkusulatatud domeenisildina (nt pudurobotics), samas kui AI-mootorid ütlevad „Pudu Robotics“. Anna päris nimi + aliased ja marsruut arvutab nähtavuse juba salvestatud vastustest uuesti (uut päringut ei tehta — kiire), seejärel laadi aruanne uuesti.

curl -s -X POST "https://www.enception.ai/api/external/client-analysis/update-brand" \
  -H "x-api-key: $ENCEPTION_ANALYSIS_API_KEY" -H "Content-Type: application/json" \
  -d '{"id":"<id>","brand_name":"Pudu Robotics","alternative_names":["Pudu","PuduBot"]}'

Tagastab { success, mention_rate, overall_score, average_position, analysis_regenerated }. Uued analüüsid lahendavad brändinime automaatselt; see on olemasolevate aruannete käsitsi korrigeerimise tee.