Advanced filtering using collections - Full API tutorial

Team BestTime -

Using collections for advanced Venue Filtering

In this example we demonstrate how collections can be used to show predefined sets of venues to users. We can use a collection that contain all venues, or one that contain all sports bars, or one that contain all cocktail bars.
For demonstration purposes we add 5 venues to the All venues collection, 2 sports bars to the sports bars collection and 2 cocktail bars to the cocktail bars collection.

Preparing setup

Creating collections

I'm creating the following collections. One for all venues, one for cocktail bars and one for sports bars. We loop over the collection names and using the Collection Create endpoint, and we store the collection_id's for later.

All venues collection

POST

/api/v1/collection?api_key_private={{api_key_private}}&name=All venues

Returns

{
    "collection": {
        "api_key_private": "X",
        "collection_id": "col_05feffe112fa4b35aa91d999964316e9",
        "name": "All venues"
    },
    "status": "OK"
}

Cocktail bar collection

POST

/api/v1/collection?api_key_private={{api_key_private}}&name=Cocktail bars

Returns

{
    "collection": {
        "api_key_private": "X",
        "collection_id": "col_0afd0b3114704d55a5f6802099171173",
        "name": "Cocktail bars"
    },
    "status": "OK"
}

Sports bars collection

POST

/api/v1/collection?api_key_private={{api_key_private}}&name=Sports bars

Returns

{
    "collection": {
        "api_key_private": "X",
        "collection_id": "col_a1931f2f77f84443bdde3bb6a6f5d565",
        "name": "Sports bars"
    },
    "status": "OK"
}

Adding venues to the right collections

Adding to sports bars collection

We add the following two sports bars to the sports bars collection: By looping over the venue_id's and using the Collection Add endpoint

  • Happiest Hour: ven_415149775a732d724c774b52596f545a717a51754e66624a496843
  • The Toasted Monkey: ven_4d43346d6c56553869504952673477436371333146617a4a496843

Happiest Hour:

POST

/api/v1/collection/col_a1931f2f77f84443bdde3bb6a6f5d565/ven_415149775a732d724c774b52596f545a717a51754e66624a496843?api_key_private={{api_key_private}}

returns

{
    "collection_id": "col_a1931f2f77f84443bdde3bb6a6f5d565",
    "message": "Venue added to collection",
    "status": "OK",
    "venue_id": "ven_415149775a732d724c774b52596f545a717a51754e66624a496843"
}

The Toasted Monkey
POST

/api/v1/collection/col_a1931f2f77f84443bdde3bb6a6f5d565/ven_4d43346d6c56553869504952673477436371333146617a4a496843?api_key_private={{api_key_private}}

returns

{
    "collection_id": "col_a1931f2f77f84443bdde3bb6a6f5d565",
    "message": "Venue added to collection",
    "status": "OK",
    "venue_id": "ven_4d43346d6c56553869504952673477436371333146617a4a496843"
}

Adding to cocktail bars collection

  • Bahama Breeze: ven_73754670614f346e61674352676f7770447478384939504a496843
  • CVI.CHE 105: ven_55586365586437456e767552675932736d5650624365624a496843

Bahama breeze

/api/v1/collection/col_0afd0b3114704d55a5f6802099171173/ven_73754670614f346e61674352676f7770447478384939504a496843?api_key_private={{api_key_private}}

{
    "collection_id": "col_0afd0b3114704d55a5f6802099171173",
    "message": "Venue added to collection",
    "status": "OK",
    "venue_id": "ven_73754670614f346e61674352676f7770447478384939504a496843"
}

CVI.CHE 105

POST

/api/v1/collection/col_0afd0b3114704d55a5f6802099171173/ven_55586365586437456e767552675932736d5650624365624a496843?api_key_private={{api_key_private}}

{
    "collection_id": "col_0afd0b3114704d55a5f6802099171173",
    "message": "Venue added to collection",
    "status": "OK",
    "venue_id": "ven_55586365586437456e767552675932736d5650624365624a496843"
}

