{"openapi":"3.0.3","info":{"title":"AI Real-Time Web Search & Grounding API","description":"Noise-Free Real-Time Web Search and LLM Grounding API for AI Agents (Make, n8n, LangChain, CrewAI, AutoGen). Delivers clean, de-duplicated web facts, news snippets, and ready-to-inject RAG prompt chunks without advertising noise.","version":"1.0.0","contact":{"name":"TopAI SaaS Dev","email":"top.ai.saas@gmail.com"}},"servers":[{"url":"https://ai-web-search.topaisaas.workers.dev","description":"Cloudflare Workers Production Edge"}],"paths":{"/v1/search":{"post":{"summary":"Real-Time Noise-Free Web Search","description":"Searches across multiple privacy-friendly web sources, deduplicates results, removes tracking parameters, and formats output for AI agents.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","example":"Latest AI agent developments 2026"},"num_results":{"type":"integer","example":5,"default":5},"format":{"type":"string","enum":["json","markdown","llm_context"],"default":"json"}}}}}},"responses":{"200":{"description":"Search results returned successfully"},"400":{"description":"Invalid search query"}}},"get":{"summary":"Real-Time Web Search (GET endpoint)","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"description":"Search query"},{"name":"num_results","in":"query","schema":{"type":"integer","default":5}}],"responses":{"200":{"description":"Search results returned"}}}},"/v1/grounding":{"post":{"summary":"Generate RAG Grounding Prompt Chunk","description":"Returns a pre-formatted grounding context block ready to inject directly into LLM system prompts (Claude, GPT, Gemini, Llama).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","example":"Snowflake Q3 earnings"},"num_results":{"type":"integer","example":5,"default":5}}}}}},"responses":{"200":{"description":"Grounding context successfully produced"}}}},"/v1/news":{"post":{"summary":"Real-Time News Search","description":"Searches the latest breaking news stories with published dates and clean source links.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","example":"Tech IPOs 2026"},"num_results":{"type":"integer","example":5,"default":5}}}}}},"responses":{"200":{"description":"Latest news articles returned"}}}},"/v1/health":{"get":{"summary":"API Healthcheck","responses":{"200":{"description":"Service is healthy and operational"}}}}}}