> ## 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. # Hashtag Videos by ID > Gets the videos for a TikTok hashtag by its numeric hashtag ID. Use it when [Search by Hashtag](https://docs.sociavault.com/api-reference/tiktok/search-hashtag) returns "TikTok did not return an exact match for this hashtag" for a hashtag that's in use. Any video that uses the hashtag has its ID in `text_extra[].hashtag_id`, for example in [Search by Keyword](https://docs.sociavault.com/api-reference/tiktok/search-keyword) results. The response has the same format as Search by Hashtag, without `is_ad`, `is_paid_partnership`, `is_eligible_for_commission` and `shop_product_url`. πŸ’³ **1 credit** per request. Pages with no videos are free. ## OpenAPI ````yaml GET /v1/scrape/tiktok/hashtag/videos 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/tiktok/hashtag/videos: get: tags: - tiktok summary: Hashtag Videos by ID description: >- Gets the videos for a TikTok hashtag by its numeric hashtag ID. Use it when [Search by Hashtag](https://docs.sociavault.com/api-reference/tiktok/search-hashtag) returns "TikTok did not return an exact match for this hashtag" for a hashtag that's in use. Any video that uses the hashtag has its ID in `text_extra[].hashtag_id`, for example in [Search by Keyword](https://docs.sociavault.com/api-reference/tiktok/search-keyword) results. The response has the same format as Search by Hashtag, without `is_ad`, `is_paid_partnership`, `is_eligible_for_commission` and `shop_product_url`. operationId: tiktok_Hashtag_Videos_by_ID parameters: - name: hashtag_id in: query description: >- The hashtag's numeric ID. Any video that uses the hashtag has it in `text_extra[].hashtag_id`. required: true schema: type: string example: '6297854' - name: cursor in: query description: Cursor to get more videos. Get 'cursor' from previous response. required: false schema: type: integer example: 20 responses: '200': description: >- Successful response **Key Response Fields:** - `data.aweme_list[].aweme_id`: Video ID - `data.aweme_list[].url`: Link to the video on TikTok - `data.aweme_list[].desc`: Caption text (includes hashtags) - `data.aweme_list[].create_time`: Unix timestamp of when the video was posted - `data.aweme_list[].create_time_utc`: The same time as an ISO date - `data.aweme_list[].statistics.play_count`: Total views - `data.aweme_list[].statistics.digg_count`: Likes - `data.aweme_list[].statistics.comment_count`: Comments - `data.aweme_list[].statistics.share_count`: Shares - `data.aweme_list[].statistics.collect_count`: Bookmarks/saves - `data.aweme_list[].video.play_addr.url_list[0]`: Video playback URL - `data.aweme_list[].video.cover.url_list[0]`: Thumbnail image URL - `data.aweme_list[].video.duration`: Video duration in milliseconds - `data.aweme_list[].author.unique_id`: Author's TikTok username - `data.aweme_list[].author.nickname`: Author's display name - `data.aweme_list[].music.title`: Sound title - `data.aweme_list[].text_extra[].hashtag_id`: IDs of the hashtags in the caption - `data.cursor`: Pagination cursor. Pass it as `cursor` to get the next page - `data.has_more`: `1` while the page returned videos. Keep paging until a page comes back empty; empty pages are free content: application/json: examples: trimmed: summary: Response (fields trimmed for length) value: success: true data: status_code: 0 aweme_list: - aweme_id: '7696101681305488670' desc: >- From Michael Jackson and Prince to BeyoncΓ©, Rihanna, and Bad Bunny! 🎀πŸ”₯ The Super Bowl halftime show has given us some of the most iconic performances in music history. Which year had the BEST halftime show? πŸ‘€πŸˆ Don't follow the crowd β€” drop your favorite in the comments! πŸ‘‡#SuperBowl #HalftimeShow #SuperBowlHalftime #IconicPerformances #NFL desc_language: en region: US create_time: 1791888353 create_time_utc: '2026-10-13T10:45:53.000Z' url: >- https://www.tiktok.com/@clipvisre_/video/7696101681305488670 statistics: aweme_id: '7696101681305488670' collect_count: 3 comment_count: 1 digg_count: 66 download_count: 0 forward_count: 0 lose_comment_count: 0 lose_count: 0 play_count: 2008 repost_count: 0 share_count: 1 whatsapp_share_count: 0 author: uid: '7670401639165592589' unique_id: clipvisre_ nickname: Lordwort sec_uid: >- MS4wLjABAAAAwe4K4FFylocBeS9weNynmZSUCFeP8b4HMNChP3cQ_zR1oNYZAYFzEQpEZH9CTg1v follower_count: 0 signature: '' video: duration: 206287 cover: url_list: - >- https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/oEecjV33nWqIIFA4IAQPzfbeXLVA9LQGGuqCwB~tplv-tiktokx-origin.image?dr=1347&refresh_token=83f0a06d&x-expires=1791990000&x-signature=BrLAiTnfVMi2nHCGvQVMCIeWv7Y%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=c0f880ed&idc=no1a&biz_tag=tt_video&s=CHALLENGE_AWEME&sc=cover play_addr: url_list: - >- https://v45.tiktokcdn-eu.com/f32d30c450a990ec980e3a20fb8d782e/6acfa5a9/video/tos/alisg/tos-alisg-ve-37c799-sg/oARORqt7zz1EEDlqEAEbZftfrFRASFIDQ3VB4g/?a=1233&bti=Ojs2NGYpQHM6OjZALjU2OmQvcCMxNDNg&&bt=1804&ft=td_Ls8s6oA-O12NvCBRezIxRIQx0~3_45SY&mime_type=video_mp4&rc=aDRlZTZpNTc3ZTU7Ojk0NEBpM3Nxd3k5cnQzZTMzaTczNEA0MDE2MDFhNWAxMGNeXy5jYSNwYjVxMmRzajRhLS1kMTJzcw%3D%3D&vvpl=1&l=20261013155051B222E4100DF0F21FBE37&btag=e0009d000 music: id_str: '7696101930128509726' title: original sound - clipvisre_ author: Lordwort text_extra: - hashtag_id: '9484' hashtag_name: superbowl - hashtag_id: '8968' hashtag_name: halftimeshow - hashtag_id: '6297854' hashtag_name: superbowlhalftime cursor: 20 has_more: 1 credits_used: 1 endpoint: tiktok/hashtag_videos '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 '404': description: Not Found - No videos for this hashtag ID content: application/json: schema: type: object properties: error: type: string example: >- No videos found for this hashtag_id. It should be the text_extra[].hashtag_id from a video that uses the hashtag. endpoint: type: string example: hashtag_videos required: - error '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). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.