Adding all 4 venues to the 'All venues' collection

We add all previous 4 venues to the 'All venues' collection by looping over the venue_id's and using the Collection Add endpoint. This is basically the same as above only we use the 'All venues' collection_id 'col_05feffe112fa4b35aa91d999964316e9' instead of the sports bars or cocktail bars collection_id's.

For demonstration purposes we also add a 5th venue ONLY to the All venues collection (and not to ther other venue type specific collections)

  • STK Steakhouse: ven_636264726f4b5334487a6d52675939454d3070565437304a496843

POST

/api/v1/collection/col_05feffe112fa4b35aa91d999964316e9/ven_636264726f4b5334487a6d52675939454d3070565437304a496843?api_key_private={{api_key_private}}

Letting users use your collections

We now use the Venue Filter to filter venues using the right collection.

  • All venues: col_05feffe112fa4b35aa91d999964316e9
  • Cocktail bars: col_0afd0b3114704d55a5f6802099171173
  • Sports bars: col_a1931f2f77f84443bdde3bb6a6f5d565

Get all venues

We use the 'col_05feffe112fa4b35aa91d999964316e9' (all venues) to get all 5 venues.

/api/v1/venues/filter?collection_id=col_05feffe112fa4b35aa91d999964316e9&api_key_private={{api_key_private}}

Note: at the bottom of the API response you will see the total number of returned venues.

