AI Search Visibility API
AI Search Visibility API
/geo-intel/v1/check1 creditFull AI-readiness report for a URL: AI-crawler access map + llms.txt + schema + meta + 0-100 score + ranked fix recommendations. One call, everything.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| url | required | — | The site to analyse. Accepts a full URL (https://example.com/page) or a bare domain (example.com → https:// assumed). Only http/https; private/internal/metadata targets are SSRF-blocked. Alias: domain. |
| path = / | optional | — | The path to evaluate robots.txt access against (default '/'). Use a real content path (e.g. /blog/post) to test whether AI bots may fetch THAT page. |
| bots | optional | — | Optional subset of AI-bot tokens to report (comma-separated or array). Omit for the full 50+ bot map. Unknown tokens are still checked against robots.txt verbatim. |
| follow_redirects = true | optional | — | Follow redirects (e.g. http→https, apex→www) before analysing the final URL (default true). Each hop is independently SSRF-validated. |
/geo-intel/v1/crawlers1 creditAI-crawler access map from robots.txt: per-bot allow/block (Google longest-match), operator, AI engine, purpose (search/training/agent), crawl-delay, sitemaps.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| url | required | — | The site to analyse. Accepts a full URL (https://example.com/page) or a bare domain (example.com → https:// assumed). Only http/https; private/internal/metadata targets are SSRF-blocked. Alias: domain. |
| path = / | optional | — | The path to evaluate robots.txt access against (default '/'). Use a real content path (e.g. /blog/post) to test whether AI bots may fetch THAT page. |
| bots | optional | — | Optional subset of AI-bot tokens to report (comma-separated or array). Omit for the full 50+ bot map. Unknown tokens are still checked against robots.txt verbatim. |
/geo-intel/v1/llms_txt1 creditDetect + parse + validate /llms.txt (and /llms-full.txt) — the emerging AI-context standard. Content-type sniffed so an HTML 404 can't masquerade as a real file.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| url | required | — | The site to analyse. Accepts a full URL (https://example.com/page) or a bare domain (example.com → https:// assumed). Only http/https; private/internal/metadata targets are SSRF-blocked. Alias: domain. |
/geo-intel/v1/schema1 creditExtract and classify schema.org structured data ( and @graph) for AI citability signals: Organization, Article, FAQ, BreadcrumbList, Product, Speakable — plus microdata and RDFa presence.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| url | required | — | The site to analyse. Accepts a full URL (https://example.com/page) or a bare domain (example.com → https:// assumed). Only http/https; private/internal/metadata targets are SSRF-blocked. Alias: domain. |
| follow_redirects = true | optional | — | Follow redirects (e.g. http→https, apex→www) before analysing the final URL (default true). Each hop is independently SSRF-validated. |
/geo-intel/v1/score1 creditComposite AI-readiness score (0-100) + transparent per-pillar breakdown (crawler_access 40 / structured_data 25 / llms_txt 15 / meta 12 / crawlability 8) + ranked recommendations.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| url | required | — | The site to analyse. Accepts a full URL (https://example.com/page) or a bare domain (example.com → https:// assumed). Only http/https; private/internal/metadata targets are SSRF-blocked. Alias: domain. |
| path = / | optional | — | The path to evaluate robots.txt access against (default '/'). Use a real content path (e.g. /blog/post) to test whether AI bots may fetch THAT page. |
| follow_redirects = true | optional | — | Follow redirects (e.g. http→https, apex→www) before analysing the final URL (default true). Each hop is independently SSRF-validated. |
/geo-intel/v1/batch1 creditScore up to 20 sites concurrently in one call (each independently SSRF-guarded). Returns a compact score+grade per URL.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| urls | required | — | List of sites to score in one call (max 20); each is independently SSRF-guarded and fetched concurrently. |
curl -X POST https://api.reefapi.com/geo-intel/v1/check \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"url":"https://docs.anthropic.com"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}