---
title: "List searches"
method: GET
path: "/api/v1/search"
tags: ["Search"]
---

# List searches

`GET /api/v1/search`

List previous searches for your organization.

## Query parameters

- `type` unknown
- `limit` number
- `cursor` unknown

## Response `200`

Searches with pagination.

- SearchListResponseDto
  - `data` SearchResultDto[], required
    - `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
  - `next_cursor` string, nullable

## Other responses

- `401` — Authentication is required.
- `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)