Prime Video MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Prime Video: 23 typed functions through one MCP server. No Prime Video API key needed.
- Site
- primevideo.com
- Functions
- 23
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Prime Video 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/prime_videoOne MCP server for Prime Video 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.
getChannelRead one add-on channel: what it is called, its top ten, its originals and series, and the live events it is carrying.Arguments
Name Type Required channelstringYes Returns
PrimeVideoChannelDetailinterface PrimeVideoTitle { titleId: string; catalogId: string | null; title: string; url: string; entityType: string | null; releaseYear: number | null; maturityRating: string | null; entitled: boolean; watchMessage: string | null; } interface PrimeVideoCategoryRow { heading: string; titles: PrimeVideoTitle[]; nextPage?: string; } interface PrimeVideoChannelDetail { name: string; rows: PrimeVideoCategoryRow[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/getChannelCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.getChannel("0350778f-c66c-40e5-8015-bec5c0139fe8");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.getChannel("0350778f-c66c-40e5-8015-bec5c0139fe8"))curl -X POST https://api.bowmark.ai/v1/sites/prime_video/getChannel \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"channel":"0350778f-c66c-40e5-8015-bec5c0139fe8"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.prime_video.getChannel("0350778f-c66c-40e5-8015-bec5c0139fe8");getLiveScheduleRead one live station's schedule.Arguments
Name Type Required section"livetv" | "news"Yes stationIdstringYes Returns
PrimeVideoLiveProgram[]interface PrimeVideoLiveProgram { title: string; seriesTitle: string | null; start: number; end: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/getLiveScheduleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.getLiveSchedule("livetv", "amzn1.dv.gti.281ad0f8-f892-4d4f-906f-52b324ca7c12");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.getLiveSchedule("livetv", "amzn1.dv.gti.281ad0f8-f892-4d4f-906f-52b324ca7c12"))curl -X POST https://api.bowmark.ai/v1/sites/prime_video/getLiveSchedule \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"section":"livetv","stationId":"amzn1.dv.gti.281ad0f8-f892-4d4f-906f-52b324ca7c12"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.prime_video.getLiveSchedule("livetv", "amzn1.dv.gti.281ad0f8-f892-4d4f-906f-52b324ca7c12");getPersonRead a cast member's Prime Video page: their name, what they are credited as, when and where they were born, their biography, and the titles of…Arguments
Name Type Required personIdstringYes Returns
PrimeVideoPersoninterface PrimeVideoPersonCredit { titleId: string | null; catalogId: string; title: string; releaseYear: number | null; runtime: string | null; synopsis: string | null; maturityRating: string | null; } interface PrimeVideoPerson { personId: string; name: string; roles: string[]; birthPlace: string | null; dateOfBirth: string | null; bio: string | null; imdbUrl: string | null; filmography: PrimeVideoPersonCredit[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/getPersonCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.getPerson("amzn1.dv.gti.06330a24-7d99-4c06-8bac-10feccecb5cb");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.getPerson("amzn1.dv.gti.06330a24-7d99-4c06-8bac-10feccecb5cb"))curl -X POST https://api.bowmark.ai/v1/sites/prime_video/getPerson \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"personId":"amzn1.dv.gti.06330a24-7d99-4c06-8bac-10feccecb5cb"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.prime_video.getPerson("amzn1.dv.gti.06330a24-7d99-4c06-8bac-10feccecb5cb");getTitleRead one film, series-season or episode the way a viewer reads its page: title, synopsis, year, release date, runtime (both the display string and…Arguments
Name Type Required titleIdstringYes Returns
PrimeVideoTitleDetailinterface PrimeVideoCredit { name: string; searchLink: string | null; } interface PrimeVideoRatingBucket { stars: 1 | 2 | 3 | 4 | 5; percentage: number; } interface PrimeVideoTitleDetail { titleId: string; catalogId: string | null; title: string; seriesTitle: string | null; seasonNumber: number | null; titleType: string | null; synopsis: string | null; releaseYear: number | null; releaseDate: string | null; runtime: string | null; durationSeconds: number | null; genres: string[]; maturityRating: string | null; cast: PrimeVideoCredit[]; directors: PrimeVideoCredit[]; studios: string[]; amazonRating: { value: number; count: number } | null; ratingsHistogram: PrimeVideoRatingBucket[]; imdbScore: number | null; audioTracks: string[]; subtitles: string[]; isUhd: boolean; isHdr: boolean; isDolbyVision: boolean; isDolbyAtmos: boolean; isXRay: boolean; isClosedCaption: boolean; isPrime: boolean; isAd: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/getTitleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.getTitle("0SC64NC24QA7M9AFWBEK87WWS0");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.getTitle("0SC64NC24QA7M9AFWBEK87WWS0"))curl -X POST https://api.bowmark.ai/v1/sites/prime_video/getTitle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"titleId":"0SC64NC24QA7M9AFWBEK87WWS0"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.prime_video.getTitle("0SC64NC24QA7M9AFWBEK87WWS0");getWatchlistRead the caller's own Prime Video watchlist.Arguments
None.
Returns
PrimeVideoTitle[]interface PrimeVideoTitle { titleId: string; catalogId: string | null; title: string; url: string; entityType: string | null; releaseYear: number | null; maturityRating: string | null; entitled: boolean; watchMessage: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/getWatchlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.getWatchlist();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.getWatchlist())curl -X POST https://api.bowmark.ai/v1/sites/prime_video/getWatchlist \ -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.prime_video.getWatchlist();getWatchOptionsSay how you would actually watch a title: included with your Prime membership, free with ads, on an add-on channel you would have to subscribe to…Arguments
Name Type Required titleIdstringYes Returns
PrimeVideoWatchOptionsinterface PrimeVideoWatchOffer { kind: "rent" | "buy" | "subscribe"; label: string; price: { currency: string; value: string } | null; quality: "SD" | "HD" | "UHD" | null; channel: { benefitId: string; link: string } | null; preorder: boolean; scope: "episode" | "season" | "series" | "bundle" | "movie" | null; } interface PrimeVideoWatchOptions { titleId: string; entitlementType: "Entitled" | "Unentitled"; entitled: boolean; message: string; channel: { name: string; link: string } | null; offers: PrimeVideoWatchOffer[]; highValueMessage: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/getWatchOptionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.getWatchOptions("0SC64NC24QA7M9AFWBEK87WWS0");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.getWatchOptions("0SC64NC24QA7M9AFWBEK87WWS0"))curl -X POST https://api.bowmark.ai/v1/sites/prime_video/getWatchOptions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"titleId":"0SC64NC24QA7M9AFWBEK87WWS0"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.prime_video.getWatchOptions("0SC64NC24QA7M9AFWBEK87WWS0");listCategoriesList the ways Prime Video lets you browse.Arguments
None.
Returns
PrimeVideoCategory[]interface PrimeVideoCategory { name: string; slug: string; kind: "genre" | "collection" | "storefront"; path: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.listCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.listCategories())curl -X POST https://api.bowmark.ai/v1/sites/prime_video/listCategories \ -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.prime_video.listCategories();listCategoryTitlesBrowse one genre, collection or storefront and get its rows of titles back.Arguments
Name Type Required pathstringYes Returns
PrimeVideoCategoryRow[]interface PrimeVideoTitle { titleId: string; catalogId: string | null; title: string; url: string; entityType: string | null; releaseYear: number | null; maturityRating: string | null; entitled: boolean; watchMessage: string | null; } interface PrimeVideoCategoryRow { heading: string; titles: PrimeVideoTitle[]; nextPage?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/listCategoryTitlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.listCategoryTitles("/genre/comedy");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.listCategoryTitles("/genre/comedy"))curl -X POST https://api.bowmark.ai/v1/sites/prime_video/listCategoryTitles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"path":"/genre/comedy"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.prime_video.listCategoryTitles("/genre/comedy");listChannelsList the add-on subscriptions Prime Video sells inside itself.Arguments
None.
Returns
PrimeVideoChannel[]interface PrimeVideoChannel { name: string; channelId: string | null; benefitId: string | null; synopsis: string | null; offerMessage: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/listChannelsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.listChannels();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.listChannels())curl -X POST https://api.bowmark.ai/v1/sites/prime_video/listChannels \ -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.prime_video.listChannels();listContinueWatchingWhat the caller started and did not finish, and how far in they got.Arguments
None.
Returns
PrimeVideoTitle[]interface PrimeVideoTitle { titleId: string; catalogId: string | null; title: string; url: string; entityType: string | null; releaseYear: number | null; maturityRating: string | null; entitled: boolean; watchMessage: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/listContinueWatchingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.listContinueWatching();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.listContinueWatching())curl -X POST https://api.bowmark.ai/v1/sites/prime_video/listContinueWatching \ -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.prime_video.listContinueWatching();listDealsWhat is discounted to rent or buy on Prime Video this week.Arguments
None.
Returns
PrimeVideoCategoryRow[]interface PrimeVideoTitle { titleId: string; catalogId: string | null; title: string; url: string; entityType: string | null; releaseYear: number | null; maturityRating: string | null; entitled: boolean; watchMessage: string | null; } interface PrimeVideoCategoryRow { heading: string; titles: PrimeVideoTitle[]; nextPage?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/listDealsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.listDeals();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.listDeals())curl -X POST https://api.bowmark.ai/v1/sites/prime_video/listDeals \ -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.prime_video.listDeals();listEpisodesList a season's episodes with number, title, synopsis, runtime, release date, artwork, and the audio and subtitle languages each one ships.Arguments
Name Type Required titleIdstringYes Returns
PrimeVideoEpisode[]interface PrimeVideoEpisode { titleId: string | null; episodeNumber: number; title: string; synopsis: string | null; runtime: string | null; durationSeconds: number | null; releaseDate: string | null; releaseYear: number | null; images: { packshot: string | null; covershot: string | null }; audioTracks: string[]; subtitles: string[]; isUhd: boolean; isHdr: boolean; isDolbyVision: boolean; isDolbyAtmos: boolean; isXRay: boolean; isClosedCaption: boolean; isPrime: boolean; isAd: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/listEpisodesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.listEpisodes("0S1FYJ3LY9KTL9C7WFFAGA9F6F");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.listEpisodes("0S1FYJ3LY9KTL9C7WFFAGA9F6F"))curl -X POST https://api.bowmark.ai/v1/sites/prime_video/listEpisodes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"titleId":"0S1FYJ3LY9KTL9C7WFFAGA9F6F"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.prime_video.listEpisodes("0S1FYJ3LY9KTL9C7WFFAGA9F6F");listFreeToWatchWhat you can watch on Prime Video without paying anything at all.Arguments
None.
Returns
PrimeVideoCategoryRow[]interface PrimeVideoTitle { titleId: string; catalogId: string | null; title: string; url: string; entityType: string | null; releaseYear: number | null; maturityRating: string | null; entitled: boolean; watchMessage: string | null; } interface PrimeVideoCategoryRow { heading: string; titles: PrimeVideoTitle[]; nextPage?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/listFreeToWatchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.listFreeToWatch();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.listFreeToWatch())curl -X POST https://api.bowmark.ai/v1/sites/prime_video/listFreeToWatch \ -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.prime_video.listFreeToWatch();listLiveChannelsList the free live TV and news stations Prime Video streams.Arguments
Name Type Required section"livetv" | "news"Yes Returns
PrimeVideoLiveStation[]interface PrimeVideoLiveProgram { title: string; seriesTitle: string | null; start: number; end: number; } interface PrimeVideoLiveStation { id: string; name: string; logo: string | null; group: string; nowPlaying: PrimeVideoLiveProgram | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/listLiveChannelsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.listLiveChannels("livetv");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.listLiveChannels("livetv"))curl -X POST https://api.bowmark.ai/v1/sites/prime_video/listLiveChannels \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"section":"livetv"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.prime_video.listLiveChannels("livetv");listLiveSportsWhat sport is on Prime Video now and what is coming.Arguments
None.
Returns
PrimeVideoLiveSportsEvent[]interface PrimeVideoLiveSportsEvent { titleId: string; title: string; group: string; status: "LIVE" | "UPCOMING" | null; timeBadge: string | null; venue: string | null; entitled: boolean; watchMessage: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/listLiveSportsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.listLiveSports();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.listLiveSports())curl -X POST https://api.bowmark.ai/v1/sites/prime_video/listLiveSports \ -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.prime_video.listLiveSports();listNewReleasesWhat has just arrived on Prime Video and what is coming.Arguments
None.
Returns
PrimeVideoCategoryRow[]interface PrimeVideoTitle { titleId: string; catalogId: string | null; title: string; url: string; entityType: string | null; releaseYear: number | null; maturityRating: string | null; entitled: boolean; watchMessage: string | null; } interface PrimeVideoCategoryRow { heading: string; titles: PrimeVideoTitle[]; nextPage?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/listNewReleasesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.listNewReleases();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.listNewReleases())curl -X POST https://api.bowmark.ai/v1/sites/prime_video/listNewReleases \ -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.prime_video.listNewReleases();listPurchasesThe films and series the caller has already rented or bought.Arguments
None.
Returns
PrimeVideoTitle[]interface PrimeVideoTitle { titleId: string; catalogId: string | null; title: string; url: string; entityType: string | null; releaseYear: number | null; maturityRating: string | null; entitled: boolean; watchMessage: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/listPurchasesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.listPurchases();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.listPurchases())curl -X POST https://api.bowmark.ai/v1/sites/prime_video/listPurchases \ -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.prime_video.listPurchases();listRelatedTitlesWhat to watch next after this one.Arguments
Name Type Required titleIdstringYes Returns
PrimeVideoCategoryRow[]interface PrimeVideoTitle { titleId: string; catalogId: string | null; title: string; url: string; entityType: string | null; releaseYear: number | null; maturityRating: string | null; entitled: boolean; watchMessage: string | null; } interface PrimeVideoCategoryRow { heading: string; titles: PrimeVideoTitle[]; nextPage?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/listRelatedTitlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.listRelatedTitles("0SC64NC24QA7M9AFWBEK87WWS0");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.listRelatedTitles("0SC64NC24QA7M9AFWBEK87WWS0"))curl -X POST https://api.bowmark.ai/v1/sites/prime_video/listRelatedTitles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"titleId":"0SC64NC24QA7M9AFWBEK87WWS0"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.prime_video.listRelatedTitles("0SC64NC24QA7M9AFWBEK87WWS0");listSeasonsList every season of a series with the titleId that opens each one, its number, its display name, and whether it needs paying for beyond what the…Arguments
Name Type Required titleIdstringYes Returns
PrimeVideoSeason[]interface PrimeVideoSeason { seasonId: string; seasonLink: string; displayName: string; sequenceNumber: number; seasonSelectorIcon: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/listSeasonsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.listSeasons("0S1FYJ3LY9KTL9C7WFFAGA9F6F");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.listSeasons("0S1FYJ3LY9KTL9C7WFFAGA9F6F"))curl -X POST https://api.bowmark.ai/v1/sites/prime_video/listSeasons \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"titleId":"0S1FYJ3LY9KTL9C7WFFAGA9F6F"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.prime_video.listSeasons("0S1FYJ3LY9KTL9C7WFFAGA9F6F");listTop10Prime Video's own top ten right now.Arguments
Name Type Required list"tv" | "movies" | "channel"Yes channelIdstringNo Returns
PrimeVideoTop10Entry[]interface PrimeVideoTitle { titleId: string; catalogId: string | null; title: string; url: string; entityType: string | null; releaseYear: number | null; maturityRating: string | null; entitled: boolean; watchMessage: string | null; } interface PrimeVideoTop10Entry extends PrimeVideoTitle { position: number; list: "tv" | "movies" | "channel"; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/listTop10Call it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.listTop10("movies");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.listTop10("movies"))curl -X POST https://api.bowmark.ai/v1/sites/prime_video/listTop10 \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"list":"movies"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.prime_video.listTop10("movies");searchTitlesSearch Prime Video's whole catalogue for what a person would type.Arguments
Name Type Required querystringYes Returns
PrimeVideoTitle[]interface PrimeVideoTitle { titleId: string; catalogId: string | null; title: string; url: string; entityType: string | null; releaseYear: number | null; maturityRating: string | null; entitled: boolean; watchMessage: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/searchTitlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.searchTitles("the matrix");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.searchTitles("the matrix"))curl -X POST https://api.bowmark.ai/v1/sites/prime_video/searchTitles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"the matrix"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.prime_video.searchTitles("the matrix");suggestTitlesAsk Prime Video's own search box what it would autocomplete a prefix to.Arguments
Name Type Required prefixstringYes Returns
PrimeVideoTitleSuggestion[]interface PrimeVideoTitleSuggestion { value: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/suggestTitlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.suggestTitles("the boy");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.suggestTitles("the boy"))curl -X POST https://api.bowmark.ai/v1/sites/prime_video/suggestTitles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"prefix":"the boy"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.prime_video.suggestTitles("the boy");
toggleWatchlistAdd a title to the caller's watchlist, or take one off it.Arguments
Name Type Required titleIdstringYes action"add" | "remove"No Returns
{ titleId: string; action: "add" | "remove"; ok: true }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/prime_video/toggleWatchlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.prime_video.toggleWatchlist("<titleId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.prime_video.toggleWatchlist("<titleId>"))curl -X POST https://api.bowmark.ai/v1/sites/prime_video/toggleWatchlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"titleId":"<titleId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.prime_video.toggleWatchlist("<titleId>");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/prime_video/<function> - OpenAPI
/v1/sites/prime_video/openapi.json