Overview
This unified endpoint (full page API) consolidates and provides data from different sources grouped into modules on the page for easy integration.
Endpoint
Below is a sample query URL, with key parameters:
https://api.msn.com/news/feed/pages/msstartfeed?market=en-us&user=<userid>&ocid=<YOUR_OCID>&apiKey=<YOUR_API_KEY>&clientLocation=37.672138%7C-122.084019&clientLocationAccuracy=1000.0&clientLocationProvider=GPS&clientLocationTimestamp=2023-04-12T07%3A22%3A16Z
Current Available Modules
Each module is grouped and can be found under sections > cards[]. See below table for reference.
*new module can be added per request.
Using the API
Example: How to get fetch content for Top Stories Module (Type:Topic Feed)
You can browse for top stories content under sections > cards[]. Look for the card where id= CanonicalName-topstories.
The subCards[] contains a list of news content (default count=5) and their details. Below is an example details of a news content in subCards[]. You can get fields of the news content e.g. content type, title, URL etc. This is similar to /news/feed endpoint.
"subCards": [ { "id": "AA19G7vA", "type": "article", "title": "Louisville shooting updates: Dramatic body camera footage released", "abstract": "Updates on the April 10 mass shooting at a bank in Louisville, Kentucky.", "readTimeMin": 7, "url":"https://www.msn.com/en-us/news/crime/louisville-shooting-updates-dramatic-body-camera-footage-released/ar-AA19G7vA?ocid=XMMO", "locale": "en-us", "isLocalContent": true, "galleryItemCount": 0, "publishedDateTime": "2023-04-12T04:52:28Z", "isFeatured": false, "images": [ { "width": 1600, "height": 900, "quality": 79, "url":"https://img-s-msn-com.akamaized.net/tenant/amp/entityid/AA19K5Jh.img", "attribution": "Louisville Metro Police Department via AP", "title": "Louisville shooting live updates: Dramatic body camera footage released", "source": "msn", "colorSamples": [ { "isDarkMode": true, "hexColor": "#1D242B", "isGreyScale": false }, { "isDarkMode": false, "hexColor": "#DED5C6", "isGreyScale": false } ] } ], "provider": { "id": "BBTquMf", "name": "ABC News", "logoUrl":"https://img-s-msn-com.akamaized.net/tenant/amp/entityid/AA15spNo.img", "profileId": "vid-uqv2msu8xmhtu2ffugmt4n046hfm8j7288khugm3j40x7p8g7eka", "lightThemeSVGLogo": { "width": 35, "height": 12, "url":"https://cdn.query.prod.cms.msn.com/cms/api/amp/binary/AA13gyym" }, "darkThemeSVGLogo": { "width": 35, "height": 12, "url":"https://cdn.query.prod.cms.msn.com/cms/api/amp/binary/AA13gyym-dark" } }, "category": "news", "reactionSummary": { "totalCount": 2174, "subReactionSummaries": [ { "totalCount": 1746, "type": "downvote" }, { "totalCount": 425, "type": "upvote" }, { "totalCount": 3, "type": "like" } ] }, "reactionStatus": "on", "commentSummary": { "totalCount": 2334, "subCommentSummaries": [ { "totalCount": 2334, "type": "reply" } ] }, "commentStatus": "on", "recoDocMetadata": { "ImportantHeadline": "1" }, "feed": { "id": "Y_84ea92c6-c6e3-430b-84a6-fcc9bc038c23", "feedName": "NCAA Basketball", "lastFreActionTimestamp": 0 }, "isWorkNewsContent": false, "recoId": "ephsuLZVaK2c0uwiIFnARSDZgm", "impressionFeedbackUrl":"https://api.msn.com/Feedback/api/AppEvents?eventType=View&clientId=XMMO&market=en-us&subEventType=View&userId=m-17C60434BF974BAEB708F658395CE304&activityId=&targetId=AA19G7vA&eventTime=2023-04-12T06:22:47.8753306Z&targetType=CmsArticle", "clickFeedbackUrl":"https://api.msn.com/Feedback/api/AppEvents?eventType=Click&clientId=XMMO&market=en-us&subEventType=Click&userId=m-17C60434BF974BAEB708F658395CE304&activityId=&targetId=AA19G7vA&eventTime=2023-04-12T06:22:47.8749620Z&targetType=CmsArticle" }]
Notifications
Breaking news & trending news notification
To get notifications alerts, under sections[], look for the region where region=banner. The banner section only exists if and only if there is at least one banner The different type of notifications (Breaking News/Trending News) can be defined by the pnpNotificationType field. See table below for reference.
Example payload (Showing Breaking News & Trending News):
{ "region": "banner", "subSections": [ { "cards": [ { "id": "AA1afnWb", "type": "genericbadge", "subType": "News", "title": "虚假宣传、价格误导，李佳琦、刘畊宏、罗永浩等主播被点名", "url": "https://www.msn.cn/zh-cn/news/other/虚假宣传-价格误导-李佳琦-刘畊宏-罗永浩等主播被点名/ar-AA1afnWb?ocid=xiaomi", "isLocalContent": false, "galleryItemCount": 0, "publishedDateTime": "2023-04-24T05:01:27.0000000Z", "subTitle": "IT之家", "pnpNotificationType": "News_BreakingNews", "pnpExpirationTimeInHours": 1, "bannerIcons": [ { "type": "default", "url": "https://assets.msn.com/weathermapdata/1/static/png/72/BreakingNews_red.png", "altText": "" } ], "notificationState": "undefined", "recoId": "g9YyB3cOAqy-0i_hE6zRix5Ugm" }, { "id": "AA1afqny", "type": "genericbadge", "subType": "News", "title": "太离谱！上海一财务把公司偷得只剩20块！老板：没有当场气死就不错了...", "url": "https://www.msn.cn/zh-cn/news/other/太离谱-上海一财务把公司偷得只剩20块-老板-没有当场气死就不错了/ar-AA1afqny?ocid=xiaomi", "isLocalContent": false, "galleryItemCount": 0, "publishedDateTime": "2023-04-24T05:24:58.0000000Z", "subTitle": "每日经济新闻", "pnpNotificationType": "News_TrendingNews", "pnpExpirationTimeInHours": 1, "bannerIcons": [ { "type": "default", "url": "https://assets.msn.com/weathermapdata/1/static/png/72/BreakingNews_red.png", "altText": "" } ], "notificationState": "undefined", "recoId": "g9YyB3cOAqy-0i_hE6zRix5Ugm" } ] } ] }
Weather alerts notifications
If there is a weather alert notification, it will appear under the previews [] in the API response. E.g. from the below, you see there is a flood happening.
"previews": { "displayDurationMs": 30000, "rotationalCount": 2, "simplePreviews": [ { "cards": [ { "id": "WP_Small_Normal_png", "elements": [ { "id": "BadgeAnchorSmallTicker", "type": "Image", "url": "https://assets.msn.com/weathermapdata/1/static/weather/Icons/taskbar_v6/Condition/D200PartlySunnyV2.png" }, { "id": "BadgeAnchorLargeTicker", "type": "Image", "url": "https://assets.msn.com/weathermapdata/1/static/weather/Icons/taskbar_v6/Condition/D200PartlySunnyV2.png" }, { "id": "BadgeAnchorLargeTickerText0", "type": "TextBlock", "text": "31°C" }, { "id": "BadgeAnchorLargeTickerText1", "type": "TextBlock", "text": "Partly sunny" } ] }, { "id": "WP_Small_Normal_png", "elements": [ { "id": "WidgetsOverlayText", "type": "TextBlock", "text": "31°" } ] } ], "previewType": "Weather:NormalWeather_SevereWeather_wxswyfl_TkBs-0" }, { "cards": [ { "id": "WP_Small_AlertShortByClassLevel_png", "elements": [ { "id": "BadgeAnchorSmallTicker", "type": "Image", "url": "https://assets.msn.com/weathermapdata/1/static/weather/Icons/taskbar_v6/Alert/Alert_FL_Y.png" }, { "id": "BadgeAnchorLargeTicker", "type": "Image", "url": "https://assets.msn.com/weathermapdata/1/static/weather/Icons/taskbar_v6/Alert/Alert_FL_Y.png" }, { "id": "BadgeAnchorLargeTickerText0", "type": "TextBlock", "text": "31°C" }, { "id": "BadgeAnchorLargeTickerText1", "type": "TextBlock", "text": "Flood" } ] }, { "id": "WP_Small_AlertShortByClassLevel_png", "elements": [ { "id": "WidgetsOverlayText", "type": "TextBlock", "text": "31°" } ] } ], "previewType": "Weather:SevereWeather_SevereWeather_wxswyfl_TkRt-0" } ], "badgingInfo": { "isPreviewBadged": false } },
More specific details of the flood can also be found under WeatherSummary card.
"cards": [ { "type": "WeatherSummary", "isLocalContent": false, "galleryItemCount": 0, "position": 0, "data": "{\"responses\":[{\"weather\":[{\"alerts\":[{\"id\":\"1357\",\"title\":\"Flood - Moderate\",\"event\":\"Flood\",\"eventName\":\"General flood advisory\",\"level\":\"Moderate\",\"abbreviation\":[\"Flood\",\"Moderate\"],\"shortCap\":\"Flood\",\"severity\":\"Moderate\",\"significance\":\"Y\",\"credit\":\"PAGASA\",\"created\":\"2023-04-24T04:59:09+08:00\",\"start\":\"2023-04-24T04:59:09+08:00\",\"end\":\"2023-04-24T16:59:09+08:00\",\"class\":\"FL\",\"safetyGuide\":\"Prepare for possible flooding. Pay close attention to weather forecast and alerts.\"}],\"current\":{\"baro\":1006.0,\"cap\":\"Partly sunny\",\"capAbbr\":\"Partly sunny\",\"daytime\":\"d\",\"dewPt\":27.0,\"feels\":37.0,\"rh\":80.0,\"icon\":3,\"symbol\":\"d2000\",\"pvdrIcon\":\"3\",\"wx\":\"SHRA\",\"sky\":\"SCT\",\"temp\":31.0,\"uv\":6.0,\"uvDesc\":\"High\",\"vis\":10.0,\"windDir\":30,\"windSpd\":6.0,\"windGust\":21.0,\"created\":\"2023-04-24T15:04:19+08:00\",\"pvdrCap\":\"Partly sunny\",\"cloudCover\":51.0},\"forecast\":{\"days\":[{\"hourly\":[{\"rh\":83.0,\"icon\":4,\"symbol\":\"d3000\",\"pvdrIcon\":\"4\",\"precip\":4.0,\"sky\":\"SCT\",\"temp\":30.0,\"valid\":\"2023-04-24T16:00:00+08:00\",\"windSpd\":5.0},{\"rh\":85.0,\"icon\":4,\"symbol\":\"d3000\",\"pvdrIcon\":\"4\",\"precip\":5.0,\"sky\":\"SCT\",\"temp\":29.0,\"valid\":\"2023-04-24T17:00:00+08:00\",\"windSpd\":6.0},{\"rh\":92.0,\"icon\":31,\"symbol\":\"n3000\",\"pvdrIcon\":\"31\",\"precip\":7.0,\"sky\":\"BKN\",\"temp\":28.0,\"valid\":\"2023-04-24T18:00:00+08:00\",\"windSpd\":5.0},{\"rh\":95.0,\"icon\":31,\"symbol\":\"n3000\",\"pvdrIcon\":\"31\",\"precip\":13.0,\"sky\":\"BKN\",\"temp\":27.0,\"valid\":\"2023-04-24T19:00:00+08:00\",\"windSpd\":4.0},{\"rh\":95.0,\"icon\":31,\"symbol\":\"n3000\",\"pvdrIcon\":\"31\",\"precip\":23.0,\"sky\":\"BKN\",\"temp\":27.0,\"valid\":\"2023-04-24T20:00:00+08:00\",\"windSpd\":4.0}],\"daily\":{\"day\":{\"symbol\":\"d3000\",\"windSpd\":6.0,\"summaries\":[\"The skies will be mostly cloudy.\",\"The high will reach 32° on this humid day.\"]},\"night\":{\"symbol\":\"n3000\",\"windSpd\":2.0,\"summaries\":[\"The skies will be mostly cloudy.\",\"The low will be 23°.\"]},\"pvdrCap\":\"Mostly cloudy\",\"valid\":\"2023-04-24T00:00:00+08:00\",\"icon\":4,\"symbol\":\"d3000\",\"pvdrIcon\":\"4\",\"precip\":16.0,\"rhHi\":96.0,\"rhLo\":66.0,\"tempHi\":32.0,\"tempLo\":23.0,\"uv\":8.0,\"uvDesc\":\"Very High\",\"created\":\"2023-04-24T15:00:00+08:00\",\"rainAmount\":0.0,\"snowAmount\":0.0},\"almanac\":{\"valid\":\"2023-04-24T00:00:00+08:00\",\"sunrise\":\"2023-04-24T05:28:12+08:00\",\"sunset\":\"2023-04-24T17:47:38+08:00\"}},{\"hourly\":[],\"daily\":{\"day\":{\"symbol\":\"d3000\",\"windSpd\":8.0},\"night\":{\"symbol\":\"n2000\",\"windSpd\":3.0},\"pvdrCap\":\"Mostly cloudy\",\"valid\":\"2023-04-25T00:00:00+08:00\",\"icon\":4,\"symbol\":\"d3000\",\"pvdrIcon\":\"4\",\"precip\":11.0,\"rhHi\":95.0,\"rhLo\":63.0,\"tempHi\":32.0,\"tempLo\":24.0,\"uv\":8.0,\"uvDesc\":\"Very High\",\"created\":\"2023-04-24T15:00:00+08:00\",\"rainAmount\":0.0,\"snowAmount\":0.0}},{\"daily\":{\"day\":{\"symbol\":\"d2000\",\"windSpd\":8.0},\"night\":{\"symbol\":\"n2000\",\"windSpd\":3.0},\"pvdrCap\":\"Partly sunny\",\"valid\":\"2023-04-26T00:00:00+08:00\",\"icon\":3,\"symbol\":\"d2000\",\"pvdrIcon\":\"3\",\"precip\":16.0,\"rhHi\":95.0,\"rhLo\":61.0,\"tempHi\":32.0,\"tempLo\":24.0,\"uv\":9.0,\"uvDesc\":\"Very High\",\"created\":\"2023-04-24T15:00:00+08:00\",\"rainAmount\":0.0,\"snowAmount\":0.0}},{\"daily\":{\"day\":{\"symbol\":\"d2000\",\"windSpd\":9.0},\"night\":{\"symbol\":\"n2000\",\"windSpd\":6.0},\"pvdrCap\":\"Partly sunny\",\"valid\":\"2023-04-27T00:00:00+08:00\",\"icon\":3,\"symbol\":\"d2000\",\"pvdrIcon\":\"3\",\"precip\":19.0,\"rhHi\":95.0,\"rhLo\":61.0,\"tempHi\":32.0,\"tempLo\":24.0,\"uv\":9.0,\"uvDesc\":\"Very High\",\"created\":\"2023-04-24T15:00:00+08:00\",\"rainAmount\":0.0,\"snowAmount\":0.0}},{\"daily\":{\"day\":{\"symbol\":\"d2000\",\"windSpd\":10.0},\"night\":{\"symbol\":\"n3000\",\"windSpd\":5.0},\"pvdrCap\":\"Partly sunny\",\"valid\":\"2023-04-28T00:00:00+08:00\",\"icon\":3,\"symbol\":\"d2000\",\"pvdrIcon\":\"3\",\"precip\":21.0,\"rhHi\":94.0,\"rhLo\":62.0,\"tempHi\":32.0,\"tempLo\":24.0,\"uv\":9.0,\"uvDesc\":\"Very High\",\"created\":\"2023-04-24T15:00:00+08:00\",\"rainAmount\":0.0,\"snowAmount\":0.0}}]},\"nowcasting\":{\"precipitation\":[0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0],\"templateType\":\"NoRain\",\"minutesToTransit\":0,\"summary\":\"No rain for the next 2 hours.\",\"shortSummary\":\"No rain for 120m\",\"taskbarSummary\":\"No rain for 120m\",\"horrizonCount\":0,\"minutesBetweenHorrizons\":0,\"enableRainSignal\":false,\"raintype\":\"nr\",\"timestamp\":\"0001-01-01T00:00:00+00:00\",\"weathertype\":255,\"nowcastingDistance\":5,\"nearbyPrecipitationType\":0},\"mapsmetadata\":{\"TileImageMetadata\":{\"uris\":{\"202304231200\":\"https://assets.msn.com/weathermapdata/1/{scenario}/042312/{x}_{y}_{z}_{time}.{format}\"}},\"SevereWeatherSvg\":{\"uris\":{\"202304240707\":\"https://assets.msn.com/weathermapdata/1/severeweathersvgimage/202304240707/{x}_{y}_{z}.svg\"}},\"TemperatureGrid\":{\"uris\":{\"202304240400\":\"https://assets.msn.com/weathermapdata/1/{scenario}/{version}_0/{x}_{y}_{z}_{time}00.{format}\"}},\"TemperatureGridRR\":{\"uris\":{\"202304240700\":\"https://assets.msn.com/weathermapdata/1/{scenario}/{version}_1/{x}_{y}_{z}_{time}00.{format}?end=2023042412\"}}},\"contentdata\":[{\"id\":\"wxswyfl\",\"cid\":4,\"ranking\":300,\"contenttype\":\"SevereWeather\",\"isSpotlight\":false,\"content\":[{\"metadata\":\"{\\\"AlertIdx\\\":0,\\\"AlertId\\\":\\\"1357\\\",\\\"AlertClass\\\":\\\"FL\\\",\\\"AlertLevel\\\":\\\"Y\\\"}\"}]}],\"provider\":{\"name\":\"Foreca\",\"url\":\"http://www.foreca.com\"}}],\"source\":{\"id\":\"101703405\",\"coordinates\":{\"lat\":6.95167,\"lon\":125.09694},\"location\":{\"TimezoneName\":\"Asia/Manila\"}}}],\"userProfile\":{\"locationSettingMode\":\"1\",\"location\":{\"Country\":\"Philippines\",\"CountryCode\":\"PH\",\"State\":\"Soccsksargen\",\"City\":\"Makilala\",\"PostalCode\":\"9401\",\"UtcOffset\":\"00:00:00\",\"IsLocalized\":true,\"Accuracy\":0.02912912517786026,\"Latitude\":6.961949825286865,\"Longitude\":125.0851821899414},\"followedLocations\":[],\"detectedLocation\":{\"Country\":\"Philippines\",\"CountryCode\":\"PH\",\"State\":\"Soccsksargen\",\"City\":\"Makilala\",\"PostalCode\":\"9401\",\"UtcOffset\":\"00:00:00\",\"IsLocalized\":true,\"Accuracy\":0.02912912517786026,\"Latitude\":6.961949825286865,\"Longitude\":125.0851821899414},\"sig\":{\"ut\":0},\"eplant\":{\"ad\":false}},\"isSpotlight\":false,\"units\":{\"temperature\":\"°C\",\"speed\":\"km/h\"}}", "dataType": "WeatherOverview", "dataVersion": 1 }]
Swagger visualization
Copy and paste the below code in Swagger Editor to visualize.
openapi: '3.0.2'info: title: Microsoft News description: Microsoft News delivers breaking news and trusted, in-depth reporting from the world's best journalists. version: '1.0.0'servers: -url: https://api.msn.com -url: https://assets.msn.compaths: /news/feed/pages/{pageId}: get: summary: Represents news feed page content description: > Represents a news feed shown to the user on the Microsoft News client canvas like NTP, Prong2 or Super App. Content may include news articles, slideshows, or even structured data like sports matches. parameters: - in: path name: pageId description: The page ID defined to map to the canvas required: true schema: type: string example: msstartfeed - in: query name: market description: The locale of the content. If the market is not supported, the service will automatically choose the most appropriate value. Either market or osLcale must be specified required: true schema: type: string pattern: '^[a-zA-Z]{2}-[a-zA-Z]{2}$' example: en-us - in: query name: user description: The user for which the content should be personalized required: true schema: type: string pattern: '^(.*)-[a-fA-F0-9]{32}$' example: xxx-17C60434BF974BAEB708F658395CE304 - in: query name: ocid description: Optional moniker for the canvas or scenario schema: type: string example: '<OCID>' - in: query name: apiKey description: A unique key for your application to gain access to the API schema: type: string example: '<Your APIKEY>' - in: query name: clientLocation description: The latitude and longitude of the device location, pipe delimited schema: type: string example: '37.672138|-122.084019' - in: query name: clientLocationAccuracy description: The accuracy of the device location as a floating point number schema: type: number example: '1000.0' - in: query name: clientLocationProvider description: The provider of the device location, e.g GPS, Wifi, etc. schema: type: string example: 'GPS' - in: query name: clientLocationTimestamp description: The time that the location of the device was last updated schema: type: string example: '2023-04-12T07:22:16Z' responses: '200': description: A collection of content including both news articles as well as relevant structured data like weather and stock quotes components: schemas: Card: description: A generic content card type: object properties: type: description: A moniker that denotes the type of content type: string enum: # Groups - group - infopane - toppicks # Content Type - article - slideshow - video # Structured Data - sportsmatch - stockquote - weathersummary # Infopane - mosaic - headtohead - single - triptych example: article cardId: description: A unique ID for the card that exists within the feed and its subsequent pages. There is no guarantee that the ID will be preserved for the same card in another feed type: string example: '12' id: description: The unique ID for this piece of content throughout Microsoft News type: string example: BB17yW9S title: description: The title for the article type: string example: AMD closes just shy of $100-billion market cap, as more analysts see it taking market share from Intel abstract: description: A brief description of the content type: string example: Advanced Micro Devices Inc.’s stock soars to fresh records Tuesday after another analyst hikes his price target on the chip company, driving it to a market cap just shy of $100 billion. category: description: A localized label for the content's category, often used as the "kicker" type: string example: news publishedDateTime: description: The UTC time the content was published type: string format: date-time example: '2020-08-04T20:28:45Z' locale: description: The market for the content type: string example: en-us url: description: The url for the article type: string format: uri example:https://www.msn.com/en-us/money/savingandinvesting/amd-closes-just-shy-of-100-billion-market-cap-as-more-analysts-see-it-taking-market-share-from-intel/ar-BB17yW9S images: description: A collection of 1 or more images type: array items: $ref: '#/components/schemas/Image' example: - width: 890 height: 501 url:https://img-s-msn-com.akamaized.net/tenant/amp/entityid/BB17z0Lw.img attribution: Bloomberg title: Lisa Su, president and chief executive officer of Advanced Micro Devices Inc., watches a presentation during a launch event in San Francisco. actions: description: Represents an action a user has taken on a piece of content type: array items: $ref: '#/components/schemas/Action' example: - liked - saved reactionSummary: $ref: '#/components/schemas/ReactionSummary' commentSummary: $ref: '#/components/schemas/CommentSummary' provider: $ref: '#/components/schemas/Provider' # Only in Structured Data data: description: A JSON blob containing domain-specific data type: string format: json example:'"{"responses":[{"weather":[{"alerts":0,"current":{"baro":30.07,"cap":"Sunny","daytime":"d","dewPt":50.0,"feels":59.0,"rh":74.0,"icon":1,"pvdrIcon":"1","wx":"","sky":"FEW","temp":59.0,"uv":8.0,"uvDesc":"VeryHigh","vis":9.9,"waterTemp":32.0,"windDir":156,"windSpd":3.0,"windGust":8.0,"created":"2020-08-04T14:34:34-07:00","pvdrCap":"Sunny"},"forecast":{"days":[{"cap":"Sunny","pvdrCap":"Sunny","pvdrWindDir":"","pvdrWindSpd":"","valid":"2020-08-04T00:00:00-07:00","icon":1,"pvdrIcon":"1","precip":2.0,"tempHi":58.0,"tempLo":33.0,"created":"2020-08-04T11:46:52-07:00"}]},"provider":{"name":"Foreca","url":"http://www.foreca.com"}}],"source":{"id":"105809218","coordinates":{"lat":46.1912,"lon":-122.1944},"utcOffset":"-07:00:00","countryCode":"US"}}],"units":{"system":"Imperial","pressure":"in","temperature":"°F","speed":"mph","height":"in","distance":"mi","time":"s"},"copyright":"Copyright© 2020 Microsoft and its suppliers. All rights reserved. This API cannot beaccessed and the content and any results may not be used, reproduced ortransmitted in any manner without express written permission from MicrosoftCorporation."}"' dataVersion: description: An optional version for the domain-specific data type: integer example: 3 dataType: description: An optional domain-specific moniker for the scenario, useful for when the same JS component renders multiple experiences type: string example: forecast # Only for nested cards subCards: description: An optional collection of nested cards type: array items: $ref: '#/components/schemas/Card' example: - type: article id: BB17zdET title: WH, Dems agree to reach virus relief deal by week’s end abstract: Congress probably wouldn’t be able to vote on the package until next week, meaning that jobless Americans would have to wait. url:https://www.msn.com/en-us/news/politics/white-house-democrats-agree-to-try-for-coronavirus-relief-deal-on-evictions-unemployment-by-week-s-end/ar-BB17zdET - type: article id: BB17zPE7 title: Key takeaways from Aug. 4 primaries abstract: Michigan, Arizona, Kansas, Missouri and Washington all held primaries Tuesday. And the results are still slowly coming in. url:https://www.msn.com/en-us/news/elections-2020/roger-marshall-bests-kris-kobach-in-kansas-gop-senate-race-plus-more-key-takeaways-from-tuesday-s-primaries/ar-BB17zPE7 - type: article id: BB17yQ96 title: Pelosi sticking to $3.4 trillion stimulus price tag abstract: House Speaker Nancy Pelosi said Tuesday that she still wants a sweeping stimulus deal this week -- but she made it clear she is not budging on the price tag put forward by House Democrats, reflecting how far apart the two sides are despite days of talks. url:https://www.msn.com/en-us/news/politics/pelosi-on-the-coronavirus-stimulus-price-tag-she-s-willing-to-settle-for-3-4-trillion required: - type Image: description: An image and its dimensions type: object properties: width: description: The image's width in pixels type: integer example: 553 height: description: The image's height in pixels type: integer example: 369 url: description: The URL for the image type: string format: uri example:https://img-s-msn-com.akamaized.net/tenant/amp/entityid/BB17z3av.img title: description: The title or description for the image type: string example: The Teenager Behind the Twitter Hack and How He Did It focalRegion: description: The optional coordinates in the image to focus type: object properties: x1: description: The x-component of the first coordinate pair type: integer example: 226 x2: description: The x-component of the second coordinate pair type: integer example: 226 y1: description: The y-component of the first coordinate pair type: integer example: 210 y2: description: The y-component of the second coordinate pair type: integer example: 210 required: - x1 - x2 - y1 - y2 attribution: description: The source of the image type: string example: Tampa Bay Times/Zuma Press required: - width - height - url - title example: width: 890 height: 501 url:https://img-s-msn-com.akamaized.net/tenant/amp/entityid/BB17z0Lw.img attribution: Bloomberg title: Lisa Su, president and chief executive officer of Advanced Micro Devices Inc., watches a presentation during a launch event in San Francisco. Action: description: An image and its dimensions type: string enum: - liked - disliked - saved - read Preview: description: A single preview of a piece of content that displays a subset of its information type: object properties: relatedCardId: description: An ID for the card that is associated with the preview type: string example: '8' adaptiveCards: description: A set of adaptive cards that fit a variety of form factors $ref: '#/components/schemas/PreviewCards' additionalCards: description: An optional array of card to show in addition to the relatedCardId type: array items: $ref: '#/components/schemas/Card' required: - relatedCardId - adaptiveCards PreviewCards: description: A set of adaptive cards that fit a variety of form factors type: object properties: big: description: A big primary adaptive card preview type: string format: json example:'{"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","type":"AdaptiveCard","version":"1.0","speak":"","body":[{"type":"Container","items":[{"type":"ColumnSet","columns":[{"type":"Column","width":"50px","items":[{"type":"Image","url":"http://img-s-msn-com.akamaized.net/tenant/amp/entityid/AAehR3S.img"}]},{"type":"Column","width":"auto","items":[{"type":"TextBlock","text":"59","size":"extraLarge","spacing":"none"}]},{"type":"Column","items":[{"type":"TextBlock","text":"°F","weight":"bolder","spacing":"none"}]},{"type":"Column","width":"stretch","items":[{"type":"TextBlock","text":"Seattle,WA","size":"extraLarge","spacing":"none"}]}]}]}]}' small: description: A small primary adaptive card preview type: string format: json example: '{"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","type":"AdaptiveCard","version":"1.0","speak":"","body":[{"type":"Container","items":[{"type":"ColumnSet","columns":[{"type":"Column","width":"50px","items":[{"type":"Image","url":"http://img-s-msn-com.akamaized.net/tenant/amp/entityid/AAehR3S.img"}]},{"type":"Column","width":"auto","items":[{"type":"TextBlock","text":"59","size":"extraLarge","spacing":"none"}]},{"type":"Column","items":[{"type":"TextBlock","text":"°F","weight":"Bolder","spacing":"small"}],"width":"stretch"}]}]}]}' icon: description: An icon-only adaptive card preview type: string format: json example:'{"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","type":"AdaptiveCard","version":"1.0","body":[{"type":"Image","url":"http://img-s-msn-com.akamaized.net/tenant/amp/entityid/AAehR3S.img"}]}' PreviewCollection: description: A collection of content that displays a subset of the information contained in the cards type: object properties: displayDurationSeconds: description: The amount of time in seconds to display each rotational preview type: integer minimum: 1 example: 60 defaultPreview: description: The default preview to be displayed $ref: '#/components/schemas/Preview' rotationalCount: description: The number of rotationalPreviews type: integer minimum: 0 example: 1 rotationalPreviews: description: An array of 0 or more previews that should be displayed one after another type: array items: $ref: '#/components/schemas/Preview' required: - defaultPreview - rotationalCount Provider: description: The provider/publisher of the content type: object properties: id: description: A unique ID for the provider type: string example: AA28LZ name: description: The name of the provider type: string example: MarketWatch logoUrl: description: The URL for the provider's logo type: string format: uri example:https://img-s-msn-com.akamaized.net/tenant/amp/entityid/BBqlLky.img required: - id - name Settings: description: The various client settings stored remotely that control aspects such as refresh, etc type: object properties: refreshIntervalMinutes: description: Indicates how often to query for news content in minutes type: integer minimum: 1 example: 15 required: - refreshIntervalMinutes ReactionSummary: description: The Reaction Action summary for the content type: object properties: totalCount: description: The total amount of reactions type: integer example: 12 subReactionSummaries: description: Summaries of different kinds of reactions type: array items: $ref: '#/components/schemas/SubReactionSummary' example: - totalCount: 6 SubReactionSummary: description: Summaries of the specified type of reaction type: object properties: totalCount: description: Total amount of reactions left on the piece of content type: integer example: 3 type: type: string enum: - unknown - like - love - supprised - sad - angry - thinking CommentSummary: description: The Comment Action summary for the content type: object properties: totalCount: description: The total amount of comments type: integer example: 10 subCommentSummaries: description: Summaries of different kinds of comments type: array items: $ref: '#/components/schemas/SubCommentSummary' example: - totalCount: 3 SubCommentSummary: description: Summaries of the specified type of comment type: object properties: totalCount: description: Total amount of comment left on the piece of content type: integer example: 2 type: type: string enum: - unknown - comment - reply
