New AI Search endpoints with unified response structure! See our February changelog for details.
Introduction
Account
Chat completions & observations
Copy
{
"prompt": "What are the latest trends in AI?",
"fields": {
"citations": ["url", "title", "description", "icon", "domain"],
"sources": ["url", "title", "snippet", "rank", "datePublished"],
"paragraphs": {
"text": true,
"citations": ["url", "title", "description", "icon", "domain"]
}
},
"cache": {
"enabled": true,
"ttl": 7200
}
}
Copy
{
"status": true,
"data": {
"text": "The latest trends in AI include advancements in large language models, multimodal AI systems, and AI agents...",
"markdown": "The latest trends in AI include advancements in **large language models**, **multimodal AI systems**, and **AI agents**...",
"model": "grok-2",
"sources": [
{
"url": "https://example.com/ai-trends",
"title": "AI Trends 2026",
"snippet": "A comprehensive overview of the latest AI trends and developments in 2026.",
"rank": 1,
"datePublished": "2026-02-01T00:00:00.000Z"
}
// ... rest
],
"citations": [
{
"url": "https://example.com/ai-trends",
"title": "AI Trends 2026",
"description": "A comprehensive overview of the latest AI trends and developments.",
"icon": "https://www.google.com/s2/favicons?domain=example.com&sz=32",
"domain": "example.com",
"cited": true
}
// ... rest
],
"paragraphs": [
{
"text": "The latest trends in AI include advancements in **large language models**, **multimodal AI systems**, and **AI agents**...",
"citations": [
{
"url": "https://example.com/ai-trends",
"title": "AI Trends 2026",
"description": "A comprehensive overview...",
"icon": "https://www.google.com/s2/favicons?domain=example.com&sz=32",
"domain": "example.com"
}
]
}
// ... rest
]
},
"cached": false,
"cacheExpiresIn": null
}
POST
https://api.evergreens.ai
/
tedi
/
networks
/
browser
/
ai
/
grok
Copy
{
"prompt": "What are the latest trends in AI?",
"fields": {
"citations": ["url", "title", "description", "icon", "domain"],
"sources": ["url", "title", "snippet", "rank", "datePublished"],
"paragraphs": {
"text": true,
"citations": ["url", "title", "description", "icon", "domain"]
}
},
"cache": {
"enabled": true,
"ttl": 7200
}
}
Copy
{
"status": true,
"data": {
"text": "The latest trends in AI include advancements in large language models, multimodal AI systems, and AI agents...",
"markdown": "The latest trends in AI include advancements in **large language models**, **multimodal AI systems**, and **AI agents**...",
"model": "grok-2",
"sources": [
{
"url": "https://example.com/ai-trends",
"title": "AI Trends 2026",
"snippet": "A comprehensive overview of the latest AI trends and developments in 2026.",
"rank": 1,
"datePublished": "2026-02-01T00:00:00.000Z"
}
// ... rest
],
"citations": [
{
"url": "https://example.com/ai-trends",
"title": "AI Trends 2026",
"description": "A comprehensive overview of the latest AI trends and developments.",
"icon": "https://www.google.com/s2/favicons?domain=example.com&sz=32",
"domain": "example.com",
"cited": true
}
// ... rest
],
"paragraphs": [
{
"text": "The latest trends in AI include advancements in **large language models**, **multimodal AI systems**, and **AI agents**...",
"citations": [
{
"url": "https://example.com/ai-trends",
"title": "AI Trends 2026",
"description": "A comprehensive overview...",
"icon": "https://www.google.com/s2/favicons?domain=example.com&sz=32",
"domain": "example.com"
}
]
}
// ... rest
]
},
"cached": false,
"cacheExpiresIn": null
}
Entity Reference:
AiSearchEntityGrok is an AI assistant developed by xAI, designed to provide real-time information and insights. This endpoint allows you to query Grok and receive structured responses with citations and sources.
The Grok AI Search endpoint returns structured responses following the unified AiSearchEntity format, including text, markdown, citations, sources, and paragraphs.
Request
The search query or prompt to be sent to the AI search provider.
- Minimum length: 1 character
- Maximum length: 500 characters
Specify which response fields to include. This allows you to optimize the response size by requesting only the data you need.
Show child attributes
Show child attributes
Array of citation fields to include (e.g.,
["url", "title", "description", "icon", "domain"]).Array of source fields to include (e.g.,
["url", "title", "snippet", "rank", "datePublished"]).An optional object to configure caching behavior for the request. By default, caching is enabled with a TTL of 120 seconds. You can customize these settings by providing the
cache object.Show child attributes
Show child attributes
A boolean indicating whether caching is enabled for this request. Default is
true.Time-to-live (TTL) for the cache entry in seconds. Default is
120 seconds. Setting a longer TTL can improve performance for repeated requests with the same input, but may result in slightly outdated responses if the underlying data changes frequently.| Minimum TTL | Maximum TTL | Default TTL |
|---|---|---|
| 120 seconds | 86400 seconds | 7200 seconds |
Response
Indicates whether the response was served from cache.
The time in seconds until the cached response expires. Default is 7200 seconds (2 hours).
Hide child attributes
Hide child attributes
The AI-generated plain text response based on the search query.
Markdown formatted copy of the text response, allowing for formatted output with bold, italics, links, etc.
The name of the AI model used to generate the response (e.g., “grok-2”).
An array of source websites used to generate the response.
An array of citations referenced in the response.
Hide child attributes
Hide child attributes
The URL of the cited source.
The title of the cited source.
A brief description of the cited source.
The favicon URL of the cited source.
The domain name of the cited source.
Whether this citation was directly referenced in the response text.
An array of paragraphs that compose the response, each containing its own text and associated citations.
Hide child attributes
Hide child attributes
The paragraph text content (may include markdown formatting).
An array of citations associated with this paragraph.
Copy
{
"prompt": "What are the latest trends in AI?",
"fields": {
"citations": ["url", "title", "description", "icon", "domain"],
"sources": ["url", "title", "snippet", "rank", "datePublished"],
"paragraphs": {
"text": true,
"citations": ["url", "title", "description", "icon", "domain"]
}
},
"cache": {
"enabled": true,
"ttl": 7200
}
}
Copy
{
"status": true,
"data": {
"text": "The latest trends in AI include advancements in large language models, multimodal AI systems, and AI agents...",
"markdown": "The latest trends in AI include advancements in **large language models**, **multimodal AI systems**, and **AI agents**...",
"model": "grok-2",
"sources": [
{
"url": "https://example.com/ai-trends",
"title": "AI Trends 2026",
"snippet": "A comprehensive overview of the latest AI trends and developments in 2026.",
"rank": 1,
"datePublished": "2026-02-01T00:00:00.000Z"
}
// ... rest
],
"citations": [
{
"url": "https://example.com/ai-trends",
"title": "AI Trends 2026",
"description": "A comprehensive overview of the latest AI trends and developments.",
"icon": "https://www.google.com/s2/favicons?domain=example.com&sz=32",
"domain": "example.com",
"cited": true
}
// ... rest
],
"paragraphs": [
{
"text": "The latest trends in AI include advancements in **large language models**, **multimodal AI systems**, and **AI agents**...",
"citations": [
{
"url": "https://example.com/ai-trends",
"title": "AI Trends 2026",
"description": "A comprehensive overview...",
"icon": "https://www.google.com/s2/favicons?domain=example.com&sz=32",
"domain": "example.com"
}
]
}
// ... rest
]
},
"cached": false,
"cacheExpiresIn": null
}
Was this page helpful?