Web Search
curl --request POST \
--url https://api.wistx.ai/v1/search/web \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"search_type": "<string>",
"resource_type": "<string>",
"cloud_provider": "<string>",
"severity": "<string>",
"include_cves": true,
"include_advisories": true,
"limit": 123
}
'import requests
url = "https://api.wistx.ai/v1/search/web"
payload = {
"query": "<string>",
"search_type": "<string>",
"resource_type": "<string>",
"cloud_provider": "<string>",
"severity": "<string>",
"include_cves": True,
"include_advisories": True,
"limit": 123
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
query: '<string>',
search_type: '<string>',
resource_type: '<string>',
cloud_provider: '<string>',
severity: '<string>',
include_cves: true,
include_advisories: true,
limit: 123
})
};
fetch('https://api.wistx.ai/v1/search/web', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.wistx.ai/v1/search/web",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => '<string>',
'search_type' => '<string>',
'resource_type' => '<string>',
'cloud_provider' => '<string>',
'severity' => '<string>',
'include_cves' => true,
'include_advisories' => true,
'limit' => 123
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.wistx.ai/v1/search/web"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"search_type\": \"<string>\",\n \"resource_type\": \"<string>\",\n \"cloud_provider\": \"<string>\",\n \"severity\": \"<string>\",\n \"include_cves\": true,\n \"include_advisories\": true,\n \"limit\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.wistx.ai/v1/search/web")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"search_type\": \"<string>\",\n \"resource_type\": \"<string>\",\n \"cloud_provider\": \"<string>\",\n \"severity\": \"<string>\",\n \"include_cves\": true,\n \"include_advisories\": true,\n \"limit\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.wistx.ai/v1/search/web")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"<string>\",\n \"search_type\": \"<string>\",\n \"resource_type\": \"<string>\",\n \"cloud_provider\": \"<string>\",\n \"severity\": \"<string>\",\n \"include_cves\": true,\n \"include_advisories\": true,\n \"limit\": 123\n}"
response = http.request(request)
puts response.read_body{
"data": {
"web": [
{
"title": "AWS RDS Encryption Best Practices",
"content": "Amazon RDS encryption provides an additional layer of data protection...",
"url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.Encryption.html",
"score": 0.95,
"source": "tavily",
"type": "web_result"
}
],
"security": [
{
"cve_id": "CVE-2023-12345",
"title": "RDS Security Advisory",
"severity": "HIGH",
"description": "Security vulnerability in RDS encryption...",
"affected_versions": ["1.0.0", "1.1.0"],
"published_date": "2023-01-15"
}
],
"total": 15
},
"metadata": {
"request_id": "req_abc123",
"timestamp": 1704067200.0,
"query_time_ms": 1234
}
}
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters",
"details": "Invalid search_type: invalid. Use 'general' or 'security'"
},
"metadata": {
"request_id": "req_abc123",
"timestamp": 1704067200.0
}
}
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or missing API key",
"details": null
},
"metadata": {
"request_id": "req_abc123",
"timestamp": 1704067200.0
}
}
{
"error": {
"code": "QUOTA_EXCEEDED",
"message": "Query quota exceeded. Limit: 50 queries/month, Current: 50",
"details": {
"limit_type": "queries_per_month",
"current": 50,
"limit": 50
}
},
"metadata": {
"request_id": "req_abc123",
"timestamp": 1704067200.0
}
}
{
"error": {
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred",
"details": "Web search service unavailable"
},
"metadata": {
"request_id": "req_abc123",
"timestamp": 1704067200.0
}
}
Search
Web Search
Search the web for DevOps/infrastructure/compliance/FinOps/SRE information
POST
/
v1
/
search
/
web
Web Search
curl --request POST \
--url https://api.wistx.ai/v1/search/web \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"search_type": "<string>",
"resource_type": "<string>",
"cloud_provider": "<string>",
"severity": "<string>",
"include_cves": true,
"include_advisories": true,
"limit": 123
}
'import requests
url = "https://api.wistx.ai/v1/search/web"
payload = {
"query": "<string>",
"search_type": "<string>",
"resource_type": "<string>",
"cloud_provider": "<string>",
"severity": "<string>",
"include_cves": True,
"include_advisories": True,
"limit": 123
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
query: '<string>',
search_type: '<string>',
resource_type: '<string>',
cloud_provider: '<string>',
severity: '<string>',
include_cves: true,
include_advisories: true,
limit: 123
})
};
fetch('https://api.wistx.ai/v1/search/web', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.wistx.ai/v1/search/web",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => '<string>',
'search_type' => '<string>',
'resource_type' => '<string>',
'cloud_provider' => '<string>',
'severity' => '<string>',
'include_cves' => true,
'include_advisories' => true,
'limit' => 123
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.wistx.ai/v1/search/web"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"search_type\": \"<string>\",\n \"resource_type\": \"<string>\",\n \"cloud_provider\": \"<string>\",\n \"severity\": \"<string>\",\n \"include_cves\": true,\n \"include_advisories\": true,\n \"limit\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.wistx.ai/v1/search/web")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"search_type\": \"<string>\",\n \"resource_type\": \"<string>\",\n \"cloud_provider\": \"<string>\",\n \"severity\": \"<string>\",\n \"include_cves\": true,\n \"include_advisories\": true,\n \"limit\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.wistx.ai/v1/search/web")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"<string>\",\n \"search_type\": \"<string>\",\n \"resource_type\": \"<string>\",\n \"cloud_provider\": \"<string>\",\n \"severity\": \"<string>\",\n \"include_cves\": true,\n \"include_advisories\": true,\n \"limit\": 123\n}"
response = http.request(request)
puts response.read_body{
"data": {
"web": [
{
"title": "AWS RDS Encryption Best Practices",
"content": "Amazon RDS encryption provides an additional layer of data protection...",
"url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.Encryption.html",
"score": 0.95,
"source": "tavily",
"type": "web_result"
}
],
"security": [
{
"cve_id": "CVE-2023-12345",
"title": "RDS Security Advisory",
"severity": "HIGH",
"description": "Security vulnerability in RDS encryption...",
"affected_versions": ["1.0.0", "1.1.0"],
"published_date": "2023-01-15"
}
],
"total": 15
},
"metadata": {
"request_id": "req_abc123",
"timestamp": 1704067200.0,
"query_time_ms": 1234
}
}
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters",
"details": "Invalid search_type: invalid. Use 'general' or 'security'"
},
"metadata": {
"request_id": "req_abc123",
"timestamp": 1704067200.0
}
}
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or missing API key",
"details": null
},
"metadata": {
"request_id": "req_abc123",
"timestamp": 1704067200.0
}
}
{
"error": {
"code": "QUOTA_EXCEEDED",
"message": "Query quota exceeded. Limit: 50 queries/month, Current: 50",
"details": {
"limit_type": "queries_per_month",
"current": 50,
"limit": 50
}
},
"metadata": {
"request_id": "req_abc123",
"timestamp": 1704067200.0
}
}
{
"error": {
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred",
"details": "Web search service unavailable"
},
"metadata": {
"request_id": "req_abc123",
"timestamp": 1704067200.0
}
}
Search the web for DevOps, infrastructure, compliance, FinOps, and SRE information. Supports both general web search and security-focused searches (CVEs, advisories).
Endpoint
POST /v1/search/web
Request Body
string
required
Search query. Minimum length: 3 characters, maximum length: 1,000 characters.
string
default:"general"
Type of search:
general (includes web search), security (focuses on CVEs/advisories).string
Filter by resource type (RDS, S3, EKS, GKE, AKS, etc.).
string
Filter by cloud provider:
aws, gcp, azure.string
Filter by severity (for security searches):
CRITICAL, HIGH, MEDIUM, LOW.boolean
default:"true"
Include CVE database results.
boolean
default:"true"
Include security advisories.
integer
default:"1000"
Maximum number of results to return.
Request Example
curl --request POST \
--url https://api.wistx.ai/v1/search/web \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"query": "AWS RDS encryption best practices",
"search_type": "general",
"cloud_provider": "aws",
"limit": 1000
}'
import requests
api_key = "YOUR_API_KEY"
response = requests.post(
"https://api.wistx.ai/v1/search/web",
headers={
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
},
json={
"query": "AWS RDS encryption best practices",
"search_type": "general",
"cloud_provider": "aws",
"limit": 1000
}
)
print(response.json())
const apiKey = "YOUR_API_KEY";
const response = await fetch("https://api.wistx.ai/v1/search/web", {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
query: "AWS RDS encryption best practices",
search_type: "general",
cloud_provider: "aws",
limit: 20
})
});
const data = await response.json();
console.log(data);
package main
import (
"bytes"
"encoding/json"
"net/http"
)
func main() {
apiKey := "YOUR_API_KEY"
payload := map[string]interface{}{
"query": "AWS RDS encryption best practices",
"search_type": "general",
"cloud_provider": "aws",
"limit": 1000,
}
jsonData, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://api.wistx.ai/v1/search/web", bytes.NewBuffer(jsonData))
req.Header.Set("Authorization", "Bearer "+apiKey)
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
}
require 'net/http'
require 'json'
uri = URI('https://api.wistx.ai/v1/search/web')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri.path)
request['Authorization'] = "Bearer YOUR_API_KEY"
request['Content-Type'] = 'application/json'
request.body = {
query: "AWS RDS encryption best practices",
search_type: "general",
cloud_provider: "aws",
limit: 20
}.to_json
response = http.request(request)
puts response.body
<?php
$apiKey = "YOUR_API_KEY";
$data = [
"query" => "AWS RDS encryption best practices",
"search_type" => "general",
"cloud_provider" => "aws",
"limit" => 20
];
$ch = curl_init("https://api.wistx.ai/v1/search/web");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer " . $apiKey,
"Content-Type: application/json"
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import com.fasterxml.jackson.databind.ObjectMapper;
String apiKey = "YOUR_API_KEY";
Map<String, Object> payload = Map.of(
"query", "AWS RDS encryption best practices",
"search_type", "general",
"cloud_provider", "aws",
"limit", 20
);
ObjectMapper mapper = new ObjectMapper();
String json = mapper.writeValueAsString(payload);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.wistx.ai/v1/search/web"))
.header("Authorization", "Bearer " + apiKey)
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(json))
.build();
HttpClient client = HttpClient.newHttpClient();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
Response Example
{
"data": {
"web": [
{
"title": "AWS RDS Encryption Best Practices",
"content": "Amazon RDS encryption provides an additional layer of data protection...",
"url": "https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.Encryption.html",
"score": 0.95,
"source": "tavily",
"type": "web_result"
}
],
"security": [
{
"cve_id": "CVE-2023-12345",
"title": "RDS Security Advisory",
"severity": "HIGH",
"description": "Security vulnerability in RDS encryption...",
"affected_versions": ["1.0.0", "1.1.0"],
"published_date": "2023-01-15"
}
],
"total": 15
},
"metadata": {
"request_id": "req_abc123",
"timestamp": 1704067200.0,
"query_time_ms": 1234
}
}
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters",
"details": "Invalid search_type: invalid. Use 'general' or 'security'"
},
"metadata": {
"request_id": "req_abc123",
"timestamp": 1704067200.0
}
}
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or missing API key",
"details": null
},
"metadata": {
"request_id": "req_abc123",
"timestamp": 1704067200.0
}
}
{
"error": {
"code": "QUOTA_EXCEEDED",
"message": "Query quota exceeded. Limit: 50 queries/month, Current: 50",
"details": {
"limit_type": "queries_per_month",
"current": 50,
"limit": 50
}
},
"metadata": {
"request_id": "req_abc123",
"timestamp": 1704067200.0
}
}
{
"error": {
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred",
"details": "Web search service unavailable"
},
"metadata": {
"request_id": "req_abc123",
"timestamp": 1704067200.0
}
}
Rate Limits
| Plan | Queries/Month |
|---|---|
| Professional | 2,000 |
| Team | 10,000 |
| Enterprise | Unlimited |