> ## Documentation Index > Fetch the complete documentation index at: https://docs.theswarm.com/llms.txt > Use this file to discover all available pages before exploring further. # API Query Builder > Convert natural language into OpenSearch DSL and can run it against the Swarm API, delivering both the query and live results in one interface. export const QueryBuilder = () => { const [query, setQuery] = useState(""); const [result, setResult] = useState(""); const [convertedQuery, setConvertedQuery] = useState(""); const [loading, setLoading] = useState(false); const [queryType, setQueryType] = useState("profiles"); const [copiedResult, setCopiedResult] = useState(false); const [copiedQuery, setCopiedQuery] = useState(false); const [apiKey, setApiKey] = useState(""); const [showApiKey, setShowApiKey] = useState(false); const [maxResults, setMaxResults] = useState(20); const [lastSeen, setLastSeen] = useState(null); const profilePlaceholder = "Find CTOs in fintech startups in London"; const companyPlaceholder = "Companies that raised Series A funding in 2024"; const currentPlaceholder = queryType === "profiles" ? profilePlaceholder : companyPlaceholder; useEffect(() => { const savedApiKey = localStorage.getItem("swarm-api-key"); if (savedApiKey) { setApiKey(savedApiKey); } }, []); const handleApiKeyChange = e => { const newApiKey = e.target.value; setApiKey(newApiKey); if (newApiKey.trim()) { localStorage.setItem("swarm-api-key", newApiKey); } else { localStorage.removeItem("swarm-api-key"); } }; const clearApiKey = () => { setApiKey(""); localStorage.removeItem("swarm-api-key"); }; const handleSubmit = async () => { if (!query.trim()) return; setLoading(true); setResult(""); setConvertedQuery(""); try { const convertResponse = await fetch("https://theswarm-query-builder.vercel.app/api/convert", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ query: query.trim(), type: queryType, model: "openai" }) }); const convertData = await convertResponse.json(); if (!convertData.success) { setResult(`Error: ${convertData.error}`); setLoading(false); return; } const dslQuery = convertData.query; setConvertedQuery(JSON.stringify(dslQuery, null, 2)); if (apiKey.trim()) { try { const executeResponse = await fetch("https://theswarm-query-builder.vercel.app/api/execute", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ query: dslQuery, type: queryType, apiKey: apiKey.trim(), max: maxResults, after: lastSeen }) }); const executeData = await executeResponse.json(); if (executeData.success) { setResult(JSON.stringify(executeData.data, null, 2)); if (executeData.data?.lastSeen) { setLastSeen(executeData.data.lastSeen); } } else { setResult(`Error: ${executeData.error}`); } } catch (executeError) { setResult("Failed to execute query"); } } else { setResult(JSON.stringify(dslQuery, null, 2)); } } catch (error) { setResult("Failed to connect to server"); } finally { setLoading(false); } }; const handleKeyPress = e => { if (e.key === "Enter" && (e.metaKey || e.ctrlKey)) { handleSubmit(); } }; const loadNextPage = () => { if (lastSeen && apiKey.trim()) { handleSubmit(); } }; const resetPagination = () => { setLastSeen(null); setResult(""); }; const copyToClipboard = async () => { if (!result) return; try { await navigator.clipboard.writeText(result); setCopiedResult(true); setTimeout(() => setCopiedResult(false), 1500); } catch (error) { console.error("Failed to copy to clipboard:", error); } }; const copyConvertedQuery = async () => { if (!convertedQuery) return; try { await navigator.clipboard.writeText(convertedQuery); setCopiedQuery(true); setTimeout(() => setCopiedQuery(false), 1500); } catch (error) { console.error("Failed to copy to clipboard:", error); } }; const downloadResults = () => { if (!result || result.startsWith("Error:")) return; try { const data = JSON.parse(result); const dataStr = JSON.stringify(data, null, 2); const dataBlob = new Blob([dataStr], { type: "application/json" }); const url = URL.createObjectURL(dataBlob); const link = document.createElement("a"); link.href = url; link.download = `swarm-query-results-${Date.now()}.json`; document.body.appendChild(link); link.click(); document.body.removeChild(link); URL.revokeObjectURL(url); } catch (error) { console.error("Failed to download results:", error); } }; const handleQueryChange = e => { setQuery(e.target.value); if (lastSeen) { setLastSeen(null); } }; const renderJSON = text => { if (!text) return null; if (text.startsWith("Error:")) { return
{text}
; } try { const jsonObj = JSON.parse(text); const renderValue = (value, indent = 0) => { const spaces = (" ").repeat(indent); if (value === null) { return null; } if (typeof value === "boolean") { return {String(value)}; } if (typeof value === "number") { return {value}; } if (typeof value === "string") { return "{value}"; } if (Array.isArray(value)) { if (value.length === 0) { return <> [ ] ; } return <> [
{value.map((item, index) =>
{spaces} {renderValue(item, indent + 1)} {index < value.length - 1 && ,}
)}
{spaces}] ; } if (typeof value === "object") { const keys = Object.keys(value); if (keys.length === 0) { return <> {`{`} {`}`} ; } return <> {`{`}
{keys.map((key, index) =>
{spaces} "{key}" : {renderValue(value[key], indent + 1)} {index < keys.length - 1 && ,}
)}
{spaces}{`}`} ; } return String(value); }; return renderValue(jsonObj); } catch (e) { return
{text}
; } }; return
{}
{}
Type your natural language query: