Filtering, search and pagination

Narrow results with filters and full-text search, and page through large result sets.

Most NewLiquorLicenses search endpoints accept query parameters to filter results, plus limit and offset to page through them.

Filter and search

Use q for full-text search across fields, and the endpoint-specific filters listed on each reference page. Combine as many as you need:

GET https://newliquorlicenses-us-liquor-license-data.p.rapidapi.com/liquor_license?q=example&limit=50

Page through results

Responses include a count and an offset. Increase offset by your limit to walk the results:

GET https://newliquorlicenses-us-liquor-license-data.p.rapidapi.com/liquor_license?limit=100&offset=0
GET https://newliquorlicenses-us-liquor-license-data.p.rapidapi.com/liquor_license?limit=100&offset=100

Limits

limit is capped at 500 records per request, and offset at 9500. Asking for more returns a 422 or 400 explaining the ceiling.

Going past 9500 records

Offset paging stops at 9500. To walk a larger result set, pass the next_cursor from each response back as cursor on the next request, and keep going until next_cursor comes back null:

GET https://newliquorlicenses-us-liquor-license-data.p.rapidapi.com/liquor_license?limit=500
GET https://newliquorlicenses-us-liquor-license-data.p.rapidapi.com/liquor_license?limit=500&cursor=THE_NEXT_CURSOR_FROM_THE_LAST_RESPONSE

Cursor paging cannot be combined with sort_by=value, sort_by=published or sort_by=closing.