Get Taste Suggestions

Public Beta Feature

This documentation covers a feature currently in Public Beta. Access is available to anyone interested in building personalized experiences for their end-users.

This feature is subject to the Personalization API (Self-Service) Public Beta End user License Agreement.

Parameter Definitions

• string

  • required
  • The API version date as documented here; e.g. 20231010

• intent

  • string
  • required
  • Possible values; onboarding, profileadd, tipstream, webhomepage, webonboarding, webtipstream, campaign, webcampaign, pushrec.

• limit

  • int32
  • The number of results to return, up to 50.

• offset

  • int32
  • Used to page through results, up to 50.

Response schema

{
  "meta": {
    "code": 200,
    "requestId": "6418d4f79d3430010c345539"
  },
  "notifications": [
    {
      "type": "notificationTray",
      "item": {
        "unreadCount": 0
      }
    }
  ],
  "response": {
    "seed": -1848231109,
    "tastes": [
      {
        "id": "52e132be498eafdb67fdd083",
        "text": "Caipirinhas",
        "nc": true
      },
      {
        "id": "52cb360d498e49ae1f58c916",
        "text": "Blueberry pie",
        "nc": true
      },
      {
        "id": "52cc5703498ee4ff7d523567",
        "text": "Fish tacos",
        "nc": true
      },
      {
        "id": "52e132be498e28dc84733300",
        "text": "Corn dogs",
        "nc": true
      },
      {
        "id": "53595852498eac9916cfbc03",
        "text": "Good for a late night",
        "nc": true
      },
      {
        "id": "52db1e28498e3c2c8d5d0b57",
        "text": "Horseradish"
      },
      {
        "id": "52db1e24498e327a06a4e3ac",
        "text": "Pancetta"
      },
      {
        "id": "53161703498e60c3c436433b",
        "text": "Air hockey"
      },
      {
        "id": "52cc5705498eedd6fdb86045",
        "text": "Cheddar soup",
        "nc": true
      },
      {
        "id": "52e132be498e5e2b851ae69c",
        "text": "Beignets",
        "nc": true
      }
    ]
  }
}

CURL Example

curl --request GET \
     --url https://api.foursquare.com/v2/tastes/suggestions \
     --header 'accept: application/json'