Get search result
Check the status of a search and retrieve the result once it completes.
GET
/
api
/
v1
/
search
/
{id}
Get search result
curl --request GET \
--url https://developer.thehog.ai/api/v1/search/{id} \
--header 'X-Access-Key: <api-key>' \
--header 'X-Secret-Key: <api-key>'const options = {
method: 'GET',
headers: {'X-Access-Key': '<api-key>', 'X-Secret-Key': '<api-key>'}
};
fetch('https://developer.thehog.ai/api/v1/search/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://developer.thehog.ai/api/v1/search/{id}"
headers = {
"X-Access-Key": "<api-key>",
"X-Secret-Key": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text){
"id": "<string>",
"status": "queued",
"type": "web_search",
"query": "<string>",
"created_at": "<string>",
"poll_url": "<string>",
"results": [
{
"url": "<string>",
"title": "<string>",
"content": "<string>",
"published_at": "<string>",
"author_name": "<string>",
"author_headline": "<string>",
"id": "<string>",
"platform_video_id": "<string>",
"post_url": "<string>",
"author_username": "<string>"
}
],
"total_results": 123,
"error": {
"message": "<string>",
"retryable": true
},
"completed_at": "<string>"
}{
"statusCode": 401,
"error": "Unauthorized",
"message": "Authentication is required.",
"path": "/api/v1/search",
"timestamp": "2026-05-21T09:08:10.000Z",
"requestId": "506af9b3-01a9-43be-9eb4-8458fe3e4f5b"
}{
"statusCode": 404,
"error": "Not Found",
"message": "Resource not found.",
"path": "/api/v1/search",
"timestamp": "2026-05-21T09:08:10.000Z",
"requestId": "506af9b3-01a9-43be-9eb4-8458fe3e4f5b"
}{
"statusCode": 429,
"error": "Too Many Requests",
"message": "Too many requests.",
"path": "/api/v1/search",
"timestamp": "2026-05-21T09:08:10.000Z",
"requestId": "506af9b3-01a9-43be-9eb4-8458fe3e4f5b"
}{
"statusCode": 500,
"error": "Internal Server Error",
"message": "An unexpected error occurred.",
"path": "/api/v1/search",
"timestamp": "2026-05-21T09:08:10.000Z",
"requestId": "506af9b3-01a9-43be-9eb4-8458fe3e4f5b"
}GET /api/v1/search/:id
Poll for search results.Poll for results of a search submitted via
POST /api/v1/search.
Example
curl https://developer.thehog.ai/api/v1/search/srch_01HZXYZ \
-H "X-Access-Key: ak_xxxxxxxxxxxxxxxx" \
-H "X-Secret-Key: sk_xxxxxxxxxxxxxxxx"
Authorizations
The public API key from the Credentials page.
The API secret shown when the credential is created.
Path Parameters
Search ID.
Response
Current search status, progress, result, or error.
Unique search result ID
Current status
Available options:
queued, processing, succeeded, failed Search type
Available options:
web_search, site_search, linkedin_keyword, x_keyword, reddit_search, tiktok_keyword, tiktok_hashtag Original query
ISO timestamp of creation
URL to poll for result
Search results array
Show child attributes
Show child attributes
Total results found
Error details when failed
Show child attributes
Show child attributes
ISO timestamp of completion
⌘I
Get search result
curl --request GET \
--url https://developer.thehog.ai/api/v1/search/{id} \
--header 'X-Access-Key: <api-key>' \
--header 'X-Secret-Key: <api-key>'const options = {
method: 'GET',
headers: {'X-Access-Key': '<api-key>', 'X-Secret-Key': '<api-key>'}
};
fetch('https://developer.thehog.ai/api/v1/search/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://developer.thehog.ai/api/v1/search/{id}"
headers = {
"X-Access-Key": "<api-key>",
"X-Secret-Key": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text){
"id": "<string>",
"status": "queued",
"type": "web_search",
"query": "<string>",
"created_at": "<string>",
"poll_url": "<string>",
"results": [
{
"url": "<string>",
"title": "<string>",
"content": "<string>",
"published_at": "<string>",
"author_name": "<string>",
"author_headline": "<string>",
"id": "<string>",
"platform_video_id": "<string>",
"post_url": "<string>",
"author_username": "<string>"
}
],
"total_results": 123,
"error": {
"message": "<string>",
"retryable": true
},
"completed_at": "<string>"
}{
"statusCode": 401,
"error": "Unauthorized",
"message": "Authentication is required.",
"path": "/api/v1/search",
"timestamp": "2026-05-21T09:08:10.000Z",
"requestId": "506af9b3-01a9-43be-9eb4-8458fe3e4f5b"
}{
"statusCode": 404,
"error": "Not Found",
"message": "Resource not found.",
"path": "/api/v1/search",
"timestamp": "2026-05-21T09:08:10.000Z",
"requestId": "506af9b3-01a9-43be-9eb4-8458fe3e4f5b"
}{
"statusCode": 429,
"error": "Too Many Requests",
"message": "Too many requests.",
"path": "/api/v1/search",
"timestamp": "2026-05-21T09:08:10.000Z",
"requestId": "506af9b3-01a9-43be-9eb4-8458fe3e4f5b"
}{
"statusCode": 500,
"error": "Internal Server Error",
"message": "An unexpected error occurred.",
"path": "/api/v1/search",
"timestamp": "2026-05-21T09:08:10.000Z",
"requestId": "506af9b3-01a9-43be-9eb4-8458fe3e4f5b"
}