Get a search
curl --request GET \
--url https://api.spidra.io/api/search/{jobId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.spidra.io/api/search/{jobId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.spidra.io/api/search/{jobId}', 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.spidra.io/api/search/{jobId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.spidra.io/api/search/{jobId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.spidra.io/api/search/{jobId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.spidra.io/api/search/{jobId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": "completed",
"progress": {
"message": "Search completed successfully",
"progress": 1
},
"result": {
"success": true,
"data": {
"news": [
{
"title": "VCs are obsessed with vector databases. Here are seven AI startups in the space that have raised millions from investors.",
"url": "https://www.businessinsider.com/seven-vector-database-startups-poised-to-win-ai-revolution-2024-4",
"description": "Vector databases don't get as much love as their flashier counterparts ...",
"source": "Business Insider",
"date": "3 years ago",
"position": 1
}
],
"research": [
{
"title": "BioVDB: biological vector database for high-throughput gene expression meta-analysis.",
"url": "https://doi.org/10.3389/frai.2024.1366273",
"description": "High-throughput sequencing has created an exponential increase in the amount of gene expression data ...",
"date": "2024-03-08",
"source": "PubMed",
"authors": "Winnicki MJ, Brown CA, Porter HL, Giles CB, Wren JD.",
"doi": "10.3389/frai.2024.1366273",
"position": 1
}
],
"developer": [
{
"title": "PR: feat(vector-db): add Qdrant vector database support (#273)",
"url": "https://github.com/arakoodev/EdgeChains/pull/706",
"description": "[arakoodev/EdgeChains] (open) ### Summary Adds native support for Qdrant vector database in EdgeChains JavaScript SDK ...",
"date": "2026-10-23T18:27:57Z",
"source": "GitHub",
"authors": "EverVio",
"position": 1
}
],
"nextPageTokens": {
"news": "v1.VUzJypAoYmbNxbMXHm6thxeI-fh1K03YfG2sDRSpPMUkca0e1s7XH51ago1JorLtdr1Y...",
"research": "v1.7Z_R06S8ieWzHJGARfWbvv1lRZ7JsGK7ZG6ZYzdCp-8AQYw3lBHqRSWN6rIFPq_Eso...",
"developer": "v1.SETjbw0J45NTTGqGPawGMXr7JL9d0uzIfW6nq4fZrIXUF1vb_9oHTi4hwi0VgCTqPP3j..."
}
},
"stats": {
"durationMs": 20019
},
"logUuid": "6ec30fde-ea19-45cf-8c88-10f2c41d5cae"
},
"error": null
}Search
Get a search
Returns a search’s status and, once it has finished, its results. Poll every 2 to 5 seconds until status is completed or failed. Polling is free and has no rate limit.
A search that found nothing still completes, with success: false and empty lists, and costs nothing. A failed or cancelled search answers 200 with status: "failed" and the reason in error, and you aren’t charged.
A finished search stays here for about an hour, and a failed one for 24 hours. After that this returns 404, and the search is still in your search logs.
GET
/
search
/
{jobId}
Get a search
curl --request GET \
--url https://api.spidra.io/api/search/{jobId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.spidra.io/api/search/{jobId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.spidra.io/api/search/{jobId}', 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.spidra.io/api/search/{jobId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.spidra.io/api/search/{jobId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.spidra.io/api/search/{jobId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.spidra.io/api/search/{jobId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": "completed",
"progress": {
"message": "Search completed successfully",
"progress": 1
},
"result": {
"success": true,
"data": {
"news": [
{
"title": "VCs are obsessed with vector databases. Here are seven AI startups in the space that have raised millions from investors.",
"url": "https://www.businessinsider.com/seven-vector-database-startups-poised-to-win-ai-revolution-2024-4",
"description": "Vector databases don't get as much love as their flashier counterparts ...",
"source": "Business Insider",
"date": "3 years ago",
"position": 1
}
],
"research": [
{
"title": "BioVDB: biological vector database for high-throughput gene expression meta-analysis.",
"url": "https://doi.org/10.3389/frai.2024.1366273",
"description": "High-throughput sequencing has created an exponential increase in the amount of gene expression data ...",
"date": "2024-03-08",
"source": "PubMed",
"authors": "Winnicki MJ, Brown CA, Porter HL, Giles CB, Wren JD.",
"doi": "10.3389/frai.2024.1366273",
"position": 1
}
],
"developer": [
{
"title": "PR: feat(vector-db): add Qdrant vector database support (#273)",
"url": "https://github.com/arakoodev/EdgeChains/pull/706",
"description": "[arakoodev/EdgeChains] (open) ### Summary Adds native support for Qdrant vector database in EdgeChains JavaScript SDK ...",
"date": "2026-10-23T18:27:57Z",
"source": "GitHub",
"authors": "EverVio",
"position": 1
}
],
"nextPageTokens": {
"news": "v1.VUzJypAoYmbNxbMXHm6thxeI-fh1K03YfG2sDRSpPMUkca0e1s7XH51ago1JorLtdr1Y...",
"research": "v1.7Z_R06S8ieWzHJGARfWbvv1lRZ7JsGK7ZG6ZYzdCp-8AQYw3lBHqRSWN6rIFPq_Eso...",
"developer": "v1.SETjbw0J45NTTGqGPawGMXr7JL9d0uzIfW6nq4fZrIXUF1vb_9oHTi4hwi0VgCTqPP3j..."
}
},
"stats": {
"durationMs": 20019
},
"logUuid": "6ec30fde-ea19-45cf-8c88-10f2c41d5cae"
},
"error": null
}Authorizations
BearerAuthApiKeyAuth
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The jobId returned by POST /search.
Response
The search's status, and its result once it has finished.
waiting: queued, not started yet.delayed: waiting to be retried after a temporary problem.active: running.progress.messagesays what it's doing.completed: finished. The result is inresult.failed: couldn't be done.errorsays why, and you aren't charged.
Available options:
waiting, delayed, active, completed, failed Show child attributes
Show child attributes
The result once status is completed. null before that.
Show child attributes
Show child attributes
Why the search failed once status is failed, such as "Search cancelled". null otherwise.
Was this page helpful?