Click for full JSON response with 5 venues 
{
    "status": "OK",
    "venues": [
        {
            "day_info": {
                "day_int": 5,
                "day_max": 100,
                "day_mean": 75,
                "day_rank_max": 1,
                "day_rank_mean": 2,
                "day_text": "Saturday",
                "note": "Update: venue_open_close_v2 replaces venue_open and venue_closed and supports multiple opening times per day.",
                "venue_closed": 23,
                "venue_open": 11,
                "venue_open_close_v2": {
                    "12h": [
                        "11:30am–11pm"
                    ],
                    "24h": [
                        {
                            "closes": 23,
                            "opens": 11
                        }
                    ]
                }
            },
            "day_int": 5,
            "day_raw": [
                0,
                0,
                0,
                0,
                0,
                0,
                50,
                75,
                90,
                95,
                100,
                100,
                100,
                95,
                85,
                70,
                40,
                0,
                0,
                0,
                0,
                0,
                0,
                0
            ],
            "price_level": 2,
            "rating": 4.9,
            "reviews": 34782,
            "venue_address": "19501 Biscayne Blvd Aventura, FL 33180 United States",
            "venue_dwell_time_max": 0,
            "venue_dwell_time_min": 0,
            "venue_id": "ven_55586365586437456e767552675932736d5650624365624a496843",
            "venue_lat": 25.9580354,
            "venue_lng": -80.1419752,
            "venue_name": "CVI.CHE 105",
            "venue_type": "RESTAURANT"
        },
        {
            "day_info": {
                "day_int": 5,
                "day_max": 100,
                "day_mean": 66,
                "day_rank_max": 1,
                "day_rank_mean": 1,
                "day_text": "Saturday",
                "note": "Update: venue_open_close_v2 replaces venue_open and venue_closed and supports multiple opening times per day.",
                "venue_closed": 2,
                "venue_open": 11,
                "venue_open_close_v2": {
                    "12h": [
                        "11am–2am"
                    ],
                    "24h": [
                        {
                            "closes": 2,
                            "opens": 11
                        }
                    ]
                }
            },
            "day_int": 5,
            "day_raw": [
                0,
                0,
                0,
                0,
                0,
                25,
                45,
                65,
                75,
                80,
                85,
                90,
                100,
                100,
                90,
                80,
                65,
                50,
                30,
                15,
                0,
                0,
                0,
                0
            ],
            "price_level": 2,
            "rating": 4.5,
            "reviews": 16904,
            "venue_address": "3045 N Rocky Point Dr E Tampa, FL 33607 United States",
            "venue_dwell_time_max": 120,
            "venue_dwell_time_min": 60,
            "venue_id": "ven_73754670614f346e61674352676f7770447478384939504a496843",
            "venue_lat": 27.96983,
            "venue_lng": -82.56264,
            "venue_name": "Bahama Breeze",
            "venue_type": "RESTAURANT"
        },
        {
            "day_info": {
                "day_int": 5,
                "day_max": 100,
                "day_mean": 43,
                "day_rank_max": 1,
                "day_rank_mean": 2,
                "day_text": "Saturday",
                "note": "Update: venue_open_close_v2 replaces venue_open and venue_closed and supports multiple opening times per day.",
                "venue_closed": 2,
                "venue_open": 11,
                "venue_open_close_v2": {
                    "12h": [
                        "11am–2am"
                    ],
                    "24h": [
                        {
                            "closes": 2,
                            "opens": 11
                        }
                    ]
                }
            },
            "day_int": 5,
            "day_raw": [
                0,
                0,
                0,
                0,
                0,
                5,
                10,
                15,
                20,
                20,
                30,
                35,
                35,
                40,
                50,
                70,
                90,
                100,
                80,
                50,
                0,
                0,
                0,
                0
            ],
            "price_level": 2,
            "rating": 4.3,
            "reviews": 4707,
            "venue_address": "2616 Olive St Dallas, TX 75201 United States",
            "venue_dwell_time_max": 150,
            "venue_dwell_time_min": 45,
            "venue_id": "ven_415149775a732d724c774b52596f545a717a51754e66624a496843",
            "venue_lat": 32.791142,
            "venue_lng": -96.806687,
            "venue_name": "Happiest Hour",
            "venue_type": "BAR"
        },
        {
            "day_info": {
                "day_int": 5,
                "day_max": 87,
                "day_mean": 55,
                "day_rank_max": 2,
                "day_rank_mean": 2,
                "day_text": "Saturday",
                "note": "Update: venue_open_close_v2 replaces venue_open and venue_closed and supports multiple opening times per day.",
                "venue_closed": 2,
                "venue_open": 11,
                "venue_open_close_v2": {
                    "12h": [
                        "11am–2am"
                    ],
                    "24h": [
                        {
                            "closes": 2,
                            "opens": 11
                        }
                    ]
                }
            },
            "day_int": 5,
            "day_raw": [
                0,
                0,
                0,
                0,
                0,
                25,
                35,
                50,
                60,
                65,
                65,
                70,
                75,
                85,
                85,
                80,
                60,
                40,
                25,
                10,
                0,
                0,
                0,
                0
            ],
            "price_level": 2,
            "rating": 4.5,
            "reviews": 3140,
            "venue_address": "678 75th Ave St Pete Beach, FL 33706 United States",
            "venue_dwell_time_max": 0,
            "venue_dwell_time_min": 0,
            "venue_id": "ven_4d43346d6c56553869504952673477436371333146617a4a496843",
            "venue_lat": 27.740851,
            "venue_lng": -82.7538416,
            "venue_name": "The Toasted Monkey",
            "venue_type": "BAR"
        }
    ],
    "venues_n": 4,
    "window": {
        "day_window": "Saturday 6AM until Sunday 5AM",
        "day_window_end_int": 6,
        "day_window_end_txt": "Sunday",
        "day_window_start_int": 5,
        "day_window_start_txt": "Saturday",
        "time_local": 4,
        "time_local_12": "4AM",
        "time_local_index": 22,
        "time_window_end": 5,
        "time_window_end_12h": "5AM",
        "time_window_end_ix": 23,
        "time_window_start": 6,
        "time_window_start_12h": "6AM",
        "time_window_start_ix": 0
    }
}

Get all cocktail bars

We use the 'col_a1931f2f77f84443bdde3bb6a6f5d565' (sports bars) to get all sports bars.

GET

/api/v1/venues/filter?collection_ids=col_0afd0b3114704d55a5f6802099171173&api_key_private={{api_key_private}}

Results in two venues:

  • Bahama Breeze
  • CVI.CHE 105
