BBC MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on BBC: 31 typed functions through one MCP server. No BBC API key needed.

Functions
31
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just BBC

An MCP server for BBC 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/bbc
Every site

One MCP server for BBC and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both 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.

Read 25
  • getArticleOne BBC article as data: headline, byline, published and updated times, section, topic tags (ids listTopicStories takes), the body text as ordered…

    Arguments

    NameTypeRequired
    articleIdOrUrlstringYes

    Returns BbcGetArticleResult

    interface BbcArticleBlock {
      type: string;    // the site's own block type: "paragraph", "subheading", "video", …
      text?: string;
      imageUrl?: string;
      caption?: string;
    }
    
    interface BbcArticleTopic {
      id: string;
      title: string;
    }
    
    interface BbcRelatedLink {
      headline: string;
      url: string;
    }
    
    interface BbcGetArticleResult {
      articleId: string;
      headline: string;
      byline?: string;
      section?: string;
      published?: string;   // ISO
      updated?: string;      // ISO
      topics: BbcArticleTopic[];
      body: BbcArticleBlock[];       // the article's body, in reading order
      relatedLinks: BbcRelatedLink[];
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/getArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.getArticle("cqgmrr9ekr7ko");
  • getCurrentWeatherThe latest observation BBC Weather shows for a location: temperature, wind, humidity, pressure, visibility and the observation time and station.

    Arguments

    NameTypeRequired
    locationIdstringYes

    Returns BbcGetCurrentWeatherResult

    interface BbcGetCurrentWeatherResult {
      stationName: string;
      stationDistanceKm: number | null;
      observationTime: string; // ISO 8601, the station's own local offset
      temperatureC: number | null;
      temperatureF: number | null;
      weatherType: string | null;
      windSpeedKph: number | null;
      windDirection: string | null; // e.g. "Westerly"; null when the site has none
      humidityPercent: number | null;
      pressureMb: number | null;
      visibility: string | null; // e.g. "Good", "Poor"; the site's own text
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/getCurrentWeather

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.getCurrentWeather("2643743");
  • getFixturesScores and fixtures for a sport or competition on a date: each match's teams, kick-off time, status (upcoming, live, finished, cancelled), score and…

    Arguments

    NameTypeRequired
    args{ sport: string; competition?: string; date?: string }Yes

    Returns BbcGetFixturesResult

    interface BbcFixtureMatch {
      matchId?: string; // what getMatch takes, present only when BBC built a live-coverage page for this match
      competition: string; // the site's own tournament name, e.g. "Premier League", a label; pass competitionPath on
      competitionPath?: string; // e.g. "/sport/football/nations-league", what getFixtures' competition and getStandings take
      homeTeam: string;
      awayTeam: string;
      homeTeamPath?: string; // e.g. "/sport/football/teams/belgium", what getTeam takes
      awayTeamPath?: string; // e.g. "/sport/football/teams/france", what getTeam takes
      homeScore?: string;   // absent before kickoff and on a cancelled match
      awayScore?: string;
      status: string;
      statusDetail: string; // the site's own short status word, e.g. "FT", "90'+2", "Scheduled", "Match Cancelled"
      kickOff: string;       // ISO
    }
    
    interface BbcGetFixturesResult {
      sport: string;         // the sport path this was fetched for, e.g. "/sport/football"
      competition?: string;  // the competition path, when one was passed
      date?: string;         // the single day filtered to, when `date` was passed alongside a competition
      matches: BbcFixtureMatch[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/getFixtures

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.getFixtures({ sport: "/sport/football" });
  • getForecastThe BBC Weather forecast for a location: up to 14 days (high/low, weather type, chance of rain, wind, sunrise/sunset) plus the hour-by-hour detail…

    Arguments

    NameTypeRequired
    locationIdstringYes

    Returns BbcGetForecastResult

    interface BbcForecastHourly {
      time: string;
      temperatureC: number;
      temperatureF: number;
      weatherType: string;
      chanceOfRain: number;
      windSpeedKph: number;
      humidity: number;
    }
    
    interface BbcForecastDay {
      date: string;
      highC: number;
      highF: number;
      lowC: number;
      lowF: number;
      weatherType: string;
      chanceOfRain: number;
      windSpeedKph: number;
      sunrise: string;
      sunset: string;
      hourly: BbcForecastHourly[]; // the site's own hour-by-hour detail for this day
    }
    
    interface BbcGetForecastResult {
      days: BbcForecastDay[]; // up to 14 days, the site's own order
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/getForecast

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.getForecast("2643743");
  • getLivePageA BBC live page (rolling coverage) as data: title, summary, whether it is still live, and its posts newest first.

    Arguments

    NameTypeRequired
    liveIdOrUrlstringYes

    Returns BbcGetLivePageResult

    interface BbcLivePost {
      id: string;         // the site's own asset urn, e.g. "asset:4978fe54-a49d-46c6-866b-7cd295400a4b"
      heading: string;
      text: string;
      author?: string;
      published?: string;   // ISO
      updated?: string;      // ISO
    }
    
    interface BbcGetLivePageResult {
      liveId: string;
      title: string;
      summaryPoints: string[]; // the site's own "key points" bullets; [] when none
      live: boolean;
      posts: BbcLivePost[];    // newest first, the site's own order
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/getLivePage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.getLivePage("cj4zwkp2p1kt");
  • getMatchOne match as BBC Sport shows it: teams, score, status, venue, and.

    Arguments

    NameTypeRequired
    matchIdstringYes

    Returns BbcGetMatchResult

    interface BbcMatchTeam {
      name: string;
      score?: string;         // the site's own score as of this read, e.g. "1", absent before kickoff
    }
    
    interface BbcMatchTimelineEvent {
      minute: number;
      type: string;           // "Goal" | "Penalty" | other site-defined action types, passed through verbatim
      team: string;
      player?: string;
    }
    
    interface BbcMatchPlayer {
      name: string;
      number: number;
      position: string;
      isSubstitute: boolean;
    }
    
    interface BbcMatchLineup {
      team: string;
      formation?: string;
      players: BbcMatchPlayer[];
    }
    
    interface BbcGetMatchResult {
      matchId: string;
      homeTeam: BbcMatchTeam;
      awayTeam: BbcMatchTeam;
      kickOffTime: string;    // ISO string
      status: string;
      statusDetail: string;   // the site's own short status word, e.g. "FT", "90'+2", "Scheduled", "Match Cancelled"
      venue?: string;
      competition?: string;   // the competition this match belongs to
      timeline?: BbcMatchTimelineEvent[]; // goal/penalty timeline built from the site's own per-team action lists, absent when none
      lineups?: BbcMatchLineup[];         // team lineups, absent when BBC does not cover this match that closely
      stats?: Record<string, unknown>;    // the page's own match-stats module, { home: {...}, away: {...} }, absent when not covered
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/getMatch

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.getMatch("<matchId>");
  • getPodcastOne BBC podcast or series: title, description, genres, episode count, and ten episodes a page newest first.

    Arguments

    NameTypeRequired
    args{ podcastId: string; page?: number }Yes

    Returns BbcGetPodcastResult

    interface BbcPodcastEpisodeSummary {
      episodeId: string;
      title: string;
      summary: string;
      duration?: string;
      date?: string;
      image?: string;
      url: string;
    }
    
    interface BbcGetPodcastResult {
      podcastId: string;
      title: string;
      description: string;
      image?: string;
      genres: string[];
      episodeCount: number;
      page: number;
      hasMore: boolean;
      url: string;
      episodes: BbcPodcastEpisodeSummary[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/getPodcast

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.getPodcast({ podcastId: "b015sqc7" });
  • getPodcastEpisodeOne podcast episode: title, synopsis, duration, broadcast date, and the playable media link where the page carries one.

    Arguments

    NameTypeRequired
    args{ episodeId: string }Yes

    Returns BbcGetPodcastEpisodeResult

    interface BbcGetPodcastEpisodeResult {
      episodeId: string;
      title: string;
      synopsis: string;
      duration?: string;
      date?: string;
      image?: string;
      podcast?: { podcastId: string; title: string };
      listenUrl?: string;
      requiresSubscription: boolean;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/getPodcastEpisode

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.getPodcastEpisode({ episodeId: "m0031t2m" });
  • getStandingsA competition's league table: position, team, played, won, drawn, lost, goals/points for and against, goal difference and points.

    Arguments

    NameTypeRequired
    competitionstringYes

    Returns BbcGetStandingsResult

    interface BbcStandingsRow {
      rank: number;
      team: string;
      teamPath: string;     // site-relative, e.g. "/sport/football/teams/manchester-city", what getTeam takes
      played: number;
      won: number;
      drawn: number;
      lost: number;
      goalsFor: number;
      goalsAgainst: number;
      goalDifference: number;
      points: number;
      status?: string;       // the site's own qualification/relegation label, e.g. "UEFA Champions League", "Relegation"
    }
    
    interface BbcGetStandingsResult {
      competition: string;    // the competition path this was fetched for, e.g. "/sport/football/premier-league"
      tournamentName: string; // the site's own tournament name, e.g. "Premier League"
      standings: BbcStandingsRow[]; // ranked ascending, the site's own order
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/getStandings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.getStandings("/sport/football/premier-league");
  • getTeamOne team's BBC Sport page: name, competition, its recent results and upcoming fixtures, and its latest stories.

    Arguments

    NameTypeRequired
    teamSlugOrUrlstringYes

    Returns BbcGetTeamResult

    interface BbcTeamFixture {
      opponent: string;
      date: string;          // ISO date-time string
      status: string;
      score?: string;        // "<this team's score>-<opponent's score>"
      matchId?: string;      // what getMatch takes, present only when BBC built a live-coverage page
    }
    
    interface BbcTeamStory {
      headline: string;
      url: string;
      date: string;          // the site's own display timestamp, e.g. "12:46 BST", not an ISO date
    }
    
    interface BbcGetTeamResult {
      name: string;
      recentResults: BbcTeamFixture[];   // most recent first
      upcomingFixtures: BbcTeamFixture[]; // oldest first, matching the site's own order
      stories: BbcTeamStory[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/getTeam

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.getTeam("manchester-united");
  • getVideoOne BBC video page as data: title, summary, duration, published time, section, poster image and the related-story links.

    Arguments

    NameTypeRequired
    videoIdOrUrlstringYes

    Returns BbcGetVideoResult

    interface BbcGetVideoResult {
      videoId: string;
      title: string;
      summary: string;
      duration?: number;  // seconds, from the video's own primary version
      published?: string; // ISO
      section?: string;
      image?: string;
      url: string;
      relatedLinks: BbcRelatedLink[];
    }
    
    interface BbcRelatedLink {
      headline: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/getVideo

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.getVideo("cmx236yd1nr6o");
  • getWeatherWarningsUK weather or flood warnings currently in force, grouped by region and issuing agency (Met Office for weather; the Environment Agency, SEPA or…

    Arguments

    NameTypeRequired
    type"weather" | "floods"No

    Returns BbcGetWeatherWarningsResult

    interface BbcWeatherWarningTime {
      visualTime: string;
      screenReaderTime: string;
    }
    
    interface BbcWeatherWarning {
      warningType: string;   // the site's own hazard word, e.g. "flood"
      warningLevel: string;
      warningTitle: string;
      description: string;
      source: string;
      severity: string | null;      // "red" | "amber" | "yellow", the site's own label
      severityLabel: string | null; // e.g. "Flooding possible - Be prepared"
      areasAffected: string | null;
      validFrom: BbcWeatherWarningTime | null;
      validTo: BbcWeatherWarningTime | null;
      issuedAt: BbcWeatherWarningTime | null;
      active: boolean;
    }
    
    interface BbcWeatherWarningGroup {
      region: string; // "uk" for weather; "england" | "scotland" | "wales" for floods
      agency: string | null;
      agencyUrl: string | null;
      warnings: BbcWeatherWarning[]; // [] is a real "nothing active" answer
    }
    
    interface BbcGetWeatherWarningsResult {
      warningType: "weather" | "floods";
      groups: BbcWeatherWarningGroup[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/getWeatherWarnings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.getWeatherWarnings();
  • listCompetitionsThe competitions BBC Sport covers for one sport (for football: Premier League, Championship, Champions League, …) with the key getFixtures and…

    Arguments

    NameTypeRequired
    sportstringYes

    Returns BbcListCompetitionsResult

    interface BbcCompetition {
      name: string;
      path: string;    // site-relative, e.g. "/sport/football/premier-league", what getFixtures and getStandings take
      url: string;
      category: string; // the site's own grouping, e.g. "UK & Ireland", "Europe", "International"
    }
    
    interface BbcListCompetitionsResult {
      sport: string; // the sport path this was fetched for, e.g. "/sport/football"
      competitions: BbcCompetition[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/listCompetitions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.listCompetitions("/sport/football");
  • listFollowedPodcastsThe podcasts and series the signed-in reader follows.

    Arguments

    NameTypeRequired
    args{ page?: number }No

    Returns BbcListFollowedPodcastsResult

    interface BbcFollowedPodcast {
      id: string;               // the middleware's pips URN, what unfollowPodcast takes
      podcastId: string | null; // the bare podcast id getPodcast takes
      title: string;
      summary: string;
      url: string;
      image?: string;
      latestEpisode?: { id: string | null; title: string | null; url: string | null };
    }
    
    interface BbcListFollowedPodcastsResult {
      podcasts: BbcFollowedPodcast[];
      page: number;     // 0-based, the site's own paging
      pageSize: number;
      total: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/listFollowedPodcasts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.listFollowedPodcasts();
  • listHeadlinesThe stories a BBC section page shows right now, in the page's own order and grouping: headline, summary, url, article id, image, section label and…

    Arguments

    NameTypeRequired
    args{ path?: string }No

    Returns BbcListHeadlinesResult

    interface BbcHeadline {
      headline: string;
      summary: string;
      url: string;
      articleId: string;
      image?: string;
      section: string;
      lastUpdated?: string;
    }
    
    interface BbcListHeadlinesResult {
      headlines: BbcHeadline[]; // stories in the section's own order
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/listHeadlines

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.listHeadlines();
  • listMostReadThe "Most read" list the BBC shows on its news front page: rank, headline, summary, url, article id, image and last-updated time, in the site's own…

    Arguments

    None.

    Returns BbcListMostReadResult

    interface BbcMostReadEntry {
      rank: number;      // 1-based, the site's own order
      headline: string;
      summary: string;
      url: string;
      articleId: string;
      image?: string;
      section: string;
      lastUpdated?: string;
    }
    
    interface BbcListMostReadResult {
      headlines: BbcMostReadEntry[]; // ranked, the site's own order
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/listMostRead

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.listMostRead();
  • listNewslettersThe BBC newsletters a reader can sign up to: name, description, frequency and newsletter id.

    Arguments

    None.

    Returns BbcListNewslettersResult

    interface BbcNewsletter {
      newsletterId: string;
      name: string;
      description: string;
      frequency: string;
      newsletterType: string;
      thumbnailImageUrl?: string;
    }
    
    interface BbcListNewslettersResult {
      newsletters: BbcNewsletter[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/listNewsletters

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.listNewsletters();
  • listPodcastsThe podcasts and audio series featured on BBC Audio (/audio): title, description, image and podcast id.

    Arguments

    None.

    Returns BbcListPodcastsResult

    interface BbcPodcast {
      title: string;
      description: string;
      image?: string;
      url: string;
      podcastId: string;
    }
    
    interface BbcListPodcastsResult {
      podcasts: BbcPodcast[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/listPodcasts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.listPodcasts();
  • listSavedArticlesThe signed-in reader's saved articles: headline, url, article id and when saved.

    Arguments

    NameTypeRequired
    args{ page?: number }No

    Returns BbcListSavedArticlesResult

    interface BbcSavedArticle {
      id: string;               // the middleware's content URN, what removeSavedArticle takes
      articleId: string | null; // the bare article id getArticle takes, when it is an article
      headline: string;
      summary: string;
      url: string;
      type: string | null;
      subtype: string | null;
      image?: string;
      firstPublishedAt: string | null;
      lastPublishedAt: string | null;
    }
    
    interface BbcListSavedArticlesResult {
      articles: BbcSavedArticle[];
      page: number;     // 0-based, the site's own paging
      pageSize: number;
      total: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/listSavedArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.listSavedArticles();
  • listSectionsThe BBC's own section list, read off the bbc.com top navigation.

    Arguments

    NameTypeRequired
    args{ parent?: string }No

    Returns BbcListSectionsResult

    interface BbcSection {
      title: string;
      path: string;          // site-relative, e.g. "/news/world/europe", what listHeadlines takes
      url: string;
      children: BbcSection[]; // sub-sections in the site's order; [] when none
    }
    
    interface BbcListSectionsResult {
      sections: BbcSection[]; // top-level sections, or the parent's sub-sections
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/listSections

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.listSections();
  • listSportsThe sports BBC Sport covers (football, cricket, rugby union, tennis, formula 1, golf, …) with each one's path.

    Arguments

    None.

    Returns BbcListSportsResult

    interface BbcSport {
      title: string;
      path: string;      // site-relative, e.g. "/sport/football", what listCompetitions takes
      url: string;
    }
    
    interface BbcListSportsResult {
      sports: BbcSport[]; // the sports BBC Sport covers, in the site's own order
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/listSports

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.listSports();
  • listTopicStoriesThe stories on one BBC topic page (/news/topics/<id>).

    Arguments

    NameTypeRequired
    args{ topicId: string; page?: number }Yes

    Returns BbcListTopicStoriesResult

    interface BbcHeadline {
      headline: string;
      summary: string;
      url: string;
      articleId: string;
      image?: string;
      section: string;
      lastUpdated?: string;
    }
    
    interface BbcListTopicStoriesResult {
      headlines: BbcHeadline[]; // the topic page's own order, newest first
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/listTopicStories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.listTopicStories({ topicId: "cx1m7zg0gzdt" });
  • listVideosThe videos the BBC's video hub shows: title, summary, duration, url, video id, section and date.

    Arguments

    None.

    Returns BbcListVideosResult

    interface BbcVideo {
      title: string;
      summary: string;
      duration?: string;
      url: string;
      videoId: string;
      section: string;
      date?: string;
      image?: string;
    }
    
    interface BbcListVideosResult {
      videos: BbcVideo[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/listVideos

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.listVideos();
  • searchArticlesSearch the BBC the way its search box does: headline, summary, url, article id, section and date for each result, with paging.

    Arguments

    NameTypeRequired
    args{ query: string; page?: number }Yes

    Returns BbcSearchArticlesResult

    interface BbcSearchResultRow {
      headline: string;
      summary: string;
      url: string;
      articleId: string;
      image?: string;
      section: string;
      lastUpdated?: string;
    }
    
    interface BbcSearchArticlesResult {
      results: BbcSearchResultRow[];
      total: number;  // the site's own match count, not results.length
      page: number;   // 1-based, matching the `page` argument
      pageSize: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/searchArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.searchArticles({ query: "news" });
  • searchWeatherLocationsFind BBC Weather locations by place name or postcode: name, region, country and the location id every weather function takes.

    Arguments

    NameTypeRequired
    querystringYes

    Returns BbcSearchWeatherLocationsResult

    interface BbcWeatherLocation {
      locationId: string;
      name: string;
      region?: string;
      country: string;
    }
    
    interface BbcSearchWeatherLocationsResult {
      locations: BbcWeatherLocation[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/searchWeatherLocations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.searchWeatherLocations("London");
Act 6
  • followPodcastFollow a BBC podcast or series for the signed-in reader.

    Arguments

    NameTypeRequired
    podcastIdOrUrlstringYes

    Returns BbcFollowStatus

    interface BbcFollowStatus {
      id: string;
      following: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/followPodcast

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.followPodcast("<podcastIdOrUrl>");
  • removeSavedArticleRemove an article from the signed-in reader's saved list.

    Arguments

    NameTypeRequired
    articleIdOrUrlstringYes

    Returns BbcSavedArticleStatus

    interface BbcSavedArticleStatus {
      id: string;
      saved: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/removeSavedArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.removeSavedArticle("<articleIdOrUrl>");
  • saveArticleSave a BBC article to the signed-in reader's saved list (the page's bookmark button).

    Arguments

    NameTypeRequired
    articleIdOrUrlstringYes

    Returns BbcSavedArticleStatus

    interface BbcSavedArticleStatus {
      id: string;
      saved: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/saveArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.saveArticle("<articleIdOrUrl>");
  • subscribeNewsletterSign the signed-in reader up to a BBC newsletter.

    Arguments

    NameTypeRequired
    newsletterIdstringYes

    Returns BbcNewsletterStatus

    interface BbcNewsletterStatus {
      newsletterId: string;
      subscribed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/subscribeNewsletter

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.subscribeNewsletter("<newsletterId>");
  • unfollowPodcastStop following a BBC podcast or series for the signed-in reader.

    Arguments

    NameTypeRequired
    podcastIdOrUrlstringYes

    Returns BbcFollowStatus

    interface BbcFollowStatus {
      id: string;
      following: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/unfollowPodcast

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.unfollowPodcast("<podcastIdOrUrl>");
  • unsubscribeNewsletterTake the signed-in reader off a BBC newsletter.

    Arguments

    NameTypeRequired
    newsletterIdstringYes

    Returns BbcNewsletterStatus

    interface BbcNewsletterStatus {
      newsletterId: string;
      subscribed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bbc/unsubscribeNewsletter

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bbc.unsubscribeNewsletter("<newsletterId>");

Use it from code