{"uid":"cap_v7GKPo26LQHCBqDALPr18","slug":"gapup-web-search-neural-keyword-500d95dd","name":"Gapup Web Search (Neural & Keyword)","description":"Neural and keyword web search over the live web. Ranked results with title, URL, date, author, optional full text.","url":"https://mcp.gapup.io/api/v1/call/web_search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"type":{"enum":["neural","keyword","auto"],"type":"string","description":"Search mode (default auto)"},"async":{"type":"boolean","description":"If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts."},"query":{"type":"string","maxLength":500,"minLength":2,"description":"The search query"},"category":{"enum":["company","research paper","news","pdf","github","tweet","personal site","linkedin profile","financial report"],"type":"string","description":"Restrict results to one kind of page"},"numResults":{"type":"integer","maximum":25,"minimum":1,"description":"How many results (default 10)"},"includeText":{"type":"boolean","description":"Include the page text in each result (default false)"},"excludeDomains":{"type":"array","items":{"type":"string"},"maxItems":20},"includeDomains":{"type":"array","items":{"type":"string"},"maxItems":20},"startPublishedDate":{"type":"string","description":"ISO-8601 date; only pages published after it"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__JH07IV5Hb7EUi2pCiy-Q","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs neural or keyword search over the live web, returning ranked results with title, URL, date, author, and optional full page text.","exampleAgentPrompt":"Search the web for recent news articles about OpenAI's latest model releases published after January 1 2025 — give me 10 results using neural search mode and include the full text of each page.","exampleUseCases":[{"title":"Competitive intelligence news sweep","prompt":"Search the web for news about Anthropic published after March 1 2025 — use neural search, restrict to the news category, and give me 15 results with full page text so I can summarize what they've been up to."},{"title":"Research paper discovery","prompt":"Find me 10 recent research papers about retrieval-augmented generation — use keyword search, restrict to the research paper category, and only show results published after January 2024."},{"title":"GitHub repo prospecting","prompt":"Search for GitHub repositories related to 'AI agent orchestration frameworks' using auto search mode — give me 20 results and exclude results from github.com/microsoft."}],"resultDescription":"Returns an ordered list of web results, each containing the page title, URL, publication date, author, and relevance rank. If includeText is true, the full extracted text of each page is also included. Results are filtered by any domain inclusion/exclusion lists and publication date constraints provided.","failureModes":["Query too short (fewer than 2 characters) — validation error returned","Query exceeds 500 characters — validation error returned","No results found for the given query and filters — empty result list returned","Invalid category enum value — request rejected","Invalid ISO-8601 date for startPublishedDate — parsing error","Payment not confirmed (x402) — request rejected before processing","Async job_id polling may return not-ready status if result hasn't completed"],"whenToPreferThis":"Choose this endpoint when you need live web search with both neural (semantic/vector) and keyword modes, flexible category filtering (news, research papers, GitHub, tweets, LinkedIn, PDFs, financial reports), domain inclusion/exclusion, and optional full page text extraction — all in a single call. It is especially strong when you need semantically relevant results beyond simple keyword matching. Prefer it over generic search APIs when you need structured metadata (author, date, rank) alongside results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T20:19:56.043Z","isFirstParty":false,"canonicalSlug":"gapup-web-search-neural-keyword-500d95dd"}