AI Search Simulator, GEO Health Check, AI Visibility Analysis โ no need to build your own models, just call and use. GEO infrastructure built for developers and enterprises.
No need to build models or write algorithms โ one line of code gives you Pro GEO analysis results. Below is the data each endpoint returns:
Call the SilkGeo API for data, but your clients see entirely your brand, your product, your interface. They won't know SilkGeo is powering the capabilities behind the scenes.
JSON responses contain only pure data: scores, recommendation results, optimization tips. No SilkGeo logo, no SilkGeo links, no third-party brand traces.
Build your own dashboard, embed in your product, generate your reports, send your emails. Once you have the data, the interface is entirely your design, and the brand is 100% yours.
You pay SilkGeo per-use, then resell to your clients under your brand and pricing. The margin is entirely under your control, and your clients only know they're using your product.
AI Calls (invoking large models) and Standard Calls are metered separately โ you only pay for actual usage.
After signing up for a SilkGeo account, an exclusive API Key is auto-generated in your dashboard (format: ysl_xxxxxxxx).
Add X-API-Key in the request header, or pass it in via the query parameter ?api_key=.
curl -X POST http://silkgeo.com/api/v1/geo-simulate \
-H "X-API-Key: ysl_your_api_key" \
-H "Content-Type: application/json" \
-d '{"brand":"Haidilao","industry":"Hotpot","url":"haidilao.com"}'
All API responses use a unified JSON structure, containing success, data, and usage fields.
{
"success": true,
"data": { ... },
"usage": {
"ai_calls_used": 1,
"ai_calls_limit": 200,
"basic_calls_used": 0,
"basic_calls_limit": 1000
}
}
All endpoints base URL: http://silkgeo.com/api/v1 ๏ฝ Authentication: X-API-Key in the request header
Enter brand and industry information, and the system auto-generates broad queries, simulating recommendation results across five major platforms: ChatGPT/Gemini/Claude/Copilot/Qwen. Core logic: When users don't mention the brand name, will AI proactively recommend you?
| Parameter | Type | Required | Description |
|---|---|---|---|
brand | string | Required | Brand name, e.g. "Haidilao" |
industry | string | Required | Industry name, e.g. "Hotpot" |
url | string | Optional | Brand website URL |
keywords | string | Optional | Keywords, comma-separated |
competitors | string | Optional | Competitor names, comma-separated |
Response Example:
{
"success": true,
"data": {
"brand": "Haidilao",
"industry": "Hotpot",
"score": 3,
"total_platforms": 5,
"results": {
"chatgpt": { "recommended": true, "reason": "..." },
"wenxin": { "recommended": false, "reason": "..." },
"kimi": { "recommended": true, "reason": "..." },
"doubao": { "recommended": true, "reason": "..." },
"deepseek": { "recommended": false, "reason": "..." }
}
}
}
Evaluates GEO health across five dimensions โ AI discoverability, content structure, competitor gap, source authority level, and brand consistency โ and outputs an Optimization Checklist.
| Parameter | Type | Required | Description |
|---|---|---|---|
brand | string | Required | Brand name |
url | string | Required | Brand website URL |
industry | string | Optional | Industry name |
Response Example:
{
"success": true,
"data": {
"brand": "Haidilao",
"score": 82,
"dimensions": {
"ai_discoverability": 85,
"content_structure": 78,
"competitor_gap": 80,
"authority": 75,
"brand_consistency": 90
},
"issues": ["Missing llms.txt file", "robots.txt blocking AI crawlers"],
"suggestions": ["Add llms.txt", "Modify robots.txt to allow AI crawling"]
}
}
Check your brand's Visibility Score in AI search results, returning citation details for each platform.
| Parameter | Type | Required | Description |
|---|---|---|---|
keyword | string | Required | Brand name or keyword |
url | string | Optional | Brand website URL |
Enter a brand name, and the system auto-queries 5 AI platforms (ChatGPT/Claude/Copilot/Gemini/Qwen), tracking whether each platform cites your brand, which original text passage is cited, and how many times competitors are cited. This is the core metric of GEO optimization โ having a website is not enough; you also need to see whether AI will "talk about you".
| Parameter | Type | Required | Description |
|---|---|---|---|
brand | string | Required | Brand name, e.g. "Haidilao" |
url | string | Optional | Brand website URL |
industry | string | Optional | Industry name, e.g. "Hotpot" |
competitors | string | Optional | Competitor names, comma-separated |
Response Example:
{
"success": true,
"data": {
"brand": "Haidilao",
"citation_score": 80,
"total_platforms": 5,
"brand_mentions": 4,
"mention_rate": "80.0%",
"platforms": [
{
"platform": "ChatGPT",
"brand_mentioned": true,
"citation_snippet": "...Haidilao is renowned for its outstanding service experience...",
"competitors_mentioned": ["Xiabu Xiabu"]
}
],
"competitor_comparison": [
{ "name": "Xiabu Xiabu", "platforms_mentioned": 3, "mention_rate": "60.0%" }
],
"recommendations": ["Your brand's citation performance across AI platforms is excellent. Suggest maintaining continuous content updates."]
}
}
Deep-check your brand's position in the AI knowledge graph: Does AI identify your brand as an independent entity? What keywords/industries/scenarios is your brand associated with? Will AI proactively associate your brand when answering industry questions? How well is your site's structured data implemented? Returns ABCD four-tier scores with detailed optimization tips.
| Parameter | Type | Required | Description |
|---|---|---|---|
brand | string | Required | Brand name, e.g. "Haidilao" |
url | string | Optional | Brand website URL (will also check structured data when provided) |
industry | string | Optional | Industry name |
Response Example:
{
"success": true,
"data": {
"brand": "Haidilao",
"knowledge_graph_score": 75,
"grade": "B",
"entity_recognition": {
"is_known_entity": true,
"entity_type": "brand",
"description": "Haidilao is a well-known Chinese hotpot chain brand...",
"trust_level": "High",
"data_freshness": "Relatively up-to-date"
},
"semantic_association": {
"strength": 8,
"top_of_mind": true,
"reason": "Leading brand in the hotpot industry, high-frequency association when users mention hotpot",
"content_gaps": ["Insufficient international store coverage information", "Missing digital transformation case studies"]
},
"related_keywords": ["Hotpot", "Service Experience", "Chain Restaurant"],
"related_industries": ["Food & Beverage", "Chain", "Catering"],
"related_scenarios": ["Friend gatherings", "Family gatherings", "Business dinners"],
"competitors": ["Xiabu Xiabu", "Banu", "Xiaolongkan"],
"structure_score": 70,
"structure_issues": ["Missing JSON-LD structured data"],
"recommendations": ["Brand is identified by AI, but association strength is weak..."]
}
}
Check webpage Title, Description, Keywords, and other meta tags for specification compliance.
| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | Required | Webpage URL to check |
Check robots.txt configuration, determining whether AI crawlers (GPTBot/ClaudeBot, etc.) are blocked.
| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | Required | Website homepage URL |
Auto-generate an llms.txt file based on website content, helping AI models better understand the website.
| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | Required | Website URL (query parameter) |
Query the indexed page count for a domain across major search engines.
| Parameter | Type | Required | Description |
|---|---|---|---|
domain | string | Required | Domain to query (query parameter) |
| HTTP Status Code | Error Code | Description |
|---|---|---|
| 401 | MISSING_API_KEY | Missing API Key. Please add X-API-Key in the request header. |
| 401 | INVALID_API_KEY | API Key is invalid or has been deactivated. |
| 429 | QUOTA_EXCEEDED | Calls quota exhausted. Please upgrade your plan or purchase add-on packs. |
| 429 | RATE_LIMITED | Request frequency exceeded. Please reduce call frequency. |
| 400 | MISSING_PARAM | Missing required parameter. |
| 500 | INTERNAL_ERROR | Internal server error. Please try again later. |
Every response includes X-RateLimit-AI-Used / X-RateLimit-AI-Limit / X-RateLimit-Basic-Used / X-RateLimit-Basic-Limit response headers, making it easy to monitor your quota in real-time.