Use BestTime on ChatGPT

GPT Description

Discover busy and quiet places. Real-time nightlife, sightseeing, restaurants & shopping guide

Welcome Message

Hi! I can help you find the best venues using BestTime.app's data.

GPT Prompt Starters

  • Busy bars on Tuesday evening in SoHo New York City
  • Where can I party tonight?
  • Popular things to do Thursday evening Los Angeles
  • Nightlife around Mission District SF on Sunday

GPT Action OpenAPI Spec

{
  "openapi": "3.1.0",
  "info": {
    "title": "Venue Filtering API",
    "description": "API to filter venues based on busyness, type, and location.",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://besttime.app/"
    }
  ],
  "paths": {
    "/api/v1/venues/filter/gpt": {
      "post": {
        "description": "Find venues based on various criteria such as busyness (popular visitor times), area name, time, type, and location",
        "operationId": "filterVenues",
        "parameters": [
          {
            "name": "busy_min",
            "in": "query",
            "description": "Min popular times % during the day.",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "busy_max",
            "in": "query",
            "description": "Max popular times % during the day.",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "hour_min",
            "in": "query",
            "description": "data starting after a certain hour 24-hour",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "hour_max",
            "in": "query",
            "description": "data starting before a certain hour 24-hour",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "day_int",
            "in": "query",
            "description": "0 (Monday) to 6 (Sunday). Current day if ignored",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "types",
            "in": "query",
            "description": "Types of venues to filter. Options examples are BAR, BEER, BREWERY, WINERY, CLUBS, RESTAURANT, RESTAURANT,BURGER_RESTAURANT, COFFEE,CAFE,BAKERY,TEA,BREAKFAST_RESTAURANT, SHOPPING,DEPARTMENT_STORE,MARKET,SHOPPING_CENTER, APPAREL, FAST_FOOD, SUPERMARKET, GROCERY, PARK, APPAREL, FOOD_AND_DRINK, CAFE, SHOPPING_CENTER, COFFEE, MUSEUM, LIBRARY, TOURIST_DESTINATION, SPA, MARKET,ART_GALLERY,AMUSEMENT_PARK, CHURCH,ZOO,BOTANICAL_GARDEN,MARKET,PERFORMING_ARTS,CONCERT_HALL.",
            "required": false,
            "schema": {
              "type": "string",
              "format": "csv"
            }
          },
          {
            "name": "area",
            "in": "query",
            "description": "area such as a neighborhood,city or specific POI",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "limit the number of venues returned. Max 10 in the free version.",
            "required": true,
            "schema": {
              "type": "integer",
              "default": 10,
              "minimum ": 1,
              "maximum": 10
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number to get more venues if the users asks. Max 3 in the free version.",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 0,
              "minimum ": 0,
              "maximum": 3
            }
          },
          {
            "name": "price_min",
            "in": "query",
            "description": "Min price level. 1 to 5",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 5
            }
          },
          {
            "name": "price_max",
            "in": "query",
            "description": "Max price level. 1 to 5.",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 5
            }
          },
          {
            "name": "rating_min",
            "in": "query",
            "description": "Minimum rating for a venue. Possible values are 2.0, 2.5, 3.0, 3.5, 4.0, 4.5. Venues without a rating (0) will NOT be returned when applying this filter.",
            "required": false,
            "schema": {
              "type": "number",
              "enum": [
                2,
                2.5,
                3,
                3.5,
                4,
                4.5
              ],
              "default": 3.5
            }
          },
          {
            "name": "rating_max",
            "in": "query",
            "description": "Maximum rating for a venue. Possible values are 2.0, 3.0, 3.5, 4.0, 4.5, 5.0. Venues without a rating (0) WILL be returned when applying this filter.",
            "required": false,
            "schema": {
              "type": "number",
              "enum": [
                2,
                3,
                3.5,
                4,
                4.5,
                5
              ]
            }
          },
          {
            "name": "reviews_min",
            "in": "query",
            "description": "Minimum number of reviews for a venue.",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "reviews_max",
            "in": "query",
            "description": "Maximum number of reviews for a venue.",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "order_by",
            "in": "query",
            "description": "Sort venues on foot traffic intensity data or order venues by a specific parameter. Can be reviews (popularity), rating, price_level, dwell_time_min, dwell_time_max, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23. Default is reviews (proxy for popularity). The 24 numbers represent the foot traffic data for each of the 24 hours in a day. E.g. 16 will sort the venues based on predicted foot traffic at 16:00 (4PM).",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "order",
            "in": "query",
            "description": "Order the order_by parameters ascending or descending. Can be asc or desc. Default desc.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "asc",
                "desc"
              ],
              "default": "desc"
            }
          },
          {
            "name": "foot_traffic",
            "in": "query",
            "description": "Selects which part(s) of the foot traffic data will be returned. Can be limited, day, or both. Default is limited. With limited selected, only the foot traffic data between the selected hours (hour_min and hour_max) is returned in the day_raw value result (or whole day when no hours are selected). This also applies when combining with now or live in the input. When day is selected, foot traffic data for the whole day is returned (regardless of the filtered hours) in the day_raw_whole value result. The day_raw value is in this case not returned. When both is selected, both the previously described day_raw and day_raw_whole value results are returned in the response.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "limited",
                "day",
                "both"
              ],
              "default": "limited"
            }
          }
        ],
        "requestBody": {
          "description": "Chat GPT messages history from user and GPT",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "messages": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "user",
                            "gpt"
                          ]
                        },
                        "text": {
                          "type": "string",
                          "description": "messages from user or GPT"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "a list of filtered venues. The day_raw key contains by default foot traffic percentages for each hour of the week from 6AM until 5AM next day (unless the hour_min and hour_max are used. In that case the array starts with the hour_min and ends with the hour_max value).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "OK"
                    },
                    "besttime_url": {
                      "type": "url to view this data on BestTime.app"
                    },
                    "venues": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Venue"
                      }
                    },
                    "venues_n": {
                      "type": "integer",
                      "description": "The number of venues returned by the search."
                    },
                    "window": {
                      "type": "object",
                      "properties": {
                        "day_window": {
                          "type": "string"
                        },
                        "day_window_end_int": {
                          "type": "integer"
                        },
                        "day_window_end_txt": {
                          "type": "string"
                        },
                        "day_window_start_int": {
                          "type": "integer"
                        },
                        "day_window_start_txt": {
                          "type": "string"
                        },
                        "time_local": {
                          "type": "integer"
                        },
                        "time_local_12": {
                          "type": "string"
                        },
                        "time_local_index": {
                          "type": "integer"
                        },
                        "time_window_end": {
                          "type": "integer"
                        },
                        "time_window_end_12h": {
                          "type": "string"
                        },
                        "time_window_end_ix": {
                          "type": "integer"
                        },
                        "time_window_start": {
                          "type": "integer"
                        },
                        "time_window_start_12h": {
                          "type": "string"
                        },
                        "time_window_start_ix": {
                          "type": "integer"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Venue": {
        "type": "object",
        "properties": {
          "day_info": {
            "type": "object",
            "properties": {
              "day_int": {
                "type": "integer"
              },
              "day_max": {
                "type": "integer",
                "description": "Indicating the maximum busyness percentage. Values (0 - 100%) are based on the hour with the most visitors of the day, relative to the biggest peak of the week for this venue."
              },
              "venue_closed": {
                "description": "The closing time of the venue in 24-hour int format. 0 is midnight."
              },
              "venue_open": {
                "type": "integer",
                "description": "The opening time of the venue in 24-hour int format. 0 is midnight."
              }
            }
          },
          "day_raw": {
            "type": "array",
            "items": {
              "type": "integer",
              "description": "The popular times percentage for each the hour of the week. 100% indicates the most busy visiting hour of the week for a venue. The array starts with 6AM on Monday and ends with 5AM on Monday. The array is 24 hours long."
            }
          },
          "price_level": {
            "type": "integer",
            "description": "The price level of the venue. Ranges from 1 to 5. Should be presented with one or multiple $ signs."
          },
          "rating": {
            "type": "number",
            "description": "The average rating for the venue. Ranges from 1 to 5. Should be presented as a star rating."
          },
          "reviews": {
            "type": "integer"
          },
          "venue_address": {
            "type": "string"
          },
          "venue_dwell_time_max": {
            "type": "integer",
            "description": "The maximum dwell time in minutes for the venue. This is the maximum time that the average visitor spends at the venue."
          },
          "venue_dwell_time_min": {
            "type": "integer",
            "description": "The minimum dwell time in minutes for the venue. This is the minimum time that the average visitor spends at the venue."
          },
          "venue_id": {
            "type": "string",
            "description": "Unique BestTime ID for the venue. Can be used to lookup more information about the venue using the other API endpoints."
          },
          "venue_name": {
            "type": "string"
          },
          "venue_type": {
            "type": "string"
          }
        }
      }
    }
  }
}

BestTime GPT FAQs

Currently, access to this GPT requires a ChatGPT Plus subscription.
Visit the largest GPT directory GPTsHunter.com, search to find the current GPT: "BestTime", click the button on the GPT detail page to navigate to the GPT Store. Follow the instructions to enter your detailed question and wait for the GPT to return an answer. Enjoy!
We are currently calculating its ranking on the GPT Store. Please check back later for updates.