Click for full JSON response with 2 venues 
{
    "status": "OK",
    "venues": [
        {
            "day_info": {
                "day_int": 5,
                "day_max": 100,
                "day_mean": 75,
                "day_rank_max": 1,
                "day_rank_mean": 2,
                "day_text": "Saturday",
                "note": "Update: venue_open_close_v2 replaces venue_open and venue_closed and supports multiple opening times per day.",
                "venue_closed": 23,
                "venue_open": 11,
                "venue_open_close_v2": {
                    "12h": [
                        "11:30am–11pm"
                    ],
                    "24h": [
                        {
                            "closes": 23,
                            "opens": 11
                        }
                    ]
                }
            },
            "day_int": 5,
            "day_raw": [
                0,
                0,
                0,
                0,
                0,
                0,
                50,
                75,
                90,
                95,
                100,
                100,
                100,
                95,
                85,
                70,
                40,
                0,
                0,
                0,
                0,
                0,
                0,
                0
            ],
            "price_level": 2,
            "rating": 4.9,
            "reviews": 34782,
            "venue_address": "19501 Biscayne Blvd Aventura, FL 33180 United States",
            "venue_dwell_time_max": 0,
            "venue_dwell_time_min": 0,
            "venue_id": "ven_55586365586437456e767552675932736d5650624365624a496843",
            "venue_lat": 25.9580354,
            "venue_lng": -80.1419752,
            "venue_name": "CVI.CHE 105",
            "venue_type": "RESTAURANT"
        },
        {
            "day_info": {
                "day_int": 5,
                "day_max": 100,
                "day_mean": 66,
                "day_rank_max": 1,
                "day_rank_mean": 1,
                "day_text": "Saturday",
                "note": "Update: venue_open_close_v2 replaces venue_open and venue_closed and supports multiple opening times per day.",
                "venue_closed": 2,
                "venue_open": 11,
                "venue_open_close_v2": {
                    "12h": [
                        "11am–2am"
                    ],
                    "24h": [
                        {
                            "closes": 2,
                            "opens": 11
                        }
                    ]
                }
            },
            "day_int": 5,
            "day_raw": [
                0,
                0,
                0,
                0,
                0,
                25,
                45,
                65,
                75,
                80,
                85,
                90,
                100,
                100,
                90,
                80,
                65,
                50,
                30,
                15,
                0,
                0,
                0,
                0
            ],
            "price_level": 2,
            "rating": 4.5,
            "reviews": 16904,
            "venue_address": "3045 N Rocky Point Dr E Tampa, FL 33607 United States",
            "venue_dwell_time_max": 120,
            "venue_dwell_time_min": 60,
            "venue_id": "ven_73754670614f346e61674352676f7770447478384939504a496843",
            "venue_lat": 27.96983,
            "venue_lng": -82.56264,
            "venue_name": "Bahama Breeze",
            "venue_type": "RESTAURANT"
        }
    ],
    "venues_n": 2,
    "window": {
        "day_window": "Saturday 6AM until Sunday 5AM",
        "day_window_end_int": 6,
        "day_window_end_txt": "Sunday",
        "day_window_start_int": 5,
        "day_window_start_txt": "Saturday",
        "time_local": 5,
        "time_local_12": "5AM",
        "time_local_index": 23,
        "time_window_end": 5,
        "time_window_end_12h": "5AM",
        "time_window_end_ix": 23,
        "time_window_start": 6,
        "time_window_start_12h": "6AM",
        "time_window_start_ix": 0
    }
}

Get all sports bars

We use the 'col_a1931f2f77f84443bdde3bb6a6f5d565' (sports bars) to get all sports bars.

GET

/api/v1/venues/filter?collection_ids=col_a1931f2f77f84443bdde3bb6a6f5d565&api_key_private={{api_key_private}}

Results in two venues:

  • Happiest Hour
  • The Toasted Monkey
