{"uid":"cap_E4amNObPr1YUwpMm2_zvB","slug":"sociavault-tiktok-popular-music-rankings-f03d2000","name":"SociaVault TikTok Popular Music Rankings","description":"SociaVault social data ingest — profile, posts, transcript, and full API proxy. One x402 payment per outcome.","url":"https://social.gedx402.com/v1/sociavault/tiktok/music/popular","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"page":{"type":"integer"},"rankType":{"type":"string"},"newOnBoard":{"type":"boolean"},"timePeriod":{"type":"string"},"countryCode":{"type":"string"},"commercialMusic":{"type":"boolean"}}},"responseSchema":{"type":"json","example":{"data":{},"success":true,"provider":"sociavault"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.038","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.038/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.038","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.038","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8TKaXD7Q6aI7utd2r8h-s","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.038","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a ranked list of popular TikTok music tracks, filterable by time period, country, rank type, and commercial music status.","exampleAgentPrompt":"Show me page 1 of the top-ranked popular TikTok music in the US for the past 7 days, including only commercial music that's newly on board, using SociaVault's TikTok music charts.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a success flag, provider name ('sociavault'), and a data payload containing paginated popular TikTok music tracks ranked according to the specified filters (rank type, time period, country, commercial status, new entries).","failureModes":["Invalid countryCode returns empty results or error","Unsupported rankType or timePeriod string yields no data","Payment not processed results in 402 response blocking access","Page number out of range returns empty data array","Network timeout or upstream TikTok data unavailability causes failure"],"whenToPreferThis":"Use this endpoint when you need TikTok-specific music popularity rankings with flexible filtering by geography, time period, rank type, and commercial licensing. Prefer this over generic social media APIs when TikTok chart data with per-call x402 micropayment access is acceptable and you need structured music trend data without long-term subscription commitments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:41:23.881Z","isFirstParty":false}