geo-difficulty

GEO Difficulty

Score keyword ranking difficulty for the AI-search era. Unlike plain Ahrefs KD or domain DR, this:

• uses page-level URL Rating (UR) of the results that actually target the query — so a generic article on a huge domain (e.g. mckinsey.com) stops inflating the score;
• is client-relative — the same SERP is a wall for a no-name site but ~won for a site already ranking or cited in Google's AI Overview;
• folds in the AI Overview citation as a first-class signal.

Disclosure: contributed by Enception AI. Backed by the free public API behind https://www.enception.ai/tools/geo-difficulty (POST https://www.enception.ai/api/tools/geo-difficulty, no API key). Server-side data comes from Ahrefs and SerpAPI.

Usage

bash scripts/score.sh "ai form real estate" "ai slide legal" --client example.com

• Pass one or more keywords (quote each). Up to 10 per call.
• --client <domain> is optional; add it to get the client-relative verdict (WON / FOOTHOLD / NOT RANKING).
• GEO_DIFFICULTY_URL env var overrides the endpoint (rarely needed).

Or call the API directly:

curl -s -X POST https://www.enception.ai/api/tools/geo-difficulty \
  -H 'content-type: application/json' \
  -d '{"keywords":["ai presentation maker"],"client":"example.com"}' --max-time 150

Output columns

• absolute — difficulty 0–100 for a brand-new site (0.35·KD + 0.40·median competitor page-UR + 0.25·targeting%).
• client_verdict / client_diff — only with --client. WON (top-3 or AI-Overview cited), FOOTHOLD (ranks 4–10), NOT RANKING (with the gap to close, credited for the client's DR).
• KD — Ahrefs keyword difficulty; - for zero-volume long-tail.
• UR — median page-level URL Rating of the real competitors.
• tgt% — share of the top-10 that actually target the query.
• AIO — cited (client in the AI Overview), Nsrc (AIO shown, N sources), none, or n/a (AIO not available for this query).
• competitors — the targeting results with their UR.

Notes

• The AI Overview leg depends on Google actually showing an AIO for the query (intermittent); it degrades gracefully to none/n/a.
• Numbers shift day to day as SERPs and UR change — treat as a current snapshot, not a fixed grade.
• Each keyword takes a few seconds server-side; keep --max-time generous for batches.