> ## Documentation Index > Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt > Use this file to discover all available pages before exploring further. # Search by Keyword > Search Threads posts by keyword. Returns 20–30 results per request due to platform constraints. 💳 **1 credit** per request ## OpenAPI ````yaml GET /v1/scrape/threads/search openapi: 3.1.0 info: title: SociaVault API version: 1.0.0 description: >- # SociaVault API Documentation The SociaVault API provides comprehensive access to social media data extraction across multiple platforms. ## Features - **Multi-Platform Support**: TikTok, Instagram, YouTube, Facebook, Twitter, Reddit, Threads, and more - **Credit-Based System**: Pay-as-you-go pricing with transparent credit costs - **High Performance**: Fast, reliable data extraction - **Comprehensive Data**: Detailed user profiles, videos, posts, comments, and analytics ## Authentication All API requests require authentication using an API key in the `X-API-Key` header: ```bash X-API-Key: sk_live_your_api_key_here ``` Get your API key from the [SociaVault Dashboard](https://sociavault.com/dashboard). ## Credits Each endpoint consumes credits based on data complexity: - Simple requests (profiles): 1 credit - Complex requests (demographics): 20+ credits - Paginated requests: Credits per page Check your credit balance in the dashboard or via the API. ## Support - **Documentation**: https://docs.sociavault.com - **Email**: support@sociavault.com - **Discord**: https://discord.gg/sociavault contact: name: SociaVault Support email: support@sociavault.com url: https://sociavault.com/support license: name: Commercial url: https://sociavault.com/terms servers: - url: https://api.sociavault.com description: Production API security: - ApiKeyAuth: [] tags: - name: account description: Account management and credit balance externalDocs: description: Learn more url: https://docs.sociavault.com/account - name: tiktok description: Scrape TikTok profiles, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok - name: tiktok-shop description: Everything about TikTok Shop externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok-shop - name: instagram description: Gets Instagram profiles, posts, and reels externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/instagram - name: youtube description: Scrape YouTube channels, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/youtube - name: linkedin description: Scrape LinkedIn externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedin - name: facebook description: Get public Facebook profiles and posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebook - name: facebookAdLibrary description: Scrapes the Facebook (Meta) Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookAdLibrary - name: facebookMarketplace description: Search Facebook Marketplace and pull full listing details externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookMarketplace - name: googleAdLibrary description: >- Scrape the Google Ad Transparency Library. *This only gets the public ads. Some ads you need to log in for and sadly we can't get those. Also, since there are so many variations, the return types might not all be 100% the same. externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/googleAdLibrary - name: linkedinAdLibrary description: Search the LinkedIn Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedinAdLibrary - name: twitter description: Get Twitter profiles, tweets, followers and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/twitter - name: reddit description: Scrape Reddit posts and comments externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/reddit - name: threads description: Get Threads posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/threads - name: google description: Scrape Google search results externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/google paths: /v1/scrape/threads/search: get: tags: - threads summary: Search by Keyword description: >- Search Threads posts by keyword. Returns 20–30 results per request due to platform constraints. operationId: threads_Search_by_Keyword parameters: - name: query in: query description: Keyword to search for required: true schema: type: string example: basketball - name: trim in: query description: Set to true for a trimmed down version of the response required: false schema: type: boolean example: false responses: '200': description: |- Successful response **Key Response Fields:** - `posts[n].id`: Post unique ID - `posts[n].user.username`: Author Threads handle - `posts[n].user.is_verified`: Author verification status - `posts[n].caption.text`: Post text content - `posts[n].like_count`: Like count - `posts[n].taken_at`: Unix timestamp - `posts[n].text_post_app_info.reshare_count`: Reshare count - `posts[n].text_post_app_info.direct_reply_count`: Reply count - `posts[n].code`: Post short code content: application/json: schema: type: object properties: success: type: boolean example: true posts: type: array items: type: object properties: id: type: string example: '3623717915788120086_63263616227' pk: type: string example: '3623717915788120086' user: type: object properties: friendship_status: type: 'null' pk: type: string example: '63263616227' profile_pic_url: type: string example: >- https://instagram.fcae1-1.fna.fbcdn.net/v/t51.2885-19/482795192_3376548399146227_6340123271493467395_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=instagram.fcae1-1.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2QFfhhbPZWsd0GfT28z5WO_4qqp0J0TZeg_2rJ1msbR_DS_f6Lu6JdkORdUt7DIkVes&_nc_ohc=SCH32yXVc04Q7kNvwHfg6hS&_nc_gid=DuGtmKyvvrTkwZuS-75tqg&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfEGgKt7JWHgrAUYwyj3koqHwPnipcqDXEiz-YsAN4c3Fg&oe=681B5320&_nc_sid=10d13b username: type: string example: shams id: type: string example: '63263616227' transparency_label: type: 'null' transparency_product: type: 'null' transparency_product_enabled: type: boolean example: false is_verified: type: boolean example: true text_post_app_is_private: type: boolean example: false has_onboarded_to_text_post_app: type: boolean example: true required: - pk - profile_pic_url - username - id - transparency_product_enabled - is_verified - text_post_app_is_private - has_onboarded_to_text_post_app text_post_app_info: type: object properties: show_header_follow: type: 'null' is_markup: type: 'null' custom_feed_preview_info: type: 'null' link_preview_attachment: type: 'null' linked_inline_media: type: 'null' special_effects_enabled_str: type: string example: '' text_fragments: type: object properties: fragments: type: array items: type: object properties: fragment_type: type: string example: plaintext link_fragment: type: 'null' mention_fragment: type: 'null' plaintext: type: string example: >- BREAKING: Gregg Popovich will no longer be Head Coach of the San Antonio Spurs and is transitioning full-time to Team President, sources told ESPN. The iconic Popovich is a Basketball Hall of Famer, the NBA’s all-time winningest coach, and led the Spurs to five championships. tag_fragment: type: 'null' linkified_web_url: type: 'null' styling_info: type: 'null' required: - fragment_type - plaintext required: - fragments reshare_count: type: integer example: 260 direct_reply_count: type: integer example: 75 repost_count: type: integer example: 200 quote_count: type: integer example: 59 share_info: type: object properties: quoted_attachment_author_attribution_allowed: type: boolean example: true quoted_attachment_post_unavailable: type: boolean example: false quoted_attachment_post: type: 'null' quoted_post: type: 'null' reposted_post: type: 'null' required: - quoted_attachment_author_attribution_allowed - quoted_attachment_post_unavailable reply_to_author: type: 'null' reply_control: type: string example: everyone private_reply_partner: type: 'null' self_thread_count: type: 'null' tag_header: type: 'null' root_post_author: type: 'null' pinned_post_info: type: 'null' related_trends_info: type: 'null' is_reply: type: boolean example: false is_post_unavailable: type: boolean example: false post_unavailable_reason: type: 'null' hush_info: type: 'null' required: - special_effects_enabled_str - text_fragments - reshare_count - direct_reply_count - repost_count - quote_count - share_info - reply_control - is_reply - is_post_unavailable is_paid_partnership: type: 'null' audio: type: 'null' caption: type: object properties: text: type: string example: >- BREAKING: Gregg Popovich will no longer be Head Coach of the San Antonio Spurs and is transitioning full-time to Team President, sources told ESPN. The iconic Popovich is a Basketball Hall of Famer, the NBA’s all-time winningest coach, and led the Spurs to five championships. pk: type: string example: '17901829044168955' has_translation: type: 'null' required: - text - pk caption_is_edited: type: boolean example: false transcription_data: type: 'null' carousel_media: type: 'null' code: type: string example: DJKCD7AxRAW image_versions2: type: object properties: candidates: type: array items: {} required: - candidates original_height: type: integer example: 612 original_width: type: integer example: 612 accessibility_caption: type: 'null' video_versions: type: 'null' has_audio: type: 'null' media_type: type: integer example: 19 caption_add_on: type: 'null' giphy_media_info: type: 'null' media_overlay_info: type: 'null' sharing_friction_info: type: object properties: should_have_sharing_friction: type: boolean example: false sharing_friction_payload: type: 'null' required: - should_have_sharing_friction like_count: type: integer example: 4093 metaPlace: type: 'null' meta_place: type: 'null' gen_ai_detection_method: type: 'null' taken_at: type: integer example: 1746200860 organic_tracking_token: type: string example: >- eyJ2ZXJzaW9uIjo1LCJwYXlsb2FkIjp7ImlzX2FuYWx5dGljc190cmFja2VkIjp0cnVlLCJ1dWlkIjoiYjgzMzc1NDA2MzU4NDg2OGIyMTFlZDc0NDZkYjdiNDUzNjIzNzE3OTE1Nzg4MTIwMDg2In0sInNpZ25hdHVyZSI6IiJ9 logging_info_token: type: 'null' like_and_view_counts_disabled: type: boolean example: false required: - id - pk - user - text_post_app_info - caption - caption_is_edited - code - image_versions2 - original_height - original_width - media_type - sharing_friction_info - like_count - taken_at - organic_tracking_token - like_and_view_counts_disabled required: - success - posts examples: full: summary: Full Response value: success: true posts: - id: '3623717915788120086_63263616227' pk: '3623717915788120086' user: friendship_status: null pk: '63263616227' profile_pic_url: >- https://instagram.fcae1-1.fna.fbcdn.net/v/t51.2885-19/482795192_3376548399146227_6340123271493467395_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=instagram.fcae1-1.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2QFfhhbPZWsd0GfT28z5WO_4qqp0J0TZeg_2rJ1msbR_DS_f6Lu6JdkORdUt7DIkVes&_nc_ohc=SCH32yXVc04Q7kNvwHfg6hS&_nc_gid=DuGtmKyvvrTkwZuS-75tqg&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfEGgKt7JWHgrAUYwyj3koqHwPnipcqDXEiz-YsAN4c3Fg&oe=681B5320&_nc_sid=10d13b username: shams id: '63263616227' transparency_label: null transparency_product: null transparency_product_enabled: false is_verified: true text_post_app_is_private: false has_onboarded_to_text_post_app: true text_post_app_info: show_header_follow: null is_markup: null custom_feed_preview_info: null link_preview_attachment: null linked_inline_media: null special_effects_enabled_str: '' text_fragments: fragments: - fragment_type: plaintext link_fragment: null mention_fragment: null plaintext: >- BREAKING: Gregg Popovich will no longer be Head Coach of the San Antonio Spurs and is transitioning full-time to Team President, sources told ESPN. The iconic Popovich is a Basketball Hall of Famer, the NBA’s all-time winningest coach, and led the Spurs to five championships. tag_fragment: null linkified_web_url: null styling_info: null reshare_count: 260 direct_reply_count: 75 repost_count: 200 quote_count: 59 share_info: quoted_attachment_author_attribution_allowed: true quoted_attachment_post_unavailable: false quoted_attachment_post: null quoted_post: null reposted_post: null reply_to_author: null reply_control: everyone private_reply_partner: null self_thread_count: null tag_header: null root_post_author: null pinned_post_info: null related_trends_info: null is_reply: false is_post_unavailable: false post_unavailable_reason: null hush_info: null is_paid_partnership: null audio: null caption: text: >- BREAKING: Gregg Popovich will no longer be Head Coach of the San Antonio Spurs and is transitioning full-time to Team President, sources told ESPN. The iconic Popovich is a Basketball Hall of Famer, the NBA’s all-time winningest coach, and led the Spurs to five championships. pk: '17901829044168955' has_translation: null caption_is_edited: false transcription_data: null carousel_media: null code: DJKCD7AxRAW image_versions2: candidates: [] original_height: 612 original_width: 612 accessibility_caption: null video_versions: null has_audio: null media_type: 19 caption_add_on: null giphy_media_info: null media_overlay_info: null sharing_friction_info: should_have_sharing_friction: false sharing_friction_payload: null like_count: 4093 metaPlace: null meta_place: null gen_ai_detection_method: null taken_at: 1746200860 organic_tracking_token: >- eyJ2ZXJzaW9uIjo1LCJwYXlsb2FkIjp7ImlzX2FuYWx5dGljc190cmFja2VkIjp0cnVlLCJ1dWlkIjoiYjgzMzc1NDA2MzU4NDg2OGIyMTFlZDc0NDZkYjdiNDUzNjIzNzE3OTE1Nzg4MTIwMDg2In0sInNpZ25hdHVyZSI6IiJ9 logging_info_token: null like_and_view_counts_disabled: false trimmed: summary: Trimmed Response (when trim=true) value: success: true posts: - id: '3658605407757558624_71259204903' pk: '3658605407757558624' caption: text: >- This woman selling mini umbrellas shows love to stray cats & dogs & introduces them. She may not have money but is richer than many.🥹🥹 pk: '18077403781726333' has_translation: null code: DLF-jv2tmNg like_count: 5419 taken_at: 1750359780 user: pk: '71259204903' friendship_status: null profile_pic_url: >- https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-19/501402907_17869607802372904_1939177145792832486_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QHQ6tqymzxxWWnD3Y69dUStiwPULqhvwrOx1_1jXHmGEOp8LBdxfOkihhVQW0v5NsY&_nc_ohc=FICE0ht7dSAQ7kNvwEXdDzp&_nc_gid=C_fAfqKQ2OEy746wTYa0sw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfPyuWIMTTIwpoiGW4059hDGkyKRW8eVZbUH1Zfzd2xxRw&oe=685AA184&_nc_sid=10d13b username: mahtabuddinit id: '71259204903' full_name: Mahtab Uddin transparency_label: null transparency_product: null transparency_product_enabled: false is_verified: false text_post_app_is_private: false has_onboarded_to_text_post_app: true - id: '3658620429170515719_73362155129' pk: '3658620429170515719' caption: text: |- Are you a dog lover or a cat lover? Personally i love both DOGS OR CATS? pk: '18065623148118808' has_translation: null code: DLGB-Vosh8H like_count: 53 taken_at: 1750361563 user: pk: '73362155129' friendship_status: null profile_pic_url: >- https://scontent-dfw5-1.cdninstagram.com/v/t51.2885-19/487344284_1018731380219067_7461786811198236347_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=103&_nc_oc=Q6cZ2QHQ6tqymzxxWWnD3Y69dUStiwPULqhvwrOx1_1jXHmGEOp8LBdxfOkihhVQW0v5NsY&_nc_ohc=k2R-PjUq_SoQ7kNvwGggBYz&_nc_gid=C_fAfqKQ2OEy746wTYa0sw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfO3uZE6D7z0-2ZAYtkLBVhsHW8e5S9rhji9n0un3yl94A&oe=685AA8A4&_nc_sid=10d13b username: elonreevemusk_1950 id: '73362155129' full_name: CEO Elon Musk transparency_label: null transparency_product: null transparency_product_enabled: false is_verified: false text_post_app_is_private: false has_onboarded_to_text_post_app: true '400': description: Bad Request - Invalid parameters or missing required fields content: application/json: schema: type: object properties: error: type: string example: 'Missing required parameter: handle' endpoint: type: string credits_required: type: integer required: - error '401': description: Unauthorized - Invalid or missing API key content: application/json: schema: type: object properties: error: type: string example: Invalid API key docs: type: string example: https://docs.sociavault.com/authentication required: - error '402': description: Payment Required - Insufficient credits content: application/json: schema: type: object properties: error: type: string example: Insufficient credits required: type: integer example: 1 description: Credits required for this request available: type: integer example: 0 description: Credits currently available required: - error - required - available '500': description: Internal Server Error - Service configuration or processing error content: application/json: schema: type: object properties: error: type: string example: Service configuration error required: - error components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: |- API key for authentication. Format: `sk_live_xxxxxxxxxxxxx` Get your API key from the [Dashboard](https://sociavault.com/dashboard). ````