Click for full JSON response with 2 venues 
{
    "status": "OK",
    "venues": [
        {
            "day_info": {
                "day_int": 5,
                "day_max": 100,
                "day_mean": 43,
                "day_rank_max": 1,
                "day_rank_mean": 2,
                "day_text": "Saturday",
                "note": "Update: venue_open_close_v2 replaces venue_open and venue_closed and supports multiple opening times per day.",
                "venue_closed": 2,
                "venue_open": 11,
                "venue_open_close_v2": {
                    "12h": [
                        "11am–2am"
                    ],
                    "24h": [
                        {
                            "closes": 2,
                            "opens": 11
                        }
                    ]
                }
            },
            "day_int": 5,
            "day_raw": [
                0,
                0,
                0,
                0,
                0,
                5,
                10,
                15,
                20,
                20,
                30,
                35,
                35,
                40,
                50,
                70,
                90,
                100,
                80,
                50,
                0,
                0,
                0,
                0
            ],
            "price_level": 2,
            "rating": 4.3,
            "reviews": 4707,
            "venue_address": "2616 Olive St Dallas, TX 75201 United States",
            "venue_dwell_time_max": 150,
            "venue_dwell_time_min": 45,
            "venue_id": "ven_415149775a732d724c774b52596f545a717a51754e66624a496843",
            "venue_lat": 32.791142,
            "venue_lng": -96.806687,
            "venue_name": "Happiest Hour",
            "venue_type": "BAR"
        },
        {
            "day_info": {
                "day_int": 5,
                "day_max": 87,
                "day_mean": 55,
                "day_rank_max": 2,
                "day_rank_mean": 2,
                "day_text": "Saturday",
                "note": "Update: venue_open_close_v2 replaces venue_open and venue_closed and supports multiple opening times per day.",
                "venue_closed": 2,
                "venue_open": 11,
                "venue_open_close_v2": {
                    "12h": [
                        "11am–2am"
                    ],
                    "24h": [
                        {
                            "closes": 2,
                            "opens": 11
                        }
                    ]
                }
            },
            "day_int": 5,
            "day_raw": [
                0,
                0,
                0,
                0,
                0,
                25,
                35,
                50,
                60,
                65,
                65,
                70,
                75,
                85,
                85,
                80,
                60,
                40,
                25,
                10,
                0,
                0,
                0,
                0
            ],
            "price_level": 2,
            "rating": 4.5,
            "reviews": 3140,
            "venue_address": "678 75th Ave St Pete Beach, FL 33706 United States",
            "venue_dwell_time_max": 0,
            "venue_dwell_time_min": 0,
            "venue_id": "ven_4d43346d6c56553869504952673477436371333146617a4a496843",
            "venue_lat": 27.740851,
            "venue_lng": -82.7538416,
            "venue_name": "The Toasted Monkey",
            "venue_type": "BAR"
        }
    ],
    "venues_n": 2,
    "window": {
        "day_window": "Saturday 6AM until Sunday 5AM",
        "day_window_end_int": 6,
        "day_window_end_txt": "Sunday",
        "day_window_start_int": 5,
        "day_window_start_txt": "Saturday",
        "time_local": 5,
        "time_local_12": "5AM",
        "time_local_index": 23,
        "time_window_end": 5,
        "time_window_end_12h": "5AM",
        "time_window_end_ix": 23,
        "time_window_start": 6,
        "time_window_start_12h": "6AM",
        "time_window_start_ix": 0
    }
}

Combining collection_id

The Venue filter API accepts both a 'collection_id' parameter to filter one collection, but since recently also the 'collection_ids' parameter to filter multiple collections.

We can combine both parameters to filter for example sports bars and cocktail bars at the same time.

GET

api/v1/venues/filter?collection_ids=col_0afd0b3114704d55a5f6802099171173,col_a1931f2f77f84443bdde3bb6a6f5d565&api_key_private={{api_key_private}}

This results in 4 venues:

  • Bahama Breeze
  • CVI.CHE 105
  • Happiest Hour
  • The Toasted Monkey

As you can see the Steak restaurant is not included in the result.

