Spotlight
GET/v1/snapchat/spotlight1 kredi
Herkese açık bir Spotlight videosunu döndürür: açıklama, içerik üretici, izlenme, paylaşım ve yorum sayıları, süre, boyutlar, küçük resim ve video dosyasının URL'si; ayrıca sayfanın bağlantı önizlemesi ve video meta verileri.
01Sorgu parametreleri
| Ad | Tür | Açıklama |
|---|---|---|
| urlzorunlu | string | Spotlight URL'si, örneğin `https://www.snapchat.com/@jack.scalise/spotlight/W7_EDlXW...`. |
02İstek
curl "https://api.scrapesocial.ai/v1/snapchat/spotlight?url=https%3A%2F%2Fwww.snapchat.com%2F%40jack.scalise%2Fspotlight%2FW7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Yanıtlar
API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.
GET /v1/snapchat/spotlight?url=https%3A%2F%2Fwww.snapchat.com%2F%40jack.scalise%2Fspotlight%2FW7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"spotlight": {
"snapId": "W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ",
"storyId": "W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ",
"description": "You are my favorite notification!😄❤️",
"llmTitle": "Jack Scalise's 'Disturb Me' Challenge: How to Get Noticed Online",
"llmDescription": "This short-form content features Jack Scalise, a popular social media personality, inviting his audience to participate in a trending 'disturb me' challenge. The video opens with him speaking directly to the camera against scenic mountain backdrops, using text overlays like 'DISTURB ME UPDATE ME' and 'TELL ME HOW YOUR DAY WAS'. He then transitions to a park setting, smiling and holding a phone, wi…",
"engagementStats": {
"viewCount": 359951,
"shareCount": 35059,
"commentCount": 636,
"boostCount": 35666,
"recommendCount": 1825
},
"viewCount": 359951,
"shareCount": 35059,
"commentCount": 636,
"boostCount": 35666,
"recommendCount": 1825,
"creator": {
"$case": "personCreator",
"personCreator": {
"username": "jack.scalise",
"url": "https://www.snapchat.com/@jack.scalise",
"name": "Jack Scalise",
"followerCount": "0",
"websiteUrl": ""
}
},
"durationMs": 11200,
"width": 540,
"height": 960,
"uploadDateMs": 1742742025631,
"thumbnailUrl": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.256.IRZXSOY?mo=GkMaCTIBBEgCUC5gAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiAAiILEgAqB0lSWlhTT1miARAImgoiCxIAKgdJUlpYU09Z&uc=46",
"contentUrl": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.27.IRZXSOY?mo=Gk8aCTIBBEgCUC5gAVoQU3BvdGxpZ2h0U2hhcmluZ6IBKwgbEhoKGAjssDMgAUoOCglJICIpKB4jKSEQ9ANoAiILEgAqB0lSWlhTT1mQA8BX&uc=46",
"raw": {
"story": {
"storyType": 15,
"snapList": [
{
"snapIndex": 0,
"snapId": {
"value": "W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ"
},
"snapMediaType": 1,
"snapUrls": {
"mediaUrl": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.27.IRZXSOY?mo=Gk8aCTIBBEgCUC5gAVoQU3BvdGxpZ2h0U2hhcmluZ6IBKwgbEhoKGAjssDMgAUoOCglJICIpKB4jKSEQ9ANoAiILEgAqB0lSWlhTT1mQA8BX&uc=46",
"mediaPreviewUrl": {
"value": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.256.IRZXSOY?mo=GkMaCTIBBEgCUC5gAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiAAiILEgAqB0lSWlhTT1miARAImgoiCxIAKgdJUlpYU09Z&uc=46"
},
"overlayUrl": null,
"attachmentUrl": null
},
"isSponsored": null,
"timestampInSec": {
"value": "1742742025"
},
"snapTitle": null,
"snapSubtitles": null,
"lat": null,
"lng": null,
"hasAttachment": null,
"intervalStartTimeMs": null,
"audioTranscriptionObjectUrl": {
"value": "https://bolt-gcdn.sc-cdn.net/3/qFbYrpUtxHtWW3OTCKXnH.vtt?bo=EgkyAX1IAlAuYAE%3D&uc=46"
}
}
],
"storyId": {
"value": "W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ"
},
"storyTitle": null,
"thumbnailUrl": {
"value": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.256.IRZXSOY?mo=GkMaCTIBBEgCUC5gAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiAAiILEgAqB0lSWlhTT1miARAImgoiCxIAKgdJUlpYU09Z&uc=46"
},
"storySubtitle": null,
"storyShareId": null,
"canonicalUrlSuffix": null,
"emoji": null,
"storyTapId": "0",
"videoTrackUrl": null,
"highlightId": null,
"isAttributed": {
"value": true
},
"thumbnailTiles": [
{
"tileType": 1,
"url": {
"value": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.1400.IRZXSOY?mo=GkYaCTIBBEgCUC5gAVClAloQRGZMYXJnZVRodW1ibmFpbKIBEAj4CiILEgAqB0lSWlhTT1miARAIlgsiCxIAKgdJUlpYU09Z&uc=46"
},
"tileId": null
},
{
"tileType": 2,
"url": {
"value": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.256.IRZXSOY?mo=GkMaCTIBBEgCUC5gAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiAAiILEgAqB0lSWlhTT1miARAImgoiCxIAKgdJUlpYU09Z&uc=46"
},
"tileId": null
}
]
},
"metadata": {
"videoMetadata": {
"name": "Spotlight Snap",
"description": "Another Spotlight Snap brought to you by Snapchat",
"thumbnailUrl": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.256.IRZXSOY?mo=GkMaCTIBBEgCUC5gAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiAAiILEgAqB0lSWlhTT1miARAImgoiCxIAKgdJUlpYU09Z&uc=46",
"uploadDateMs": "1742742025631",
"viewCount": "359951",
"contentUrl": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.27.IRZXSOY?mo=Gk8aCTIBBEgCUC5gAVoQU3BvdGxpZ2h0U2hhcmluZ6IBKwgbEhoKGAjssDMgAUoOCglJICIpKB4jKSEQ9ANoAiILEgAqB0lSWlhTT1mQA8BX&uc=46",
"creator": {
"$case": "personCreator",
"personCreator": {
"username": "jack.scalise",
"url": "https://www.snapchat.com/@jack.scalise",
"name": "Jack Scalise",
"followerCount": "0",
"websiteUrl": ""
}
},
"durationMs": "11200",
"width": 540,
"height": 960,
"keywords": [],
"shareCount": "0",
"embeddedTextCaption": ""
},
"userMetadata": null,
"lensMetadata": null,
"hashtags": [],
"contextCards": [
{
"contextType": 2,
"title": "Original Sound",
"subtitle": "jack.scalise",
"url": "",
"thumbnailUrl": "https://cf-st.sc-cdn.net/d/6YKRUxipwtyh6YMgtaJbK?bo=Eg0aABoAMgEESAJQCGAB&uc=8",
"snapcodeUrl": "",
"thumbnailType": 2,
"hasBadge": false,
"id": "129883952169"
},
{
"contextType": 3,
"title": "Jack Scalise",
"subtitle": "jack.scalise",
"url": "https://www.snapchat.com/@jack.scalise",
"thumbnailUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvWDcyaUthUWtVYW1QaTA3cEFVTEVGP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,640_FMjpeg",
"snapcodeUrl": "https://app.snapchat.com/web/deeplink/snapcode?username=jack.scalise&type=SVG&bitmoji=enable",
"thumbnailType": 0,
"hasBadge": true,
"id": "a09b4aa7-8868-4066-8e56-0dc641042666"
}
],
"engagementStats": {
"viewCount": 359951,
"shareCount": 35059,
"commentCount": 636,
"boostCount": 35666,
"recommendCount": 1825
},
"deeplink": "https://click.snapchat.com/aVHG?pid=snapchat_download_page&af_dp=https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ&af_web_dp=https://snapchat.com/download?purpose%3Dweb_stories%26sp%3Dspotlight&af_ios_url=https://apps.apple.com/app/apple-store/id447188370?pt%3D614006%26ct%3Dspotlight%26mt%3D8",
"oneLinkParams": {
"oneLinkBaseUrl": "https://click.snapchat.com/aVHG",
"pidKeys": [
"af_pid",
"utm_source"
],
"pidFallbackValue": "consumer_web",
"campaignKeys": [
"af_c",
"utm_campaign"
],
"campaignFallbackValue": "spotlight",
"googleClickIdParam": "af_sub1",
"deepLinkUrl": "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ",
"iosAppStoreUrl": "https://apps.apple.com/app/apple-store/id447188370?pt=614006&ct=spotlight&mt=8",
"desktopPageUrl": "https://snapchat.com/download?purpose=web_stories&sp=spotlight"
},
"description": "You are my favorite notification!😄❤️",
"cuSignals": [
{
"signal": {
"$case": "textMetadata",
"textMetadata": {
"description": "Emotional message to a loved one.",
"keywords": [
"relationship",
"communication"
]
}
}
},
{
"signal": {
"$case": "detectedLanguage",
"detectedLanguage": {
"languageScores": [
{
"languageCode": "en",
"score": 0.9985544085502625
}
]
}
}
}
],
"llmDescription": "This short-form content features Jack Scalise, a popular social media personality, inviting his audience to participate in a trending 'disturb me' challenge. The video opens with him speaking directly to the camera against scenic mountain backdrops, using text overlays like 'DISTURB ME UPDATE ME' and 'TELL ME HOW YOUR DAY WAS'. He then transitions to a park setting, smiling and holding a phone, wi…",
"llmKeywords": [
"how to get noticed online",
"engagement tips for creators"
],
"s2iTags": [],
"llmTitle": "Jack Scalise's 'Disturb Me' Challenge: How to Get Noticed Online",
"textMetadataKeywords": [
"relationship",
"communication"
]
},
"contentSource": "ssr_initial",
"vlmSwapEligible": true,
"upNextThumbnailUrl": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.1400.IRZXSOY?mo=GkYaCTIBBEgCUC5gAVClAloQRGZMYXJnZVRodW1ibmFpbKIBEAj4CiILEgAqB0lSWlhTT1miARAIlgsiCxIAKgdJUlpYU09Z&uc=46"
}
},
"linkPreview": {
"title": "Spotlight Snap",
"description": "You are my favorite notification!😄❤️",
"canonicalUrl": "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ",
"twitterImage": {
"url": "https://story.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ/preview/square.jpeg",
"size": {
"width": 800,
"height": 800
}
},
"facebookImage": {
"url": "https://story.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ/preview/square.jpeg",
"size": {
"width": 800,
"height": 800
}
},
"snapchatTitle": ""
},
"pageMetadata": {
"pageType": 11,
"pageTitle": "jack.scalise | Spotlight on Snapchat",
"pageDescription": {
"value": "You are my favorite notification!😄❤️ | Check out the best music, lenses, memes and videos in all the latest Spotlight snaps, brought to you by Snapchat."
},
"shareId": ""
},
"videoMetadata": {
"name": "Spotlight Snap",
"description": "Another Spotlight Snap brought to you by Snapchat",
"thumbnailUrl": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.256.IRZXSOY?mo=GkMaCTIBBEgCUC5gAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiAAiILEgAqB0lSWlhTT1miARAImgoiCxIAKgdJUlpYU09Z&uc=46",
"uploadDateMs": "1742742025631",
"viewCount": "359951",
"contentUrl": "https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.27.IRZXSOY?mo=Gk8aCTIBBEgCUC5gAVoQU3BvdGxpZ2h0U2hhcmluZ6IBKwgbEhoKGAjssDMgAUoOCglJICIpKB4jKSEQ9ANoAiILEgAqB0lSWlhTT1mQA8BX&uc=46",
"creator": {
"$case": "personCreator",
"personCreator": {
"username": "jack.scalise",
"url": "https://www.snapchat.com/@jack.scalise",
"name": "Jack Scalise",
"followerCount": "0",
"websiteUrl": ""
}
},
"durationMs": "11200",
"width": 540,
"height": 960,
"keywords": [],
"shareCount": "0",
"embeddedTextCaption": ""
}
}Tüm uç noktalarda ortak
Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}04Notlar
`spotlight` içindeki sayılar sayısal değerdir; `videoMetadata` içindeki aynı sayılar, sayfadaki gibi metin olarak gelir. Spotlight URL'si olmayan bir URL, hiçbir istek yapılmadan ücretsiz bir 400 ile reddedilir; bulunamayan bir Spotlight ücretsiz bir 404 döndürür.
05Hatalar ve krediler
Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.
400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.