---
title: "Search by Keyword"
method: GET
path: "/v1/scrape/threads/search"
tags: ["threads"]
---

# Search by Keyword

`GET /v1/scrape/threads/search`

## Request

- Base URL: `https://api.sociavault.com`
- URL: `https://api.sociavault.com/v1/scrape/threads/search`
- Auth: API key in header `X-API-Key`

Search Threads posts by keyword. Returns 20–30 results per request due to platform constraints.

## Query parameters

- `query` string, required
- `trim` boolean

## Response `200`

Successful response

- object
  - `success` boolean, required
  - `posts` object[], required
    - `id` string, required
    - `pk` string, required
    - `user` object, required
      - `friendship_status` unknown
      - `pk` string, required
      - `profile_pic_url` string, required
      - `username` string, required
      - `id` string, required
      - `transparency_label` unknown
      - `transparency_product` unknown
      - `transparency_product_enabled` boolean, required
      - `is_verified` boolean, required
      - `text_post_app_is_private` boolean, required
      - `has_onboarded_to_text_post_app` boolean, required
    - `text_post_app_info` object, required
      - `show_header_follow` unknown
      - `is_markup` unknown
      - `custom_feed_preview_info` unknown
      - `link_preview_attachment` unknown
      - `linked_inline_media` unknown
      - `special_effects_enabled_str` string, required
      - `text_fragments` object, required
        - `fragments` object[], required
          - `fragment_type` string, required
          - `link_fragment` unknown
          - `mention_fragment` unknown
          - `plaintext` string, required
          - `tag_fragment` unknown
          - `linkified_web_url` unknown
          - `styling_info` unknown
      - `reshare_count` integer, required
      - `direct_reply_count` integer, required
      - `repost_count` integer, required
      - `quote_count` integer, required
      - `share_info` object, required
        - `quoted_attachment_author_attribution_allowed` boolean, required
        - `quoted_attachment_post_unavailable` boolean, required
        - `quoted_attachment_post` unknown
        - `quoted_post` unknown
        - `reposted_post` unknown
      - `reply_to_author` unknown
      - `reply_control` string, required
      - `private_reply_partner` unknown
      - `self_thread_count` unknown
      - `tag_header` unknown
      - `root_post_author` unknown
      - `pinned_post_info` unknown
      - `related_trends_info` unknown
      - `is_reply` boolean, required
      - `is_post_unavailable` boolean, required
      - `post_unavailable_reason` unknown
      - `hush_info` unknown
    - `is_paid_partnership` unknown
    - `audio` unknown
    - `caption` object, required
      - `text` string, required
      - `pk` string, required
      - `has_translation` unknown
    - `caption_is_edited` boolean, required
    - `transcription_data` unknown
    - `carousel_media` unknown
    - `code` string, required
    - `image_versions2` object, required
      - `candidates` unknown[], required
        - unknown
    - `original_height` integer, required
    - `original_width` integer, required
    - `accessibility_caption` unknown
    - `video_versions` unknown
    - `has_audio` unknown
    - `media_type` integer, required
    - `caption_add_on` unknown
    - `giphy_media_info` unknown
    - `media_overlay_info` unknown
    - `sharing_friction_info` object, required
      - `should_have_sharing_friction` boolean, required
      - `sharing_friction_payload` unknown
    - `like_count` integer, required
    - `metaPlace` unknown
    - `meta_place` unknown
    - `gen_ai_detection_method` unknown
    - `taken_at` integer, required
    - `organic_tracking_token` string, required
    - `logging_info_token` unknown
    - `like_and_view_counts_disabled` boolean, required

## Other responses

- `400`: Bad Request - Invalid parameters or missing required fields
- `401`: Unauthorized - Invalid or missing API key
- `402`: Payment Required - Insufficient credits
- `500`: Internal Server Error - Service configuration or processing error

---

[API](https://skmtc.dev/sociavault/apis/sociavault-api.md) · [All operations](https://skmtc.dev/sociavault/apis/sociavault-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sociavault/apis/sociavault-api/revisions/0a430c97f53a?raw)