{"id":"660244dc-dbcb-4edc-ab89-cbfe1a0cd3f3","slug":"snapchat-com-api","name":"snapchat.com API","description":"snapchat.com API","front_facing_description":"Retrieve public Spotlight posts and curated stories from any Snapchat user profile to view their shared content and recent activity. Access the timeline of posts that users have made publicly available on their accounts.","source_url":"https://Www.Snapchat.com/rigidhd","is_authenticated":false,"canonical_scraper_id":"3adb94ec-4b29-455a-8a11-81996d999735","apis":[{"method":"GET","endpoint_name":"get_user_posts","description":"Fetches public Spotlight posts and curated stories from a Snapchat user's profile page. Returns profile info, up to 25 spotlight posts with engagement stats (views, shares, comments, boosts), and curated story highlights. Users with no public content return empty arrays. A non-existent username returns an upstream 404 error.","input_params":{"username":{"type":"string","required":true,"description":"Snapchat username (e.g. 'mangeshdarji007'). Leading '@' is stripped automatically.","domain":{"kind":"open","example":"mangeshdarji007","generator":{"type":"static","value":"mangeshdarji007"}}}},"return_schema":{"type":"object","fields":{"profile":"object containing username, display_name, subscriber_count, bio, profile_picture_url","curated_stories":"array of curated story objects with story_id, title, thumbnail_url, snap_count","spotlight_posts":"array of spotlight post objects with snap_id, story_id, media_type, timestamp, media_url, thumbnail_url, view_count, share_count, comment_count, boost_count, duration_ms, title, description","spotlight_cursor":"pagination cursor for additional spotlight posts (empty string if no more)"},"sample":{"data":{"profile":{"bio":"","username":"mangeshdarji007","display_name":"Mangesh Darji","subscriber_count":"8200","profile_picture_url":"https://cf-st.sc-cdn.net/aps/bolt/..."},"curated_stories":[{"title":"","story_id":"","snap_count":1,"thumbnail_url":"https://cf-st.sc-cdn.net/d/..."}],"spotlight_posts":[{"title":"","snap_id":"W7_EDlXWTBiXAEEniNoMPwAAYd3ZxY2dvYml6AZ_PxnQ6AZ_PxmPBAAAAAw","story_id":"W7_EDlXWTBiXAEEniNoMPwAAYd3ZxY2dvYml6AZ_PxnQ6AZ_PxmPBAAAAAw","media_url":"https://cf-st.sc-cdn.net/o/...","timestamp":"1785897313","media_type":"image","view_count":"-1","boost_count":"20","description":"","duration_ms":"10000","share_count":"0","comment_count":"0","thumbnail_url":"https://cf-st.sc-cdn.net/o/..."}],"spotlight_cursor":"eyJkZGJfcGFnaW5hdGlvbl9jdXJzb3IiOi..."},"status":"success"}},"initiates_session":false,"price":2,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.profile","op":"field_present","value":"username"},{"path":"$.data.spotlight_posts","op":"type_is","value":"array"},{"path":"$.data.curated_stories","op":"type_is","value":"array"},{"path":"$.data.spotlight_posts","op":"array_min_len","value":1}],"empty_is_valid":false,"recipe_version":1}}],"sample_inputs":{"get_user_posts":{"username":"mangeshdarji007"}},"prefill_inputs":{"get_user_posts":{"username":"mangeshdarji007"}},"last_verified_at":"2026-10-26T10:01:52.923879+00:00","endpoint_health":[{"endpoint_name":"get_user_posts","status":"healthy","last_checked_at":"2026-10-26T10:01:52.923879+00:00","last_verified_at":"2026-10-26T10:01:52.923879+00:00","recent_runs":[{"at":"2026-10-26T10:01:52.923879+00:00","status":"healthy"},{"at":"2026-10-26T03:04:25.206817+00:00","status":"ambiguous"},{"at":"2026-10-25T20:04:25.380815+00:00","status":"ambiguous"},{"at":"2026-10-25T14:03:52.916806+00:00","status":"ambiguous"},{"at":"2026-10-25T07:03:52.906198+00:00","status":"ambiguous"}]}],"sdk_usage_example":{"code":"\"\"\"Walkthrough: Snapchat User Posts API — fetch a user's public Spotlight posts and curated stories.\"\"\"\nfrom parse_apis.snapchat_com_api import Snapchat, UsernameNotFound\n\nclient = Snapchat()\n\n# Fetch a user's public profile, spotlight posts, and curated stories.\ntry:\n    user = client.users.get(username=\"mangeshdarji007\")\nexcept UsernameNotFound as e:\n    print(f\"Username not found: {e.message}\")\n    raise SystemExit(1)\n\n# Display profile info.\nprint(f\"{user.profile.display_name} (@{user.profile.username})\")\nprint(f\"Subscribers: {user.profile.subscriber_count}\")\n\n# Browse spotlight posts — typed fields, no manual dict access.\nfor post in user.spotlight_posts[:5]:\n    print(f\"  [{post.media_type}] {post.snap_id[:20]}… views={post.view_count} comments={post.comment_count}\")\n    if post.title:\n        print(f\"    title: {post.title[:80]}\")\n\n# Browse curated stories.\nfor story in user.curated_stories[:3]:\n    print(f\"  Story: snaps={story.snap_count} thumb={story.thumbnail_url[:60]}…\")\n\nprint(\"exercised: users.get / Profile / SpotlightPost / CuratedStory\")\n","endpoints":["get_user_posts"],"has_session":false,"shape":"parse_sdk","hover_map":[{"line":18,"col":4,"len":4,"label":"post: SpotlightPost","kind":"variable"},{"line":24,"col":4,"len":5,"label":"story: CuratedStory","kind":"variable"},{"line":4,"col":9,"len":8,"label":"Snapchat — API client","kind":"class"},{"line":8,"col":4,"len":4,"label":"user: User","kind":"variable"},{"line":9,"col":7,"len":16,"label":"UsernameNotFound — error: The requested username does not exist on Snapchat","kind":"error"},{"line":18,"col":17,"len":15,"label":"spotlight_posts: List[SpotlightPost]","kind":"field"},{"line":20,"col":12,"len":5,"label":"title: str","kind":"field"},{"line":24,"col":18,"len":15,"label":"curated_stories: List[CuratedStory]","kind":"field"},{"line":8,"col":24,"len":3,"label":"get() → User","kind":"method"},{"line":18,"col":12,"len":4,"label":"user: User","kind":"variable"},{"line":20,"col":7,"len":4,"label":"post: SpotlightPost","kind":"variable"},{"line":24,"col":13,"len":4,"label":"user: User","kind":"variable"},{"line":14,"col":22,"len":12,"label":"display_name: str","kind":"field"},{"line":14,"col":52,"len":8,"label":"username: str","kind":"field"},{"line":15,"col":35,"len":16,"label":"subscriber_count: str","kind":"field"},{"line":14,"col":14,"len":7,"label":"profile: Profile","kind":"field"},{"line":14,"col":44,"len":7,"label":"profile: Profile","kind":"field"},{"line":15,"col":27,"len":7,"label":"profile: Profile","kind":"field"},{"line":19,"col":21,"len":10,"label":"media_type: str","kind":"field"},{"line":19,"col":69,"len":10,"label":"view_count: str","kind":"field"},{"line":19,"col":96,"len":13,"label":"comment_count: str","kind":"field"},{"line":25,"col":34,"len":10,"label":"snap_count: int","kind":"field"},{"line":14,"col":9,"len":4,"label":"user: User","kind":"variable"},{"line":14,"col":39,"len":4,"label":"user: User","kind":"variable"},{"line":15,"col":22,"len":4,"label":"user: User","kind":"variable"},{"line":19,"col":16,"len":4,"label":"post: SpotlightPost","kind":"variable"},{"line":19,"col":40,"len":7,"label":"snap_id: str","kind":"field"},{"line":19,"col":64,"len":4,"label":"post: SpotlightPost","kind":"variable"},{"line":19,"col":91,"len":4,"label":"post: SpotlightPost","kind":"variable"},{"line":25,"col":28,"len":5,"label":"story: CuratedStory","kind":"variable"},{"line":25,"col":59,"len":13,"label":"thumbnail_url: url","kind":"field"},{"line":10,"col":33,"len":1,"label":"e: UsernameNotFound","kind":"variable"},{"line":19,"col":35,"len":4,"label":"post: SpotlightPost","kind":"variable"},{"line":21,"col":33,"len":5,"label":"title: str","kind":"field"},{"line":25,"col":53,"len":5,"label":"story: CuratedStory","kind":"variable"},{"line":21,"col":28,"len":4,"label":"post: SpotlightPost","kind":"variable"}]},"sdk_delivery_state":"available","summary":"Retrieve public Spotlight posts and curated stories from a Snapchat user profile.","updated_at":"2026-09-15T11:07:25.089406+00:00","user_variants":[],"latest_version":2,"user_status":null,"user_scraper_id":null,"contributes_to_marketplace":true,"pinned_version":null,"seo_content":{"faqs":[{"a":"Snapchat offers the Snap Kit developer platform (kit.snapchat.com), which covers login, Bitmoji, and Creative Kit integrations. It does not expose public profile data, Spotlight posts, or subscriber counts through that platform.","q":"Does Snapchat have an official developer API?"},{"a":"For accounts that have no public Spotlight posts or curated stories — including private profiles — the endpoint returns the `profile` object with whatever fields are publicly visible, and empty arrays for `curated_stories` and `spotlight_posts`. The `spotlight_cursor` will be an empty string in that case.","q":"What does `get_user_posts` return for a private or inactive account?"},{"a":"Each call returns up to 25 Spotlight posts. If the `spotlight_cursor` field in the response is a non-empty string, pass it as a parameter on the next call to retrieve the next page. An empty string means there are no further posts to fetch.","q":"How does pagination work for Spotlight posts?"},{"a":"Not currently. The API returns `story_id`, `title`, `thumbnail_url`, and `snap_count` for each curated story, but does not return the individual snap media or metadata within a story. You can fork this API on Parse and revise it to add an endpoint that fetches individual snaps from a given story.","q":"Does the API return the individual snaps inside a curated story?"},{"a":"The current response shape includes aggregate engagement signals (view count, share count) alongside a comments field on each Spotlight post, but individual comment text and commenter profiles are not included. You can fork this API on Parse and revise it to add per-comment data if that surface is publicly accessible.","q":"Are comment details or commenter data returned for Spotlight posts?"}],"keywords":["Snapchat profile API","Snapchat Spotlight posts API","Snapchat public stories API","Snapchat creator engagement data","Snapchat subscriber count API","Snapchat view count API","Snapchat curated stories endpoint","Snapchat influencer metrics API","Snapchat username lookup API","Snapchat social media data API","Snapchat spotlight pagination cursor","Snapchat public profile scraper API","Snapchat snap count API"],"use_cases":["Track Spotlight post view counts and share counts for influencer benchmarking","Monitor subscriber growth on a public Snapchat creator profile over time","Aggregate curated story titles and snap counts to map a creator's content catalog","Pull thumbnail URLs from spotlight posts for visual content analysis pipelines","Compare engagement metrics (views, shares) across multiple Snapchat creators","Ingest profile bios and display names for creator database enrichment","Paginate through a creator's full Spotlight history using the spotlight_cursor field"],"meta_title":"Snapchat Profile API – Spotlight & Stories","generated_at":"2026-08-21T20:06:04.231476+00:00","lead_paragraph":"The Snapchat API exposes 1 endpoint — `get_user_posts` — that returns up to 14 structured fields covering a user's public profile, curated story highlights, and up to 25 Spotlight posts with engagement metrics including view count, share count, and comments. It works against any public Snapchat profile by username and includes a pagination cursor for fetching additional Spotlight content beyond the first page.","schema_version":2,"meta_description":"Retrieve public Spotlight posts, curated stories, and profile data from any Snapchat username via a single API endpoint.","primary_category":"social_media","long_description_md":"## What the API Returns\n\nThe `get_user_posts` endpoint accepts a single required parameter — `username` (leading `@` is stripped automatically) — and returns three top-level objects: `profile`, `curated_stories`, and `spotlight_posts`. The `profile` object includes `username`, `display_name`, `subscriber_count`, `bio`, and `profile_picture_url`. If a user has no public content, both arrays return empty.\n\n## Spotlight Posts\n\nEach object in `spotlight_posts` carries `snap_id`, `story_id`, `media_type`, `timestamp`, `media_url`, `thumbnail_url`, `view_count`, `share_count`, and additional engagement signals. Up to 25 posts are returned per call. If more exist, the `spotlight_cursor` field returns a non-empty string you pass back on the next request to paginate through the full post history.\n\n## Curated Stories\n\nThe `curated_stories` array returns story highlights the user has pinned to their profile. Each entry includes `story_id`, `title`, `thumbnail_url`, and `snap_count`, letting you see how many individual snaps are in each story collection without fetching the full story content.\n\n## Coverage Notes\n\nData is limited to publicly visible profiles. Private accounts and content requiring a Snapchat login return empty arrays rather than errors. Subscriber counts and engagement metrics reflect what Snapchat surfaces on the public profile view.","generated_with_model":"global.anthropic.claude-sonnet-4-6","secondary_categories":["streaming_video","entertainment"]},"primary_category":"social_media","secondary_categories":["streaming_video","entertainment"],"access_requirements":[]}