Places Feedback

Overview

The Feedback API provides the ability for your end users to directly provide feedback about Foursquare POIs.

The API includes three endpoints that provide the following functionality:

  • Propose edits to an existing POI’s information such as address, phone number, hours of operation and more.
  • Provide Feedback about a problematic POI due to a variety of reasons such as closed, mislocated and more.
  • Monitor the status of the feedback items provided by your users.

Used together, these endpoints ensure that the POIs delivered to your end users accurately reflect the real world around them at all times.

Authentication

As the Feedback API ingests input from your end users (vs your application directly), these endpoints require the use of a service account on behalf of your application.

Once you generate a Service API Key within your Developer Console, you can authenticate against the API by passing this Service Account API Key through an Authorization header parameter like so Authorization: Bearer <token>

NOTE: A Service Account API key must be used to successfully access these endpoints. Using a Places API key to authenticate will result in an error.

Endpoints

Propose Place Edit

Propose edits to an existing Place’s information.

Flag Problematic Place

Provide Feedback about a problematic Place due to a variety of reasons.

Get Feedback Status

Monitor the status of the feedback items provided by your users.