Handling COVID-19 on Foursquare

This document was last updated on 2020-04-13. Please be sure to check back here often to ensure you have the latest information from Foursquare.

COVID-19 is changing the world around us. Here at Foursquare, we want to make sure that our venues are accurately reflecting those changes. As a valued member of Foursquare's Listing Syndicators program, you are on the front lines of helping us gather the data about changes in dining options as well as hour adjustments and temporary closures related to COVID-19.

The following is a breakdown of the tools made available to you to send us proper data about the venues that are affected by the COVID-19 pandemic.

Please DO NOT update venue names to include indicators that the venue is temporarily closed. Please make sure to utilize the below methods to accurately represent your listing's hours and statuses.

Seasonal Hours

Foursquare has the ability to provide "seasonal" hours in addition to regular "default" hours, by appending times associated with a time period that will override the regular times. This is primarily meant for if the venue has different hours during certain times of the year (e.g. a zoo or ice cream shop open longer in the summer), but can also be used for applying special hours specifically for COVID-19 related hour adjustments.

Read more about submitting hours.

Temporary Closures

In addition to seasonal hours like "summer" or "winter" hours, Foursquare also has the ability to mark specific dates or large blocks of times as closed. Doing so using this method will indicate a venue is "temporary closed". This can be used for things like national holiday or emergency situations like COVID-19 related mandatory closures.

Read more about submitting hours.

Dining Options

When editing venues via the venues/proposeedit endpoint, you can also indicate the dining options available for venues. For each option, you send in a value of yes to enable that option. Available dining options include:

Option Value Description
delivery yes Does this venue do delivery?
driveThrough yes Does this venue have a drive thru?
takeout yes Does this venue have takeout options?

For example, you would make a request:

POST https://api.foursquare.com/v2/venues/VENUE_ID/proposeedit

Using your usual user authentication with an oauth_token and include in your POST payload:

{
  delivery: yes,
  driveThrough: yes,
  takeout: yes
}

or as url encoded:

...&delivery=yes&driveThrough=yes&takeout=yes

If you have any further questions, please reach out to us at: listing-syndicator@foursquare.com