Grok Live Search: xAI action

Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

Field	Type	Required	Description
Model model	options	Required	Model. Options: Grok 4, Grok 3
Question message	string	Required	Question (required)
Search Mode search_mode	options	Optional	Search Mode. Options: Auto, On (always search), Off
Max Search Results max_search_results	string	Optional	Max Search Results
Source Types sources	array	Optional	Array of {type: 'web'\|'x'\|'news'\|'rss'} objects

Sample request

{
  "model": "{{trigger.model}}",
  "message": "{{trigger.message}}",
  "search_mode": "{{trigger.search_mode}}",
  "max_search_results": "{{trigger.max_search_results}}",
  "sources": "{{trigger.sources}}"
}

Returns

{
  "id": "chatcmpl_abc",
  "usage": {
    "total_tokens": 300,
    "prompt_tokens": 100,
    "completion_tokens": 200
  },
  "choices": [
    {
      "message": {
        "content": "..."
      },
      "finish_reason": "stop"
    }
  ],
  "citations": [
    "https://example.com"
  ]
}

Use these fields in downstream nodes for routing, logging, or error handling.

FAQ

Questions about Grok Live Search.

What does the Grok Live Search action do in xAI?

Chats with Grok with Live Search enabled, so Grok pulls fresh web and X results at request time and folds them into the answer. Grok's defining differentiator over other LLM APIs.

What inputs does Grok Live Search require?

Required: Model, Question. Every input accepts a static value or a variable from any upstream node in your workflow.

Can I use dynamic inputs from earlier workflow nodes?

Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.

What happens if xAI returns an error?

The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.

Does Grok Live Search support batch operations?

Yes. Run Grok Live Search inside a Loop node to process arrays. Tiny Command handles xAI's rate limits automatically so you don't have to throttle manually.

More actions