Snapchat MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Snapchat: 25 typed functions through one MCP server. No Snapchat API key needed.
- Site
- snapchat.com
- Functions
- 25
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Snapchat alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/snapchatOne MCP server for Snapchat and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
getEpisodeReads one show episode's own page (www.snapchat.com/p/<publisherId>/<storyId>).Arguments
Name Type Required publisherIdstringYes storyIdstringYes Returns
SnapchatEpisodeinterface SnapchatStorySnap { snapId: string; snapMediaType?: string; mediaUrl?: string; mediaPreviewUrl?: string; } interface SnapchatEpisode { storyId: string; title?: string; publishedAtSec?: number; snaps: SnapchatStorySnap[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/getEpisodeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.getEpisode({ publisherId: "73365ee2-f2ad-455d-8c1a-e07c83b1b045", storyId: "3298916203413504" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.getEpisode({ "publisherId": "73365ee2-f2ad-455d-8c1a-e07c83b1b045", "storyId": "3298916203413504" }))curl -X POST https://api.bowmark.ai/v1/sites/snapchat/getEpisode \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"publisherId":"73365ee2-f2ad-455d-8c1a-e07c83b1b045","storyId":"3298916203413504"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.getEpisode({ publisherId: "73365ee2-f2ad-455d-8c1a-e07c83b1b045", storyId: "3298916203413504" });getLensReads one Lens's own page (www.snapchat.com/lens/<scannableUuid>).Arguments
Name Type Required scannableUuidstringYes Returns
SnapchatLensDetailinterface SnapchatLens { lensId: string; scannableUuid: string; name: string; creatorUsername?: string; creatorDisplayName?: string; previewImageUrl?: string; previewVideoUrl?: string; iconUrl?: string; unlockUrl?: string; searchTags?: string[]; official: boolean; } interface SnapchatLensDetail extends SnapchatLens { moreLenses: SnapchatLens[]; spotlightsUsingThisLens: Array<{ thumbnailUrl?: string; storyPageUrl?: string }>; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/getLensCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.getLens("565e7595ec4e4a0da689762b127308ef");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.getLens("565e7595ec4e4a0da689762b127308ef"))curl -X POST https://api.bowmark.ai/v1/sites/snapchat/getLens \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"scannableUuid":"565e7595ec4e4a0da689762b127308ef"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.getLens("565e7595ec4e4a0da689762b127308ef");getLocalGuideReads a city's local guide (www.snapchat.com/local/<country>/<state>/<city>[/<category>]).Arguments
Name Type Required pathstringYes categorystringNo Returns
SnapchatLocalGuideinterface SnapchatLocalPlaceSnap { snapId: string; posterUsername?: string; posterDisplayName?: string; mediaUrl?: string; thumbnailUrl?: string; postedAtMs?: number; } interface SnapchatLocalPlace { placeId: string; name: string; category?: string; placeUrl?: string; address?: string; photoUrl?: string; snaps: SnapchatLocalPlaceSnap[]; } interface SnapchatLocalCategory { slug: string; displayName: string; places: SnapchatLocalPlace[]; } interface SnapchatLocalGuide { city: string; state?: string; categories: SnapchatLocalCategory[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/getLocalGuideCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.getLocalGuide({ path: "/local/united-states/new-york/new-york" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.getLocalGuide({"path": "/local/united-states/new-york/new-york"}))curl -X POST https://api.bowmark.ai/v1/sites/snapchat/getLocalGuide \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"path":"/local/united-states/new-york/new-york"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.getLocalGuide({ path: "/local/united-states/new-york/new-york" });getMyProfileReads the signed-in caller's own Snapchat account.Arguments
None.
Returns
SnapchatMyProfileinterface SnapchatMyProfile { userId: string; // the account's uuid username?: string; displayName?: string; mutableUsername?: string; isOfficial?: boolean; isPopular?: boolean; snapProId?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/getMyProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.getMyProfile();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.getMyProfile())curl -X POST https://api.bowmark.ai/v1/sites/snapchat/getMyProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.getMyProfile();getProfileReads one Snapchat account's public page by username.Arguments
Name Type Required usernamestringYes Returns
SnapchatProfileRowinterface SnapchatProfileRow { username: string; displayName: string; snapcodeImageUrl: string; kind: string; // the site's $case: "userInfo" for an ordinary account, "publicProfileInfo" for one with followers/bio/category bio?: string; websiteUrl?: string; subscriberCount?: number; categoryStringId?: string; badge?: boolean; relatedAccounts?: Array<{ username: string; displayName: string }>; profile: Record<string, unknown>; // the site's own userProfile object, untouched }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/getProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.getProfile("nba");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.getProfile("nba"))curl -X POST https://api.bowmark.ai/v1/sites/snapchat/getProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"nba"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.getProfile("nba");getShowReads one Discover show or publisher page (www.snapchat.com/p/<publisherId>).Arguments
Name Type Required publisherIdstringYes Returns
SnapchatShowinterface SnapchatShowEpisodeSummary { storyId: string; title?: string; thumbnailUrl?: string; publishedAtSec?: number; seasonNumber?: number; episodeNumber?: number; } interface SnapchatShowSeason { seasonNumber: number; episodeCount: number; } interface SnapchatShow { publisherId: string; title?: string; bio?: string; websiteUrl?: string; subscriberCount?: number; profilePictureUrl?: string; episodes: SnapchatShowEpisodeSummary[]; // snapList is always empty here; getEpisode reads the snaps seasons: SnapchatShowSeason[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/getShowCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.getShow("73365ee2-f2ad-455d-8c1a-e07c83b1b045");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.getShow("73365ee2-f2ad-455d-8c1a-e07c83b1b045"))curl -X POST https://api.bowmark.ai/v1/sites/snapchat/getShow \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"publisherId":"73365ee2-f2ad-455d-8c1a-e07c83b1b045"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.getShow("73365ee2-f2ad-455d-8c1a-e07c83b1b045");getSpotlightVideoReads one Spotlight video by its share url or snap id.Arguments
Name Type Required urlstringYes Returns
SnapchatSpotlightVideoDetailinterface SnapchatSpotlightVideo { storyId: string; snapId: string; mediaUrl?: string; mediaPreviewUrl?: string; name?: string; viewCount?: number; uploadDateMs?: number; durationMs?: number; width?: number; height?: number; creatorUsername?: string; creatorDisplayName?: string; creatorUrl?: string; canonicalUrl?: string; // www.snapchat.com/@<creator>/spotlight/<storyId>, what getSpotlightVideo takes } interface SnapchatSpotlightVideoDetail { name?: string; description?: string; viewCount?: number; uploadDateMs?: number; durationMs?: number; width?: number; height?: number; contentUrl?: string; creatorUsername?: string; creatorDisplayName?: string; creatorUrl?: string; relatedVideos: SnapchatSpotlightVideo[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/getSpotlightVideoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.getSpotlightVideo("<url>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.getSpotlightVideo("<url>"))curl -X POST https://api.bowmark.ai/v1/sites/snapchat/getSpotlightVideo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"<url>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.getSpotlightVideo("<url>");listDiscoverStoriesReads the public Discover feed at www.snapchat.com/discover.Arguments
None.
Returns
SnapchatDiscoverFeedinterface SnapchatDiscoverStory { id: string; kind: string; // the site's __typename: "PremiumPublisherStory" (a Show) or "SnapProStory" (a creator) title?: string; creatorUsername?: string; creatorDisplayName?: string; thumbnailUrl?: string; tapId?: string; snapCount: number; canonicalUrl: string; // story.snapchat.com/p/<id> } interface SnapchatDiscoverFeed { stories: SnapchatDiscoverStory[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/listDiscoverStoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.listDiscoverStories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.listDiscoverStories())curl -X POST https://api.bowmark.ai/v1/sites/snapchat/listDiscoverStories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.listDiscoverStories();listFriendsLists the signed-in caller's Snapchat friends.Arguments
None.
Returns
SnapchatFriend[]interface SnapchatFriend { userId: string; // the friend's uuid username?: string; displayName?: string; friendLinkType?: number; // 2 friend · 3 pending · 4 following · 5 blocked … addedAt?: number; // unix ms bitmojiAvatarId?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/listFriendsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.listFriends();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.listFriends())curl -X POST https://api.bowmark.ai/v1/sites/snapchat/listFriends \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.listFriends();listFriendStoriesLists the Stories the signed-in caller's friends have posted, with each Story's snaps.Arguments
None.
Returns
SnapchatFriendStoriesinterface SnapchatFriendStorySnap { snapId?: string; mediaUrl?: string; mediaType?: number; // Snapchat's own enum durationSec?: number; thumbnailUrl?: string; caption?: string; title?: string; createdAt?: number; // unix ms expiresAt?: number; // unix ms } interface SnapchatFriendStory { userId?: string; username?: string; displayName?: string; snaps: SnapchatFriendStorySnap[]; } interface SnapchatFriendStories { stories: SnapchatFriendStory[]; cards: number; // cards the feed returned, the caller's own story included warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/listFriendStoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.listFriendStories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.listFriendStories())curl -X POST https://api.bowmark.ai/v1/sites/snapchat/listFriendStories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.listFriendStories();listLensesReads the Lens Explorer's top lenses at www.snapchat.com/lens.Arguments
None.
Returns
SnapchatLensListinterface SnapchatLens { lensId: string; scannableUuid: string; name: string; creatorUsername?: string; creatorDisplayName?: string; previewImageUrl?: string; previewVideoUrl?: string; iconUrl?: string; unlockUrl?: string; searchTags?: string[]; official: boolean; } interface SnapchatLensCategory { name: string; displayName: string; selected: boolean; } interface SnapchatLensList { lenses: SnapchatLens[]; categories: SnapchatLensCategory[]; hasMore: boolean; nextCursorId?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/listLensesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.listLenses();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.listLenses())curl -X POST https://api.bowmark.ai/v1/sites/snapchat/listLenses \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.listLenses();listLocalCitiesLists the cities Snapchat publishes local guides for, off the homepage's 'Explore local favorites' section, with each guide's path.Arguments
None.
Returns
SnapchatLocalCitiesinterface SnapchatLocalCity { name: string; state?: string; path: string; // what getLocalGuide takes } interface SnapchatLocalCities { cities: SnapchatLocalCity[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/listLocalCitiesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.listLocalCities();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.listLocalCities())curl -X POST https://api.bowmark.ai/v1/sites/snapchat/listLocalCities \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.listLocalCities();listProfileHighlightsLists a public profile's saved Story highlights (curated Stories kept on the profile), with each highlight's snaps, paged.Arguments
Name Type Required usernamestringYes Returns
SnapchatProfileHighlightsinterface SnapchatStorySnap { snapId: string; snapMediaType?: string; mediaUrl?: string; mediaPreviewUrl?: string; } interface SnapchatProfileHighlight { highlightId?: string; title?: string; thumbnailUrl?: string; snaps: SnapchatStorySnap[]; } interface SnapchatProfileHighlights { username: string; highlights: SnapchatProfileHighlight[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/listProfileHighlightsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.listProfileHighlights("nba");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.listProfileHighlights("nba"))curl -X POST https://api.bowmark.ai/v1/sites/snapchat/listProfileHighlights \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"nba"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.listProfileHighlights("nba");listProfileLensesLists the Lenses a public profile has published, with lens name, preview image and video, icon and unlock link, paged.Arguments
Name Type Required usernamestringYes Returns
SnapchatProfileLensesinterface SnapchatProfileLens { name: string; creatorDisplayName?: string; previewImageUrl?: string; previewVideoUrl?: string; iconUrl?: string; unlockUrl?: string; scannableUuid?: string; // what getLens takes } interface SnapchatProfileLenses { username: string; lenses: SnapchatProfileLens[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/listProfileLensesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.listProfileLenses("nba");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.listProfileLenses("nba"))curl -X POST https://api.bowmark.ai/v1/sites/snapchat/listProfileLenses \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"nba"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.listProfileLenses("nba");listProfileSpotlightsLists the Spotlight videos a public profile has posted, with title, upload date, view count, duration and video url, paged.Arguments
Name Type Required usernamestringYes Returns
SnapchatProfileSpotlightsinterface SnapchatSpotlightVideo { storyId: string; snapId: string; mediaUrl?: string; mediaPreviewUrl?: string; name?: string; viewCount?: number; uploadDateMs?: number; durationMs?: number; width?: number; height?: number; creatorUsername?: string; creatorDisplayName?: string; creatorUrl?: string; canonicalUrl?: string; // www.snapchat.com/@<creator>/spotlight/<storyId>, what getSpotlightVideo takes } interface SnapchatProfileSpotlights { username: string; videos: SnapchatSpotlightVideo[]; cursor?: string; // the site's next-page token; only the first page is read }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/listProfileSpotlightsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.listProfileSpotlights("nba");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.listProfileSpotlights("nba"))curl -X POST https://api.bowmark.ai/v1/sites/snapchat/listProfileSpotlights \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"nba"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.listProfileSpotlights("nba");listProfileStoryLists the snaps in a public profile's current Story.Arguments
Name Type Required usernamestringYes Returns
SnapchatProfileStoryinterface SnapchatStorySnap { snapId: string; snapMediaType?: string; mediaUrl?: string; mediaPreviewUrl?: string; } interface SnapchatProfileStory { username: string; hasStory: boolean; snaps: SnapchatStorySnap[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/listProfileStoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.listProfileStory("nba");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.listProfileStory("nba"))curl -X POST https://api.bowmark.ai/v1/sites/snapchat/listProfileStory \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"nba"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.listProfileStory("nba");listSpotlightCommentsReads the public comments under one Spotlight video.Arguments
Name Type Required urlstringYes Returns
SnapchatSpotlightCommentsinterface SnapchatSpotlightComment { text: string; posterDisplayName?: string; timestampMs?: number; reactCount?: number; replyCount?: number; } interface SnapchatSpotlightComments { comments: SnapchatSpotlightComment[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/listSpotlightCommentsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.listSpotlightComments("<url>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.listSpotlightComments("<url>"))curl -X POST https://api.bowmark.ai/v1/sites/snapchat/listSpotlightComments \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"<url>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.listSpotlightComments("<url>");listSpotlightFeedReads the Spotlight feed, Snapchat's public short-video feed at www.snapchat.com/spotlight, returning each video's creator, caption, view count…Arguments
None.
Returns
SnapchatSpotlightFeedinterface SnapchatSpotlightVideo { storyId: string; snapId: string; mediaUrl?: string; mediaPreviewUrl?: string; name?: string; viewCount?: number; uploadDateMs?: number; durationMs?: number; width?: number; height?: number; creatorUsername?: string; creatorDisplayName?: string; creatorUrl?: string; canonicalUrl?: string; // www.snapchat.com/@<creator>/spotlight/<storyId>, what getSpotlightVideo takes } interface SnapchatSpotlightFeed { videos: SnapchatSpotlightVideo[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/listSpotlightFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.listSpotlightFeed();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.listSpotlightFeed())curl -X POST https://api.bowmark.ai/v1/sites/snapchat/listSpotlightFeed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.listSpotlightFeed();listTopicSpotlightsLists the Spotlight videos filed under one hashtag topic (www.snapchat.com/tag/<hashtag>), the feed a person opens by tapping a hashtag.Arguments
Name Type Required hashtagstringYes Returns
SnapchatTopicSpotlightsinterface SnapchatSpotlightVideo { storyId: string; snapId: string; mediaUrl?: string; mediaPreviewUrl?: string; name?: string; viewCount?: number; uploadDateMs?: number; durationMs?: number; width?: number; height?: number; creatorUsername?: string; creatorDisplayName?: string; creatorUrl?: string; canonicalUrl?: string; // www.snapchat.com/@<creator>/spotlight/<storyId>, what getSpotlightVideo takes } interface SnapchatTopicSpotlights { hashtag: string; videos: SnapchatSpotlightVideo[]; relatedTopics: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/listTopicSpotlightsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.listTopicSpotlights("funny");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.listTopicSpotlights("funny"))curl -X POST https://api.bowmark.ai/v1/sites/snapchat/listTopicSpotlights \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"hashtag":"funny"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.listTopicSpotlights("funny");searchSnapchatSearches Snapchat the way the site's own search page does.Arguments
Name Type Required querystringYes Returns
SnapchatSearchResultinterface SnapchatSearchItem { kind: string; // "lens" | "storyCard" (a Spotlight video) | "user" | "snapProEntity" | "show" | "place" | "publisherEdition" (an episode) | "topic" | … id: string; // Spotlight snap id, user id, profile id, publisherId (show), storyId (episode), place id, topic text; a lens's id is its lensId (getLens takes the uuid in result.unlockUrl) title?: string; username?: string; result: Record<string, unknown>; // the site's own object for that item, untouched } interface SnapchatSearchResult { query: string; sections: Array<{ section: string; // "Lenses" | "Spotlight" | "Add Friends" | "Subscribe" | "Shows" | "Places" | "Episodes" | "Topics" kind: string; // the site's section kind: "lenses" | "spotlight" | "users" | "profiles" | "publishers" | "places" | "episodes" | "topics" items: SnapchatSearchItem[]; }>; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/searchSnapchatCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.searchSnapchat("pizza");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.searchSnapchat("pizza"))curl -X POST https://api.bowmark.ai/v1/sites/snapchat/searchSnapchat \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"pizza"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.searchSnapchat("pizza");
addFriendSends a friend add from the signed-in caller's account to one Snapchat user by their user id (a uuid) or username (resolved with…Arguments
Name Type Required input{ userId: string } | { username: string }Yes Returns
SnapchatFriendActionResultinterface SnapchatFriendActionResult { userId: string; added: boolean; // Snapchat accepted the add failureReason?: number; // Snapchat's own refusal enum, when it refused message?: string; username?: string; // set when the add was made by username }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/addFriendCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.addFriend({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.addFriend({}))curl -X POST https://api.bowmark.ai/v1/sites/snapchat/addFriend \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.addFriend({});blockUserBlocks one Snapchat account from contacting the signed-in caller, by user id (a uuid) or username (resolved with AtlasGw/GetUserIdByUsername).Arguments
Name Type Required input{ userId: string } | { username: string }Yes Returns
SnapchatFriendChangeResultinterface SnapchatFriendChangeResult { userId: string; username?: string; // set when called by username done: boolean; // Snapchat accepted the remove / block failureReason?: number; // Snapchat's own refusal enum, when it refused message?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/blockUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.blockUser({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.blockUser({}))curl -X POST https://api.bowmark.ai/v1/sites/snapchat/blockUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.blockUser({});removeFriendRemoves one Snapchat user from the signed-in caller's friends, by user id (a uuid) or username (resolved with AtlasGw/GetUserIdByUsername).Arguments
Name Type Required input{ userId: string } | { username: string }Yes Returns
SnapchatFriendChangeResultinterface SnapchatFriendChangeResult { userId: string; username?: string; // set when called by username done: boolean; // Snapchat accepted the remove / block failureReason?: number; // Snapchat's own refusal enum, when it refused message?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/removeFriendCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.removeFriend({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.removeFriend({}))curl -X POST https://api.bowmark.ai/v1/sites/snapchat/removeFriend \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.removeFriend({});unblockUserUnblocks one Snapchat account the signed-in caller blocked, by user id (a uuid) or username (resolved with AtlasGw/GetUserIdByUsername).Arguments
Name Type Required input{ userId: string } | { username: string }Yes Returns
SnapchatFriendChangeResultinterface SnapchatFriendChangeResult { userId: string; username?: string; // set when called by username done: boolean; // Snapchat accepted the remove / block failureReason?: number; // Snapchat's own refusal enum, when it refused message?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/unblockUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.unblockUser({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.unblockUser({}))curl -X POST https://api.bowmark.ai/v1/sites/snapchat/unblockUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.unblockUser({});updateDisplayNameChanges the signed-in caller's Snapchat display name.Arguments
Name Type Required input{ displayName: string }Yes Returns
SnapchatDisplayNameResultinterface SnapchatDisplayNameResult { displayName: string; // the name sent status: number; // Snapchat's own status enum (field 1), 0 when none was sent }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/snapchat/updateDisplayNameCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.snapchat.updateDisplayName({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.snapchat.updateDisplayName({}))curl -X POST https://api.bowmark.ai/v1/sites/snapchat/updateDisplayName \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.snapchat.updateDisplayName({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/snapchat/<function> - OpenAPI
/v1/sites/snapchat/openapi.json