stories

Get stories with recipe fields (v3)

Changed on

V3 includes servings, ingredients, and directions on recipe-type articles.

get/v3/stories

Request

  • Base URL
    https://partners-api.thriveglobal.com
  • Auth
    HTTP bearer

Query parameters

pageinteger

Page number

limitinteger

Items per page

localestring

Language locale (e.g. en, es, en-GB)

formatstring

Filters the response to stories of the given format, matched against the articleContentType field. Allowed values are Text, Audio and Video, matched case-insensitively, so format=video works. Pass a comma-separated list to include more than one — format=Audio,Video returns stories that are either audio or video. An unsupported value returns 400. Note that format is not the same as the article type: the contentType field holds the article type (Article, Recipe, RoleModel or WatchMeThrive) despite its name, and there is no filter for it.

stripExternalLinksboolean

When true, links to non-Thrive domains are removed from content fields; the link text is preserved. Links to thriveglobal.com and relative links are kept.

stripThriveLinksboolean

When true, links to Thrive destinations are removed from content fields; the link text is preserved. This covers thriveglobal.com and its subdomains, relative links and in-page anchors. Links to other domains are kept — send stripExternalLinks alongside this to remove those as well, or send stripAllLinks, which takes precedence over both and removes every link. Note that browsers underline and colour links by default, so any external links left in the content will still render as links unless you also strip them or override it in your own styles.

stripAllLinksboolean

When true, all links are removed from content fields; the link text is preserved. Unlike stripExternalLinks, this also removes links to thriveglobal.com and relative links.

stripStylesboolean

When true, inline style attributes are removed from HTML content fields, and the presentational elements <u>, <b> and <i> are removed while their text is kept. Semantic elements such as <em> and <strong>, all text, and all other attributes are preserved. Note that links are underlined by browsers by default, so content containing links may still render underlined unless you also strip links or override it in your own styles.

Response

Successful response

messagestring
validboolean

Example response

{
  "data": {
    "data": {
      "learnV2": {
        "getArticlesV2": {
          "items": [
            {
              "media": [
                {
                  "contentType": "audio/mpeg"
                }
              ],
              "tags": [
                {
                  "slug": "sleep",
                  "name": "Sleep"
                }
              ],
              "conditions": [
                {
                  "slug": "sleep",
                  "name": "Sleep"
                }
              ]
            }
          ]
        }
      }
    }
  }
}

Changes