Click for full JSON response with 4 venues ```json { "status": "OK", "venues": [ { "day_info": { "day_int": 3, "day_max": 49, "day_mean": 41, "day_rank_max": 4, "day_rank_mean": 4, "day_text": "Thursday", "note": "Update: venue_open_close_v2 replaces venue_open and venue_closed and supports multiple opening times per day.", "venue_closed": 22, "venue_open": 11, "venue_open_close_v2": { "12h": [ "11:30am–10:30pm" ], "24h": [ { "closes": 22, "opens": 11 } ] } }, "day_int": 3, "day_raw": [ 0, 0, 0, 0, 0, 20, 30, 40, 45, 45, 45, 45, 50, 50, 45, 40, 20, 0, 0, 0, 0, 0, 0, 0 ], "price_level": 2, "rating": 4.9, "reviews": 34782, "venue_address": "19501 Biscayne Blvd Aventura, FL 33180 United States", "venue_dwell_time_max": 0, "venue_dwell_time_min": 0, "venue_id": "ven_55586365586437456e767552675932736d5650624365624a496843", "venue_lat": 25.9580354, "venue_lng": -80.1419752, "venue_name": "CVI.CHE 105", "venue_type": "RESTAURANT" }, { "day_info": { "day_int": 3, "day_max": 52, "day_mean": 35, "day_rank_max": 4, "day_rank_mean": 4, "day_text": "Thursday", "note": "Update: venue_open_close_v2 replaces venue_open and venue_closed and supports multiple opening times per day.", "venue_closed": 0, "venue_open": 11, "venue_open_close_v2": { "12h": [ "11am–12am" ], "24h": [ { "closes": 0, "opens": 11 } ] } }, "day_int": 3, "day_raw": [ 0, 0, 0, 0, 0, 20, 30, 35, 30, 30, 35, 40, 50, 50, 50, 40, 25, 15, 0, 0, 0, 0, 0, 0 ], "price_level": 2, "rating": 4.5, "reviews": 16904, "venue_address": "3045 N Rocky Point Dr E Tampa, FL 33607 United States", "venue_dwell_time_max": 120, "venue_dwell_time_min": 60, "venue_id": "ven_73754670614f346e61674352676f7770447478384939504a496843", "venue_lat": 27.96983, "venue_lng": -82.56264, "venue_name": "Bahama Breeze", "venue_type": "RESTAURANT" }, { "day_info": { "day_int": 3, "day_max": 32, "day_mean": 21, "day_rank_max": 3, "day_rank_mean": 4, "day_text": "Thursday", "note": "Update: venue_open_close_v2 replaces venue_open and venue_closed and supports multiple opening times per day.", "venue_closed": 2, "venue_open": 16, "venue_open_close_v2": { "12h": [ "4pm–2am" ], "24h": [ { "closes": 2, "opens": 16 } ] } }, "day_int": 3, "day_raw": [ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 15, 20, 25, 25, 30, 30, 30, 20, 10, 5, 0, 0, 0, 0 ], "price_level": 2, "rating": 4.3, "reviews": 4707, "venue_address": "2616 Olive St Dallas, TX 75201 United States", "venue_dwell_time_max": 150, "venue_dwell_time_min": 45, "venue_id": "ven_415149775a732d724c774b52596f545a717a51754e66624a496843", "venue_lat": 32.791142, "venue_lng": -96.806687, "venue_name": "Happiest Hour", "venue_type": "BAR" }, { "day_info": { "day_int": 3, "day_max": 57, "day_mean": 35, "day_rank_max": 4, "day_rank_mean": 4, "day_text": "Thursday", "note": "Update: venue_open_close_v2 replaces venue_open and venue_closed and supports multiple opening times per day.", "venue_closed": 0, "venue_open": 11, "venue_open_close_v2": { "12h": [ "11am–12am" ], "24h": [ { "closes": 0, "opens": 11 } ] } }, "day_int": 3, "day_raw": [ 0, 0, 0, 0, 0, 15, 20, 25, 30, 35, 40, 45, 50, 55, 50, 40, 25, 15, 0, 0, 0, 0, 0, 0 ], "price_level": 2, "rating": 4.5, "reviews": 3140, "venue_address": "678 75th Ave St Pete Beach, FL 33706 United States", "venue_dwell_time_max": 0, "venue_dwell_time_min": 0, "venue_id": "ven_4d43346d6c56553869504952673477436371333146617a4a496843", "venue_lat": 27.740851, "venue_lng": -82.7538416, "venue_name": "The Toasted Monkey", "venue_type": "BAR" } ], "venues_n": 4, "window": { "day_window": "Thursday 6AM until Friday 5AM", "day_window_end_int": 4, "day_window_end_txt": "Friday", "day_window_start_int": 3, "day_window_start_txt": "Thursday", "time_local": 5, "time_local_12": "5AM", "time_local_index": 23, "time_window_end": 5, "time_window_end_12h": "5AM", "time_window_end_ix": 23, "time_window_start": 6, "time_window_start_12h": "6AM", "time_window_start_ix": 0 } } ```

