Reuters MCP server for AI agents

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

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

Connect

Just Reuters

An MCP server for Reuters 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/reuters
Every site

One MCP server for Reuters 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 31
  • findAuthorFind a Reuters journalist by name.

    Arguments

    NameTypeRequired
    querystring
    Author name or partial slug to search for.
    Yes

    Returns ReutersAuthor[]

    interface ReutersAuthor {
      path: string;              // /authors/<slug>/, pass to getAuthor
      slug: string;              // <slug> from the path, e.g. "john-davison"
      name: string;              // title-cased slug, e.g. "John Davison"
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/findAuthor

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.findAuthor({ query: "michelle" });
  • getArticleRead one Reuters article in full.

    Arguments

    NameTypeRequired
    urlstring
    A reuters.com article URL, from any list or search function.
    Yes

    Returns ReutersArticle

    interface ReutersArticle {
      headline: string;
      url: string;
      section: string;              // e.g. "/world/"
      authors: string[];
      publishedAt: string | null;
      updatedAt: string | null;
      body: string[];               // one entry per paragraph, tags stripped
      tags: string[];                // this article's topic/keyword tags, e.g. "NRLPA:OANT"
      tickers: string[];             // RICs linked from the body, e.g. "PSKY.O"
      image: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.getArticle({ url: "<url>" });
  • getAuthorOne Reuters journalist's page: name, role, bio, photo, social links, how many stories they have filed and their latest 20.

    Arguments

    NameTypeRequired
    pathstring
    "/authors/<slug>/" from findAuthor, a full author URL, or a bare slug.
    Yes

    Returns ReutersAuthorPage

    interface ReutersAuthorStory {
      headline: string;
      url: string;                      // pass to getArticle
      description: string | null;
      publishedAt: string | null;
      label: string | null;             // e.g. "ANALYSIS", "EXCLUSIVE"
    }
    
    interface ReutersAuthorPage {
      name: string;
      url: string;
      role: string | null;
      bio: string | null;
      image: string | null;
      links: Array<{ site: string; url: string }>; // email, twitter, linkedin…
      totalStories: number | null;
      stories: ReutersAuthorStory[];    // newest first, up to 20
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/getAuthor

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.getAuthor({ path: "/authors/john-davison/" });
  • getCompanyEventsA company's next scheduled event (typically its next earnings release) and any recent notable events (a new 52-week high/low, an unusual move)…

    Arguments

    NameTypeRequired
    ricstring
    A RIC from searchCompanies, e.g. "AAPL.O".
    Yes

    Returns ReutersCompanyEvents

    interface ReutersNextEvent {
      name: string;
      time: string;                     // ISO timestamp
    }
    
    interface ReutersRecentEvent {
      title: string;                    // the vendor's own category key, e.g. "priceMovement"
      detail: string;                   // human-readable text
      eventDate: string;                // ISO timestamp
    }
    
    interface ReutersCompanyEvents {
      ric: string;
      nextEvent: ReutersNextEvent | null;
      recentEvents: ReutersRecentEvent[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/getCompanyEvents

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.getCompanyEvents({ ric: "AAPL.O" });
  • getCompanyFinancialsA company's income statement, balance sheet and cash-flow statement, annual and quarterly, as Reuters publishes them.

    Arguments

    NameTypeRequired
    ricstring
    A RIC from searchCompanies, e.g. "AAPL.O".
    Yes

    Returns ReutersCompanyFinancials

    interface ReutersFinancialPoint {
      date: string;                     // period end, YYYY-MM-DD
      value: number | null;             // millions of the statement currency
    }
    
    interface ReutersFinancialLine {
      key: string;                      // e.g. "revenue", "totalAssets"
      label: string;
      items: ReutersFinancialPoint[];   // newest first
    }
    
    interface ReutersFinancialStatement {
      annual: ReutersFinancialLine[];
      quarterly: ReutersFinancialLine[];
    }
    
    interface ReutersCompanyFinancials {
      ric: string;
      name: string;
      currency: string | null;
      incomeStatement: ReutersFinancialStatement;
      balanceSheet: ReutersFinancialStatement;
      cashFlow: ReutersFinancialStatement;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/getCompanyFinancials

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.getCompanyFinancials({ ric: "AAPL.O" });
  • getCompanyKeyMetricsA company's key ratios on Reuters.

    Arguments

    NameTypeRequired
    ricstring
    A RIC from searchCompanies, e.g. "AAPL.O".
    Yes

    Returns ReutersCompanyKeyMetrics

    interface ReutersCompanyKeyMetrics {
      ric: string;
      beta: number | null;
      marketCap: number | null;
      valuation: {
        peTtm: number | null;
        peAnnual: number | null;
        priceToSalesTtm: number | null;
        priceToBookQuarterly: number | null;
        priceToCashFlowTtm: number | null;
        priceToFreeCashFlowTtm: number | null;
      };
      profitability: {
        grossMarginTtm: number | null;
        operatingMarginTtm: number | null;
        netMarginTtm: number | null;
        returnOnEquityTtm: number | null;
        returnOnAssets: number | null;
        returnOnInvestmentTtm: number | null;
      };
      growth: {
        revenueGrowthTtmYoy: number | null;
        revenueGrowth5y: number | null;
        epsGrowthTtmYoy: number | null;
        epsGrowth5y: number | null;
      };
      dividends: {
        dividendYieldIndicatedAnnual: number | null;
        dividendPerShareTtm: number | null;
        payoutRatioAnnual: number | null;
        dividendGrowthRate5y: number | null;
      };
      perShare: {
        epsTtm: number | null;
        bookValuePerShareAnnual: number | null;
        cashFlowPerShareTtm: number | null;
        freeCashFlowPerShareTtm: number | null;
        revenuePerShareTtm: number | null;
      };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/getCompanyKeyMetrics

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.getCompanyKeyMetrics({ ric: "AAPL.O" });
  • getCompanyProfileA company's Reuters profile.

    Arguments

    NameTypeRequired
    ricstring
    A RIC from searchCompanies, e.g. "AAPL.O".
    Yes

    Returns ReutersCompanyProfile

    interface ReutersCompanyOfficer {
      name: string;
      title: string;
      rank: number | null;
      age: number | null;
      since: number | null;             // year appointed
    }
    
    interface ReutersCompanyProfile {
      ric: string;
      name: string;
      about: string | null;
      website: string | null;
      sector: string | null;
      industry: string | null;
      street: string | null;
      city: string | null;
      state: string | null;
      postalCode: string | null;
      country: string | null;
      phone: string | null;             // e.g. "+1 408 9961010"
      officers: ReutersCompanyOfficer[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/getCompanyProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.getCompanyProfile({ ric: "AAPL.O" });
  • getLiveCoverageRead one Reuters live-coverage page (/live/…).

    Arguments

    NameTypeRequired
    urlstring
    A reuters.com/live/… URL.
    Yes

    Returns ReutersLiveCoverage

    interface ReutersLiveUpdate {
      headline: string;
      publishedAt: string | null;
      updatedAt: string | null;
      text: string;
      url: string | null;               // the update's own permalink
    }
    
    interface ReutersLiveCoverage {
      headline: string;
      url: string;
      description: string | null;
      authors: string[];
      coverageStartedAt: string | null;
      coverageEndedAt: string | null;   // null while the page is still live
      updatedAt: string | null;
      updates: ReutersLiveUpdate[];     // newest first
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/getLiveCoverage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.getLiveCoverage({ url: "<url>" });
  • getMarketOverviewThe market tables Reuters shows on its Markets pages.

    Arguments

    NameTypeRequired
    tablestring
    "indices", "currencies", "commodities", or a sector like "energy".
    Yes
    limitnumber
    1-500, default 100.
    No

    Returns ReutersMarketRow[]

    interface ReutersMarketRow {
      name: string;                     // e.g. "FTSE 100", "US Dollar", "Brent Crude"
      lastPrice: number;
      change: number;                   // price change
      changePercent: number;            // percent change
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/getMarketOverview

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.getMarketOverview({ table: "indices" });
  • getMyNewsFeedThe signed-in reader's My News feed.

    Arguments

    NameTypeRequired
    limitnumber
    1-100, default 20.
    No
    cursorstring
    The opaque endCursor from a previous page.
    No

    Returns ReutersFeedArticle[]

    interface ReutersFeedArticle {
      id: string;
      headline: string;
      url: string;
      description: string | null;
      section: string | null;
      publishedAt: string | null;
      category: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/getMyNewsFeed

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.getMyNewsFeed();
  • getPictureGalleryOne Reuters photo gallery: every picture with its caption, photographer, location, size and image url.

    Arguments

    NameTypeRequired
    urlstring
    A reuters.com/pictures/… url from listPictureGalleries.
    Yes

    Returns ReutersPictureGalleryDetail

    interface ReutersGalleryPhoto {
      id: string | null;
      url: string;                      // full-size image
      caption: string | null;           // ends with the REUTERS/<photographer> credit
      title: string | null;             // the frame's wire headline
      altText: string | null;
      photographer: string | null;
      location: string | null;
      width: number | null;
      height: number | null;
      shareUrl: string | null;
    }
    
    interface ReutersPictureGalleryDetail {
      title: string;
      url: string;
      description: string | null;
      publishedAt: string | null;
      updatedAt: string | null;
      photoCount: number;
      photos: ReutersGalleryPhoto[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/getPictureGallery

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.getPictureGallery({ url: "<url>" });
  • getPressReleaseRead one press release on reuters.com in full: title, distributing wire, dateline, date, body and images.

    Arguments

    NameTypeRequired
    urlstring
    A reuters.com/press-releases/… url from listPressReleases.
    Yes

    Returns ReutersPressReleaseDetail

    interface ReutersPressReleaseDetail {
      title: string;
      url: string;
      wire: string | null;              // the distributor, e.g. "EZNewswire"
      location: string | null;          // dateline, e.g. "CHONGQING, China"
      publishedAt: string | null;
      updatedAt: string | null;
      body: string[];                   // paragraphs, markup stripped; the issuer is named in the first
      images: Array<{ url: string; caption: string | null }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/getPressRelease

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.getPressRelease({ url: "<url>" });
  • getQuoteThe current Reuters quote for one instrument by RIC.

    Arguments

    NameTypeRequired
    ricstring
    A RIC from searchCompanies, e.g. "AAPL.O", ".SPX", "EUR=X", "CLc1".
    Yes

    Returns ReutersQuote

    interface ReutersQuote {
      ric: string;
      name: string;
      exchange: string;                // e.g. "NASDAQ"
      category: string;                // e.g. "Equity", "Index", "Foreign Exchange", "FU" (future)
      currency: string;
      last: number;
      change: number;
      changePercent: number;
      open: number;
      dayHigh: number;
      dayLow: number;
      previousClose: number;
      week52High: number;
      week52Low: number;
      volume: number | null;           // last session's volume; null when the vendor reports none (FX)
      avgVolume10Day: number | null;
      marketCap: number | null;
      peRatio: number | null;
      dividendYield: number | null;
      asOf: string;                    // ISO timestamp of the last trade
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/getQuote

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.getQuote({ ric: "AAPL.O" });
  • getVideoOne Reuters video: title, description, duration, published time, thumbnail and its playable HLS stream url.

    Arguments

    NameTypeRequired
    urlstring
    A /video/watch/id…/ url from listVideos, or the bare id.
    Yes

    Returns ReutersVideoDetail

    interface ReutersVideo {
      title: string;
      url: string;               // the video's watch page, e.g. https://www.reuters.com/video/watch/<id>/
      description: string | null;
      thumbnail: string | null;
      duration: number | null;   // seconds
      publishedAt: string | null;
    }
    
    interface ReutersVideoDetail extends ReutersVideo {
      streamUrl: string | null;         // HLS master playlist (.m3u8)
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.getVideo({ url: "<url>" });
  • listArticlesByDateEvery Reuters story published on one calendar day.

    Arguments

    NameTypeRequired
    datestringYes
    limitnumber
    1-1000, default 200.
    No

    Returns ReutersArchivedArticle[]

    interface ReutersArchivedArticle {
      headline: string;         // title-cased off the article URL's own slug, the archive carries no title field
      url: string;
      section: string;          // e.g. "/business/", or "/" if the URL carries no section segment
      publishedAt: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/listArticlesByDate

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.listArticlesByDate({ date: "2020-01-02" });
  • listCompanyNewsThe latest Reuters stories about one company, newest first.

    Arguments

    NameTypeRequired
    ricstring
    A RIC from searchCompanies, e.g. "AAPL.O".
    Yes
    limitnumber
    1-100, default 50.
    No

    Returns ReutersLatestStory[]

    interface ReutersLatestStory {
      headline: string;
      url: string;             // pass to getArticle
      section: string;         // the story's section path, e.g. "/world/europe/"
      publishedAt: string | null;
      tickers: string[];       // RICs the story is tagged with, e.g. "F.N"
      image: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/listCompanyNews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.listCompanyNews({ ric: "AAPL.O" });
  • listFollowedTopicsThe topics the signed-in reader follows in My News.

    Arguments

    None.

    Returns ReutersFollowedTopic[]

    interface ReutersFollowedTopic {
      id: string;                 // pass to followTopic / unfollowTopic
      name: string;
      type: "TAG" | "SECTION" | "LAW_FIRM" | "COMPANY" | "AUTHOR";
      category: string | null;    // only set on a TAG
      rootSection: string | null; // set on a TAG or SECTION
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/listFollowedTopics

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.listFollowedTopics();
  • listGraphicsReuters Graphics, the interactive data stories and explainers, with title, url and date, newest first.

    Arguments

    NameTypeRequired
    limitnumber
    1-500, default 50.
    No

    Returns ReutersGraphic[]

    interface ReutersGraphic {
      title: string;
      url: string;
      publishedAt: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/listGraphics

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.listGraphics({ limit: 5 });
  • listHeadlinesThe stories a Reuters section front shows right now, in the page's own order: headline, summary, url, article id, image, section and…

    Arguments

    NameTypeRequired
    sectionstring
    A path from listSections (e.g. "/business/" or "business") or a section's exact name; omit for home page.
    No
    limitnumber
    1-1000, default 100.
    No

    Returns ReutersHeadline[]

    interface ReutersHeadline {
      headline: string;
      summary?: string | null; // null if not available on the page
      url: string;
      section: string;         // the section path, e.g. "world" or empty for home
      publishedAt: string;     // ISO timestamp or null
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.listHeadlines();
  • listLatestNewsThe newest Reuters stories across the whole site, newest first.

    Arguments

    NameTypeRequired
    sectionstring
    A path from listSections, e.g. "/business/", or a section's exact name ("Middle East").
    No
    limitnumber
    1-500, default 50.
    No

    Returns ReutersLatestStory[]

    interface ReutersLatestStory {
      headline: string;
      url: string;             // pass to getArticle
      section: string;         // the story's section path, e.g. "/world/europe/"
      publishedAt: string | null;
      tickers: string[];       // RICs the story is tagged with, e.g. "F.N"
      image: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/listLatestNews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.listLatestNews({ limit: 5 });
  • listNewslettersEvery Reuters newsletter: name, id, landing page, description, frequency and whether it needs a subscription.

    Arguments

    NameTypeRequired
    querystring
    Every word must appear in the name or description.
    No

    Returns ReutersNewsletter[]

    interface ReutersNewsletter {
      name: string;
      id: string | null;                // the site's own newsletter id, e.g. "morning_bid_us"
      url: string | null;               // its landing page
      description: string | null;
      frequency: string | null;         // e.g. "Every weekday"
      subscriberOnly: boolean;          // needs a paid Reuters subscription
      image: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.listNewsletters({});
  • listNewsletterSubscriptionsThe newsletters the signed-in reader is subscribed to.

    Arguments

    NameTypeRequired
    emailstring
    The signed-in account's address.
    Yes

    Returns ReutersNewsletterSubscriptions

    interface ReutersNewsletterSubscriptions {
      email: string;
      newsletterIds: string[];    // ids as listNewsletters returns them
      raw: string | null;         // reuters.com's own String answer, unparsed
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/listNewsletterSubscriptions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.listNewsletterSubscriptions({ email: "<email>" });
  • listPictureGalleriesReuters photo galleries ("Pictures"), newest first: title, url, published time and lead image.

    Arguments

    NameTypeRequired
    limitnumber
    1-500, default 50.
    No

    Returns ReutersPictureGallery[]

    interface ReutersPictureGallery {
      title: string;              // title-cased off the gallery URL's own slug, the sitemap carries no title field
      url: string;
      publishedAt: string | null;
      image: string | null;       // the lead photo
      caption: string | null;     // the lead photo's caption and credit line
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/listPictureGalleries

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.listPictureGalleries({ limit: 5 });
  • listPodcastEpisodesThe latest episodes of one Reuters podcast show, newest first: title, description, date, duration and audio url.

    Arguments

    NameTypeRequired
    slugstring
    From listPodcasts, e.g. "reuters-morning-bid".
    Yes
    limitnumber
    1-20, default 20, the show page carries its latest 20.
    No

    Returns ReutersPodcastEpisodes

    interface ReutersPodcastEpisode {
      title: string;
      url: string;
      description: string | null;
      publishedAt: string | null;
      duration: number | null;          // seconds
      audioUrl: string | null;          // Megaphone mp3; null on a vodcast-only episode
      videoId: string | null;           // the filmed version, when there is one
      image: string | null;
    }
    
    interface ReutersPodcastEpisodes {
      show: string;
      url: string;
      description: string | null;
      episodes: ReutersPodcastEpisode[]; // newest first
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/listPodcastEpisodes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.listPodcastEpisodes({ slug: "reuters-morning-bid" });
  • listPodcastsThe Reuters podcast shows, Reuters World News, Morning Bid, Econ World, On Assignment, The Big View, Viewsroom and the rest, each with its path.

    Arguments

    NameTypeRequired
    querystring
    Every word must appear in the slug or title.
    No

    Returns ReutersPodcast[]

    interface ReutersPodcast {
      title: string;               // title-cased off the show's own slug, the sitemap carries no title field
      slug: string;                // pass to listPodcastEpisodes
      path: string;                // /podcasts/<slug>/
      url: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.listPodcasts();
  • listPressReleasesPress releases distributed on reuters.com, newest first: title, url and date.

    Arguments

    NameTypeRequired
    limitnumber
    1-500, default 50.
    No

    Returns ReutersPressRelease[]

    interface ReutersPressRelease {
      title: string;
      url: string;
      publishedAt: string | null;  // off the sitemap's own <lastmod>, not a news publication_date, this sitemap carries none
      image: string | null;        // the lead image; the sitemap carries no caption
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/listPressReleases

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.listPressReleases({ limit: 5 });
  • listSavedArticlesThe signed-in reader's saved Reuters articles: headline, url, description, section, published time and category.

    Arguments

    NameTypeRequired
    querystring
    Reuters.com's own search-within-saved filter.
    No
    limitnumber
    1-100, default 20.
    No
    cursornumber
    Pagination offset into the saved list, default 0.
    No

    Returns ReutersSavedArticle[]

    interface ReutersSavedArticle {
      id: string;
      headline: string;
      url: string;
      description: string | null;
      section: string | null;
      publishedAt: string | null;
      category: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.listSavedArticles();
  • listSectionsReuters' own section and topic list.

    Arguments

    NameTypeRequired
    querystring
    Every word must appear in the path or name.
    No

    Returns ReutersSection[]

    interface ReutersSection {
      path: string;            // pass to listLatestNews({ section }) / listHeadlines
      name: string;            // title-cased last path segment, e.g. "Energy"
      parent: string | null;   // "/business/" for "/business/energy/"
      url: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.listSections();
  • listVideosReuters videos, newest first.

    Arguments

    NameTypeRequired
    monthstring
    "YYYY-MM", omit for the newest month the site publishes.
    No
    limitnumber
    1-500, default 50.
    No

    Returns ReutersVideo[]

    interface ReutersVideo {
      title: string;
      url: string;               // the video's watch page, e.g. https://www.reuters.com/video/watch/<id>/
      description: string | null;
      thumbnail: string | null;
      duration: number | null;   // seconds
      publishedAt: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.listVideos({ limit: 5 });
  • searchArticlesSearch Reuters articles by what a person would type ("BASF Evonik", "oil prices", "Fed rate decision").

    Arguments

    NameTypeRequired
    querystring
    What a person would type, e.g. "oil prices".
    Yes
    limitnumber
    1-100, default 20.
    No
    orderBy"newest" | "oldest" | "relevance"
    Default "newest".
    No

    Returns ReutersSearchResult[]

    interface ReutersSearchResult {
      headline: string;
      url: string;                   // pass to getArticle
      section: string | null;        // the kicker's first name, e.g. "World", "Business", a label
      sectionPath: string | null;    // the article's section path, e.g. "/world/china/", what listLatestNews / listHeadlines take
      publishedAt: string | null;
      image: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.searchArticles({ query: "oil prices" });
  • searchCompaniesFind a listed company or instrument on Reuters by name or ticker ("Apple", "BASF", "gold").

    Arguments

    NameTypeRequired
    querystring
    A company name or ticker, e.g. "Apple", "BASF", "gold".
    Yes
    limitnumber
    1-50, default 20.
    No

    Returns ReutersCompanyMatch[]

    interface ReutersCompanyMatch {
      name: string;
      ric: string;                   // e.g. "AAPL.O", the finder every company/quote function needs
      exchange: string;               // e.g. "NASDAQ"
      exchangeCode: string;           // e.g. "NSQ"
      country: string;                // e.g. "US"
      currency: string;               // e.g. "USD"
      classification: string;         // e.g. "Equity", "ETF"
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/searchCompanies

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.searchCompanies({ query: "Apple" });
Act 6
  • followTopicFollow a Reuters topic, section, company, law firm or author in the reader's My News.

    Arguments

    NameTypeRequired
    idstring
    An id as listFollowedTopics returns it, e.g. "RSBI:CLIMATE-CHANGE".
    Yes
    type"TAG" | "SECTION" | "LAW_FIRM" | "COMPANY" | "AUTHOR"
    Default SECTION for a "/path", else TAG.
    No

    Returns ReutersWriteResult

    interface ReutersWriteResult {
      id: string;                 // what reuters.com echoed back
      success: boolean;           // reuters.com's own success flag
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/followTopic

    Call it

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

    Arguments

    NameTypeRequired
    idstring
    The article id listSavedArticles / getMyNewsFeed return.
    Yes

    Returns ReutersWriteResult

    interface ReutersWriteResult {
      id: string;                 // what reuters.com echoed back
      success: boolean;           // reuters.com's own success flag
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.removeSavedArticle({ id: "<id>" });
  • saveArticleSave a Reuters article to the signed-in reader's saved list.

    Arguments

    NameTypeRequired
    idstring
    The article id listSavedArticles / getMyNewsFeed return.
    Yes

    Returns ReutersWriteResult

    interface ReutersWriteResult {
      id: string;                 // what reuters.com echoed back
      success: boolean;           // reuters.com's own success flag
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.saveArticle({ id: "<id>" });
  • subscribeNewsletterSign the signed-in reader up to one or more Reuters newsletters.

    Arguments

    NameTypeRequired
    newsletterIdstring
    One id as listNewsletters returns it, e.g. "morning_bid_us".
    No
    newsletterIdsstring[]
    Or several at once.
    No
    emailstring
    The signed-in account's address.
    Yes

    Returns ReutersNewsletterResult

    interface ReutersNewsletterResult {
      newsletterIds: string[];
      subscribed: boolean;        // true for subscribeNewsletter, false for unsubscribeNewsletter
      statusCode: number;         // reuters.com's own status (under 400 = done)
      statusMessage: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.subscribeNewsletter({ email: "<email>" });
  • unfollowTopicUnfollow a Reuters topic, section, company, law firm or author in the reader's My News.

    Arguments

    NameTypeRequired
    idstring
    An id as listFollowedTopics returns it, e.g. "RSBI:CLIMATE-CHANGE".
    Yes
    type"TAG" | "SECTION" | "LAW_FIRM" | "COMPANY" | "AUTHOR"
    Default SECTION for a "/path", else TAG.
    No

    Returns ReutersWriteResult

    interface ReutersWriteResult {
      id: string;                 // what reuters.com echoed back
      success: boolean;           // reuters.com's own success flag
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reuters/unfollowTopic

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reuters.unfollowTopic({ id: "<id>" });
  • unsubscribeNewsletterUnsubscribe the signed-in reader from one or more Reuters newsletters.

    Arguments

    NameTypeRequired
    newsletterIdstring
    One id as listNewsletters returns it, e.g. "morning_bid_us".
    No
    newsletterIdsstring[]
    Or several at once.
    No
    emailstring
    The signed-in account's address.
    Yes

    Returns ReutersNewsletterResult

    interface ReutersNewsletterResult {
      newsletterIds: string[];
      subscribed: boolean;        // true for subscribeNewsletter, false for unsubscribeNewsletter
      statusCode: number;         // reuters.com's own status (under 400 = done)
      statusMessage: string | null;
    }

    HTTP endpoint

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

    Call it

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

Use it from code