---
title: "Get search result"
method: GET
path: "/api/v1/search/{id}"
tags: ["Search"]
---

# Get search result

`GET /api/v1/search/{id}`

Check the status of a search and retrieve the result once it completes.

## Path parameters

- `id` string, required

## Response `200`

Current search status, progress, result, or error.

- SearchResultDto
  - `id` string, required — Unique search result ID
  - `status` 'queued' | 'processing' | 'succeeded' | 'failed', required — Current status
  - `type` 'web_search' | 'site_search' | 'linkedin_keyword' | 'x_keyword' | 'reddit_search' | 'tiktok_keyword' | 'tiktok_hashtag', required — Search type
  - `query` string, required — Original query
  - `poll_url` string — URL to poll for result
  - `results` SearchResultItemDto[], nullable — Search results array
    - `url` string, required — Result URL
    - `title` string, required — Result title
    - `content` string, nullable — Content snippet or post text
    - `published_at` string, nullable — Published date (ISO)
    - `author_name` string, nullable — Author name (LinkedIn)
    - `author_headline` string, nullable — Author headline (LinkedIn)
    - `id` string, nullable — Source-native stable entity ID, when available
    - `platform_video_id` string, nullable — Source-native stable post/video/activity ID, when available
    - `post_url` string, nullable — Source-native canonical post URL, when available
    - `author_username` string, nullable — Author handle or username, when available
  - `total_results` number, nullable — Total results found
  - `error` SearchErrorDto
    - `message` string, required — Safe error message
    - `retryable` boolean, required — Whether retrying the search may succeed
  - `created_at` string, required — ISO timestamp of creation
  - `completed_at` string, nullable — ISO timestamp of completion

## Other responses

- `401` — Authentication is required.
- `404` — The requested resource was not found.
- `429` — Too many requests. Slow down before retrying.
- `500` — An unexpected error occurred.

---

[API](https://skmtc.net/thehog/apis/the-hog-api.md) · [All operations](https://skmtc.net/thehog/apis/the-hog-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thehog/the-hog-api/revisions/f5056017668a/schema)