Combining All venues + Sports bar

To demonstrate that combining collections does not result in duplicate we combine the All Venues and Sports Bar collection in the Venue Filter API. The All Venues Collection contains 5 venues, and the Sports bar collection 2. The Venue Filter result is 5 venues.

GET

/api/v1/venues/filter?collection_ids=col_05feffe112fa4b35aa91d999964316e9,col_a1931f2f77f84443bdde3bb6a6f5d565&api_key_private={{api_key_private}}

Result

Click for full JSON response with 5 venues ```json { "status": "OK", "venues": [ { "day_info": { "day_int": 3, "day_max": 49, "day_mean": 41, "day_rank_max": 4, "day_rank_mean": 4, "day_text": "Thursday", "note": "Update: venue_open_close_v2 replaces venue_open and venue_closed and supports multiple opening times per day.", "venue_closed": 22, "venue_open": 11, "venue_open_close_v2": { "12h": [ "11:30am–10:30pm" ], "24h": [ { "closes": 22, "opens": 11 } ] } }, "day_int": 3, "day_raw": [ 0, 0, 0, 0, 0, 20, 30, 40, 45, 45, 45, 45, 50, 50, 45, 40, 20, 0, 0, 0, 0, 0, 0, 0 ], "price_level": 2, "rating": 4.9, "reviews": 34782, "venue_address": "19501 Biscayne Blvd Aventura, FL 33180 United States", "venue_dwell_time_max": 0, "venue_dwell_time_min": 0, "venue_id": "ven_55586365586437456e767552675932736d5650624365624a496843", "venue_lat": 25.9580354, "venue_lng": -80.1419752, "venue_name": "CVI.CHE 105", "venue_type": "RESTAURANT" }, { "day_info": { "day_int": 3, "day_max": 52, "day_mean": 35, "day_rank_max": 4, "day_rank_mean": 4, "day_text": "Thursday", "note": "Update: venue_open_close_v2 replaces venue_open and venue_closed and supports multiple opening times per day.", "venue_closed": 0, "venue_open": 11, "venue_open_close_v2": { "12h": [ "11am–12am" ], "24h": [ { "closes": 0, "opens": 11 } ] } }, "day_int": 3, "day_raw": [ 0, 0, 0, 0, 0, 20, 30, 35, 30, 30, 35, 40, 50, 50, 50, 40, 25, 15, 0, 0, 0, 0, 0, 0 ], "price_level": 2, "rating": 4.5, "reviews": 16904, "venue_address": "3045 N Rocky Point Dr E Tampa, FL 33607 United States", "venue_dwell_time_max": 120, "venue_dwell_time_min": 60, "venue_id": "ven_73754670614f346e61674352676f7770447478384939504a496843", "venue_lat": 27.96983, "venue_lng": -82.56264, "venue_name": "Bahama Breeze", "venue_type": "RESTAURANT" }, { "day_info": { "day_int": 3, "day_max": 44, "day_mean": 32, "day_rank_max": 6, "day_rank_mean": 5, "day_text": "Thursday", "note": "Update: venue_open_close_v2 replaces venue_open and venue_closed and supports multiple opening times per day.", "venue_closed": 23, "venue_open": 11, "venue_open_close_v2": { "12h": [ "11am–11:30pm" ], "24h": [ { "closes": 23, "opens": 11 } ] } }, "day_int": 3, "day_raw": [ 0, 0, 0, 0, 0, 15, 20, 20, 25, 30, 35, 35, 40, 45, 45, 40, 35, 30, 0, 0, 0, 0, 0, 0 ], "price_level": 4, "rating": 4.5, "reviews": 13873, "venue_address": "1075 Peachtree St NE Atlanta, GA 30309 United States", "venue_dwell_time_max": 150, "venue_dwell_time_min": 90, "venue_id": "ven_636264726f4b5334487a6d52675939454d3070565437304a496843", "venue_lat": 33.7840453, "venue_lng": -84.3827642, "venue_name": "STK Steakhouse", "venue_type": "STEAK_RESTAURANT" }, { "day_info": { "day_int": 3, "day_max": 32, "day_mean": 21, "day_rank_max": 3, "day_rank_mean": 4, "day_text": "Thursday", "note": "Update: venue_open_close_v2 replaces venue_open and venue_closed and supports multiple opening times per day.", "venue_closed": 2, "venue_open": 16, "venue_open_close_v2": { "12h": [ "4pm–2am" ], "24h": [ { "closes": 2, "opens": 16 } ] } }, "day_int": 3, "day_raw": [ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 15, 20, 25, 25, 30, 30, 30, 20, 10, 5, 0, 0, 0, 0 ], "price_level": 2, "rating": 4.3, "reviews": 4707, "venue_address": "2616 Olive St Dallas, TX 75201 United States", "venue_dwell_time_max": 150, "venue_dwell_time_min": 45, "venue_id": "ven_415149775a732d724c774b52596f545a717a51754e66624a496843", "venue_lat": 32.791142, "venue_lng": -96.806687, "venue_name": "Happiest Hour", "venue_type": "BAR" }, { "day_info": { "day_int": 3, "day_max": 57, "day_mean": 35, "day_rank_max": 4, "day_rank_mean": 4, "day_text": "Thursday", "note": "Update: venue_open_close_v2 replaces venue_open and venue_closed and supports multiple opening times per day.", "venue_closed": 0, "venue_open": 11, "venue_open_close_v2": { "12h": [ "11am–12am" ], "24h": [ { "closes": 0, "opens": 11 } ] } }, "day_int": 3, "day_raw": [ 0, 0, 0, 0, 0, 15, 20, 25, 30, 35, 40, 45, 50, 55, 50, 40, 25, 15, 0, 0, 0, 0, 0, 0 ], "price_level": 2, "rating": 4.5, "reviews": 3140, "venue_address": "678 75th Ave St Pete Beach, FL 33706 United States", "venue_dwell_time_max": 0, "venue_dwell_time_min": 0, "venue_id": "ven_4d43346d6c56553869504952673477436371333146617a4a496843", "venue_lat": 27.740851, "venue_lng": -82.7538416, "venue_name": "The Toasted Monkey", "venue_type": "BAR" } ], "venues_n": 5, "window": { "day_window": "Thursday 6AM until Friday 5AM", "day_window_end_int": 4, "day_window_end_txt": "Friday", "day_window_start_int": 3, "day_window_start_txt": "Thursday", "time_local": 4, "time_local_12": "4AM", "time_local_index": 22, "time_window_end": 5, "time_window_end_12h": "5AM", "time_window_end_ix": 23, "time_window_start": 6, "time_window_start_12h": "6AM", "time_window_start_ix": 0 } } ```

Conclusion

The collections API is a powerful tool to curate venues. You can create a list of all your venues, but also create collections for specific niche venues like Cocktail bars and Sports bars. On other words you can 'tag' venues with specific names, by adding them to custom collections.