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.

Parameters

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

• venueId
  string
  required
  The venue where you want to add this tip.

• text
  string
  required
  The text of the tip, up to 200 characters.

• accept
  string
  enum
  Defaults to application/json

Generated from available response content types
application/json text/plain

HTTP Responses

200

Response when adding a tip to a venue.

• meta

  • code
    integer
    Defaults to 0
    Status code indicating the result of adding a tip to the endpoint.

• requestId
  string
  Unique identifier for the API request.

• notifications
  array of objects
  Array of notification objects for successful creation of a new tip.

• item
  object
  Notification item for successfully adding a tip.

• type
  string
  Type of notification for successful addition of a tip.

• response
  object
  The response object for successfully adding a tip.

• tip
  object
  The response object for adding a tip, including the newly created tip.

Example cURL Request

curl --request POST \
     --url https://api.foursquare.com/v2/tips/add \
     --header 'accept: application/json'

Example JSON Response

{
  "meta": {
    "code": 200,
    "requestId": "64138356813165221a961758"
  },
  "notifications": [
    {
      "type": "notificationTray",
      "item": {
        "unreadCount": 0
      }
    }
  ],
  "response": {
    "tip": {
      "id": "64138356a21d0758343e8135",
      "createdAt": 1679000406,
      "text": "Best coffee in town!",
      "type": "user",
      "canonicalUrl": "https://foursquare.com/item/64138356a21d0758343e8135",
      "canonicalPath": "/item/64138356a21d0758343e8135",
      "likes": {
        "count": 0,
        "groups": []
      },
      "viewCount": 0,
      "agreeCount": 0,
      "disagreeCount": 0,
      "venue": {
        "id": "56e845f7498e8880e6c39afa",
        "name": "Starbucks"
      },
      "user": {
        "id": "7294631",
        "firstName": "Bat",
        "lastName": "Macumba",
        "gender": "male",
        "countryCode": "US",
        "relationship": "self",
        "canonicalUrl": "https://foursquare.com/user/7294631",
        "canonicalPath": "/user/7294631",
        "photo": {
          "prefix": "https://fastly.4sqi.net/img/user/",
          "suffix": "/blank_boy.png",
          "default": true
        },
        "isAnonymous": false
      },
      "title": "Bat's tip"
    }
  }
}