Grok X Search

Grok X Search

Purpose

Search Twitter/X using Grok API's native x_search tool. Returns structured results from recent posts, optimized for discovering practical tips, tool releases, and business use cases from real practitioners.

Prerequisites

• XAI_API_KEY — xAI API key (from console.x.ai)
• httpx pip package (pip install httpx)

The API key must be set as an environment variable or in a .env file (searched in current directory and up to 4 parent directories).

Script: grok_search.py

Usage

# Use built-in default queries, save to results.json
python grok_search.py --output results.json

# Custom queries via CLI (repeatable)
python grok_search.py --query "AI tools for business" --query "prompt engineering tips" --output results.json

# Queries from a JSON file
python grok_search.py --queries-file my_queries.json --output results.json

# Custom model
python grok_search.py --output results.json --model grok-3-mini-fast

Arguments

Arg	Required	Default	Description
--output	Yes	—	Path to save results JSON
--query	No	—	Search query (repeatable for multiple queries)
--queries-file	No	—	Path to JSON file with query list (["query1", "query2"])
--model	No	grok-4-fast-non-reasoning	Grok model to use

If neither --query nor --queries-file is provided, uses built-in default queries.

Output Format

{
  "date": "20260312",
  "query_count": 4,
  "result_count": 12,
  "results": [
    {
      "query": "AI tools for business",
      "content": "Full text response from Grok with tweet URLs...",
      "source": "x_search"
    }
  ]
}

Queries File Format

Plain JSON array of strings:

[
  "AI agent workflow automation business",
  "new AI tool released this week",
  "ChatGPT vs Claude practical comparison"
]

How It Works

1. Loads XAI_API_KEY from environment or .env
2. For each query, sends a request to Grok API (https://api.x.ai/v1/responses) with x_search tool enabled
3. Grok searches Twitter/X natively and returns synthesized results with tweet URLs
4. Extracts text content from response output array (handles both output_text and nested content formats)
5. Saves all results as structured JSON

Grok API Details

• Endpoint: https://api.x.ai/v1/responses
• Tool: x_search (native Twitter/X search, not a web scraper)
• Timeout: 120 seconds per query
• Temperature: 0.3 (factual, low creativity)
• Prompt pattern: Instructs Grok to find practical posts from the last 48 hours, prioritizing new tools/features, how-tos, and actionable tips. Requests full tweet URLs.

Default Queries (fallback)

When no queries are specified, searches for:

1. New AI tools released this week (practical, business-focused)
2. AI agent workflow automation (business owner use cases)
3. Best AI prompting tips and strategies (practitioner tricks)
4. AI business automation case studies with ROI results

These defaults cover tool discovery, workflow automation, prompting, and business cases.

.env Format

XAI_API_KEY=xai-abc123...