What is the difference between the offset and offset_token parameters?
in
While working with сertain DataForSEO endpoints (like Top Searches or Business Listings Search, for example) you may have encountered offset and offset_token parameters in the documentation. Both parameters have a similar function – they allow for retrieving results from our databases in subsequent batches. The principle is that the parameters omit a specified portion of results and return data starting from a particular position in the dataset. However, despite this similarity, these parameters serve different purposes and are designed for distinct use cases.
Understanding the offset parameter
The offset parameter works as a simple numeric skip value. When you specify an offset with a certain number, the API skips the specified number of result items in the response and begins to return data from the subsequent result item.
Let’s explain offset using the Business Listings Search endpoint as an example. Here is a request to this endpoint with a limit value of 1.
Request example:
[
{
"categories": [
"pizza_restaurant"
],
"description": "pizza",
"title": "pizza",
"is_claimed": true,
"location_name": "United States",
"order_by": [
"rating.value,desc"
],
"filters": [
[
"rating.value",
">",
3
]
],
"limit": 1
}
]
Response example:
{
"version": "0.1.20251208",
"status_code": 20000,
"status_message": "Ok.",
"time": "2.5071 sec.",
"cost": 0.0103,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "12200006-1535-0544-0000-16c8ec374f38",
"status_code": 20000,
"status_message": "Ok.",
"time": "2.3961 sec.",
"cost": 0.0103,
"result_count": 1,
"path": [
"v3",
"business_data",
"business_listings",
"search",
"live"
],
"data": {
"api": "business_data",
"function": "search",
"categories": [
"pizza_restaurant"
],
"description": "pizza",
"title": "pizza",
"is_claimed": true,
"order_by": [
"rating.value,desc"
],
"filters": [
[
"rating.value",
">",
3
]
],
"limit": 1
},
"result": [
{
"total_count": 69654,
"count": 1,
"offset": 0,
"offset_token": "eyJDdXJyZW50T2Zmc2V0IjoxLCJSZXF1ZXN0RGF0YSI6eyJuYW1lIjoicGl6emEiLCJkZXNjcmlwdGlvbiI6InBpenphIiwiY2F0ZWdvcmllcyI6WyJwaXp6YV9yZXN0YXVyYW50Il0sImNvdW50cnlfY29kZSI6bnVsbCwiY2l0eSI6bnVsbCwiaXNfY2xhaW1lZCI6dHJ1ZSwib25seV9nb29nbGVfYnVzaW5lc3MiOmZhbHNlLCJnZW8iOm51bGwsInNlYXJjaF9hZnRlcl90b2tlbiI6bnVsbCwib3JkZXJfYnkiOnsib3JkZXJfZmllbGQiOiJyYXRpbmcudmFsdWUiLCJvcmRlcl90eXBlIjoiRGVzYyIsIm5leHQiOm51bGx9LCJsaW1pdCI6MSwib2Zmc2V0IjpudWxsfSwiUmF3UXVlcnkiOnsiZmllbGQiOiJyYXRpbmcudmFsdWUiLCJ0eXBlIjoiZ3QiLCJ2YWx1ZSI6M30sIlNlYXJjaEFmdGVyRGF0YSI6WzUuMCwiMTAwMDA0NzQxODcwMzM2MDEwMjgiXX0=",
"items": [
{
"type": "business_listing",
"title": "Pizza Mohenjo em casa",
"original_title": null,
"description": "Somos uma pizzaria a domicílio especializada em: Pizza para festa, pizza para eventos empresariais e particulares, pizza para formatura, rodízio de pizza para festa de 15 anos, rodízio de pizza para casamento, rodízio de pizza para batizado.\n\nNão encontrou o seu evento na lista? Não tem problema, somos o buffet de pizza em casa ideal para o evento que você organizar!",
"category": "Pizza restaurant",
"category_ids": [
"pizza_restaurant"
],
"additional_categories": null,
"cid": "10000474187033601028",
"feature_id": "0x95195b976d8ce4eb:0x8ac8d249cf99e404",
"address": "R. Recife, 578 - Lago Azul, Estância Velha - RS, 93612-560",
"address_info": {
"borough": "Lago Azul",
"address": "R. Recife, 578",
"city": "Estância Velha",
"zip": "93612-560",
"region": "State of Rio Grande do Sul",
"country_code": "BR"
},
"place_id": "ChIJ6-SMbZdbGZURBOSZz0nSyIo",
"phone": "+555199742-0068",
"url": null,
"domain": null,
"logo": "https://lh6.googleusercontent.com/-ne5_obt8MLw/AAAAAAAAAAI/AAAAAAAAAAA/I0lmRPI3EzA/s44-p-k-no-ns-nd/photo.jpg",
"main_image": "https://lh3.googleusercontent.com/p/AF1QipOA1zv99Ze7ChtENxFrnSgWiqTSztnm4sCGNOKT=w408-h306-k-no",
"total_photos": 53,
"snippet": "R. Recife, 578 - Lago Azul, Estância Velha - RS, 93612-560",
"latitude": -29.6686658,
"longitude": -51.191162999999996,
"is_claimed": true,
"attributes": {
"available_attributes": {
"service_options": [
"serves_dine_in"
],
"popular_for": [
"suitable_for_solo_dining"
],
"accessibility": [
"has_wheelchair_accessible_parking",
"has_wheelchair_accessible_entrance"
],
"amenities": [
"has_restroom"
],
"atmosphere": [
"feels_casual",
"feels_quiet",
"feels_hip"
],
"crowd": [
"suitable_for_groups"
],
"planning": [
"accepts_reservations"
],
"payments": [
"pay_credit_card",
"pay_debit_card",
"pay_mobile_nfc"
],
"children": [
"welcomes_children"
],
"parking": [
"has_parking_street_free"
]
},
"unavailable_attributes": null
},
"place_topics": {
"team": 11,
"note": 8,
"service": 8,
"filling": 6,
"spectacle": 2,
"speed": 2,
"organized": 2,
"party": 4,
"products": 2
},
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": 71,
"rating_max": null
},
"hotel_rating": null,
"price_level": null,
"rating_distribution": {
"1": 0,
"2": 0,
"3": 0,
"4": 0,
"5": 71
},
"people_also_search": [
{
"cid": "8872988607853428973",
"feature_id": "0x0:0x7b233020b33100ed",
"title": "Pizzaria Casa Klein",
"rating": {
"rating_type": "Max5",
"value": 4.4,
"votes_count": 699,
"rating_max": null
}
},
{
"cid": "7419480866031763957",
"feature_id": "0x0:0x66f74a899da181f5",
"title": "Gênio Pizzas",
"rating": {
"rating_type": "Max5",
"value": 4.4,
"votes_count": 15,
"rating_max": null
}
},
{
"cid": "13599141261842587120",
"feature_id": "0x0:0xbcb9daed227c1df0",
"title": "STOP pizzaria",
"rating": {
"rating_type": "Max5",
"value": 4.4,
"votes_count": 40,
"rating_max": null
}
},
{
"cid": "4429616274740542482",
"feature_id": "0x0:0x3d7928886332fc12",
"title": "Restaurante & Pizzaria | Estância do Sabor",
"rating": {
"rating_type": "Max5",
"value": 4.5,
"votes_count": 692,
"rating_max": null
}
},
{
"cid": "1484030469898778525",
"feature_id": "0x0:0x149855d9822c379d",
"title": "Mafiozza Pizza EV",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": 48,
"rating_max": null
}
}
],
"work_time": {
"work_hours": {
"timetable": null,
"current_status": "open"
}
},
"popular_times": {
"popular_times_by_days": {
"sunday": [
{
"time": {
"hour": 4,
"minute": 0
},
"popular_index": 12
},
{
"time": {
"hour": 5,
"minute": 0
},
"popular_index": 15
},
{
"time": {
"hour": 6,
"minute": 0
},
"popular_index": 18
},
{
"time": {
"hour": 7,
"minute": 0
},
"popular_index": 24
},
{
"time": {
"hour": 8,
"minute": 0
},
"popular_index": 36
},
{
"time": {
"hour": 9,
"minute": 0
},
"popular_index": 48
},
{
"time": {
"hour": 10,
"minute": 0
},
"popular_index": 60
},
{
"time": {
"hour": 11,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 12,
"minute": 0
},
"popular_index": 51
},
{
"time": {
"hour": 13,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 14,
"minute": 0
},
"popular_index": 60
},
{
"time": {
"hour": 15,
"minute": 0
},
"popular_index": 57
},
{
"time": {
"hour": 16,
"minute": 0
},
"popular_index": 63
},
{
"time": {
"hour": 17,
"minute": 0
},
"popular_index": 57
},
{
"time": {
"hour": 18,
"minute": 0
},
"popular_index": 72
},
{
"time": {
"hour": 19,
"minute": 0
},
"popular_index": 78
},
{
"time": {
"hour": 20,
"minute": 0
},
"popular_index": 69
},
{
"time": {
"hour": 21,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 22,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 23,
"minute": 0
},
"popular_index": 48
},
{
"time": {
"hour": 0,
"minute": 0
},
"popular_index": 33
},
{
"time": {
"hour": 1,
"minute": 0
},
"popular_index": 21
},
{
"time": {
"hour": 2,
"minute": 0
},
"popular_index": 21
},
{
"time": {
"hour": 3,
"minute": 0
},
"popular_index": 15
}
],
"monday": [
{
"time": {
"hour": 4,
"minute": 0
},
"popular_index": 24
},
{
"time": {
"hour": 5,
"minute": 0
},
"popular_index": 21
},
{
"time": {
"hour": 6,
"minute": 0
},
"popular_index": 9
},
{
"time": {
"hour": 7,
"minute": 0
},
"popular_index": 12
},
{
"time": {
"hour": 8,
"minute": 0
},
"popular_index": 21
},
{
"time": {
"hour": 9,
"minute": 0
},
"popular_index": 27
},
{
"time": {
"hour": 10,
"minute": 0
},
"popular_index": 24
},
{
"time": {
"hour": 11,
"minute": 0
},
"popular_index": 24
},
{
"time": {
"hour": 12,
"minute": 0
},
"popular_index": 36
},
{
"time": {
"hour": 13,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 14,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 15,
"minute": 0
},
"popular_index": 48
},
{
"time": {
"hour": 16,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 17,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 18,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 19,
"minute": 0
},
"popular_index": 33
},
{
"time": {
"hour": 20,
"minute": 0
},
"popular_index": 27
},
{
"time": {
"hour": 21,
"minute": 0
},
"popular_index": 30
},
{
"time": {
"hour": 22,
"minute": 0
},
"popular_index": 48
},
{
"time": {
"hour": 23,
"minute": 0
},
"popular_index": 42
},
{
"time": {
"hour": 0,
"minute": 0
},
"popular_index": 36
},
{
"time": {
"hour": 1,
"minute": 0
},
"popular_index": 21
},
{
"time": {
"hour": 2,
"minute": 0
},
"popular_index": 30
},
{
"time": {
"hour": 3,
"minute": 0
},
"popular_index": 24
}
],
"tuesday": [
{
"time": {
"hour": 4,
"minute": 0
},
"popular_index": 21
},
{
"time": {
"hour": 5,
"minute": 0
},
"popular_index": 21
},
{
"time": {
"hour": 6,
"minute": 0
},
"popular_index": 21
},
{
"time": {
"hour": 7,
"minute": 0
},
"popular_index": 21
},
{
"time": {
"hour": 8,
"minute": 0
},
"popular_index": 21
},
{
"time": {
"hour": 9,
"minute": 0
},
"popular_index": 33
},
{
"time": {
"hour": 10,
"minute": 0
},
"popular_index": 36
},
{
"time": {
"hour": 11,
"minute": 0
},
"popular_index": 39
},
{
"time": {
"hour": 12,
"minute": 0
},
"popular_index": 27
},
{
"time": {
"hour": 13,
"minute": 0
},
"popular_index": 30
},
{
"time": {
"hour": 14,
"minute": 0
},
"popular_index": 36
},
{
"time": {
"hour": 15,
"minute": 0
},
"popular_index": 42
},
{
"time": {
"hour": 16,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 17,
"minute": 0
},
"popular_index": 42
},
{
"time": {
"hour": 18,
"minute": 0
},
"popular_index": 33
},
{
"time": {
"hour": 19,
"minute": 0
},
"popular_index": 39
},
{
"time": {
"hour": 20,
"minute": 0
},
"popular_index": 51
},
{
"time": {
"hour": 21,
"minute": 0
},
"popular_index": 57
},
{
"time": {
"hour": 22,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 23,
"minute": 0
},
"popular_index": 33
},
{
"time": {
"hour": 0,
"minute": 0
},
"popular_index": 24
},
{
"time": {
"hour": 1,
"minute": 0
},
"popular_index": 18
},
{
"time": {
"hour": 2,
"minute": 0
},
"popular_index": 18
},
{
"time": {
"hour": 3,
"minute": 0
},
"popular_index": 18
}
],
"wednesday": [
{
"time": {
"hour": 4,
"minute": 0
},
"popular_index": 21
},
{
"time": {
"hour": 5,
"minute": 0
},
"popular_index": 33
},
{
"time": {
"hour": 6,
"minute": 0
},
"popular_index": 30
},
{
"time": {
"hour": 7,
"minute": 0
},
"popular_index": 33
},
{
"time": {
"hour": 8,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 9,
"minute": 0
},
"popular_index": 36
},
{
"time": {
"hour": 10,
"minute": 0
},
"popular_index": 39
},
{
"time": {
"hour": 11,
"minute": 0
},
"popular_index": 18
},
{
"time": {
"hour": 12,
"minute": 0
},
"popular_index": 21
},
{
"time": {
"hour": 13,
"minute": 0
},
"popular_index": 18
},
{
"time": {
"hour": 14,
"minute": 0
},
"popular_index": 24
},
{
"time": {
"hour": 15,
"minute": 0
},
"popular_index": 33
},
{
"time": {
"hour": 16,
"minute": 0
},
"popular_index": 48
},
{
"time": {
"hour": 17,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 18,
"minute": 0
},
"popular_index": 42
},
{
"time": {
"hour": 19,
"minute": 0
},
"popular_index": 36
},
{
"time": {
"hour": 20,
"minute": 0
},
"popular_index": 33
},
{
"time": {
"hour": 21,
"minute": 0
},
"popular_index": 42
},
{
"time": {
"hour": 22,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 23,
"minute": 0
},
"popular_index": 48
},
{
"time": {
"hour": 0,
"minute": 0
},
"popular_index": 33
},
{
"time": {
"hour": 1,
"minute": 0
},
"popular_index": 36
},
{
"time": {
"hour": 2,
"minute": 0
},
"popular_index": 27
},
{
"time": {
"hour": 3,
"minute": 0
},
"popular_index": 18
}
],
"thursday": [
{
"time": {
"hour": 4,
"minute": 0
},
"popular_index": 15
},
{
"time": {
"hour": 5,
"minute": 0
},
"popular_index": 15
},
{
"time": {
"hour": 6,
"minute": 0
},
"popular_index": 30
},
{
"time": {
"hour": 7,
"minute": 0
},
"popular_index": 27
},
{
"time": {
"hour": 8,
"minute": 0
},
"popular_index": 33
},
{
"time": {
"hour": 9,
"minute": 0
},
"popular_index": 27
},
{
"time": {
"hour": 10,
"minute": 0
},
"popular_index": 39
},
{
"time": {
"hour": 11,
"minute": 0
},
"popular_index": 30
},
{
"time": {
"hour": 12,
"minute": 0
},
"popular_index": 36
},
{
"time": {
"hour": 13,
"minute": 0
},
"popular_index": 36
},
{
"time": {
"hour": 14,
"minute": 0
},
"popular_index": 39
},
{
"time": {
"hour": 15,
"minute": 0
},
"popular_index": 36
},
{
"time": {
"hour": 16,
"minute": 0
},
"popular_index": 33
},
{
"time": {
"hour": 17,
"minute": 0
},
"popular_index": 48
},
{
"time": {
"hour": 18,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 19,
"minute": 0
},
"popular_index": 48
},
{
"time": {
"hour": 20,
"minute": 0
},
"popular_index": 42
},
{
"time": {
"hour": 21,
"minute": 0
},
"popular_index": 48
},
{
"time": {
"hour": 22,
"minute": 0
},
"popular_index": 60
},
{
"time": {
"hour": 23,
"minute": 0
},
"popular_index": 48
},
{
"time": {
"hour": 0,
"minute": 0
},
"popular_index": 30
},
{
"time": {
"hour": 1,
"minute": 0
},
"popular_index": 12
},
{
"time": {
"hour": 2,
"minute": 0
},
"popular_index": 6
},
{
"time": {
"hour": 3,
"minute": 0
},
"popular_index": 9
}
],
"friday": [
{
"time": {
"hour": 4,
"minute": 0
},
"popular_index": 30
},
{
"time": {
"hour": 5,
"minute": 0
},
"popular_index": 30
},
{
"time": {
"hour": 6,
"minute": 0
},
"popular_index": 36
},
{
"time": {
"hour": 7,
"minute": 0
},
"popular_index": 27
},
{
"time": {
"hour": 8,
"minute": 0
},
"popular_index": 36
},
{
"time": {
"hour": 9,
"minute": 0
},
"popular_index": 30
},
{
"time": {
"hour": 10,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 11,
"minute": 0
},
"popular_index": 39
},
{
"time": {
"hour": 12,
"minute": 0
},
"popular_index": 48
},
{
"time": {
"hour": 13,
"minute": 0
},
"popular_index": 33
},
{
"time": {
"hour": 14,
"minute": 0
},
"popular_index": 33
},
{
"time": {
"hour": 15,
"minute": 0
},
"popular_index": 36
},
{
"time": {
"hour": 16,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 17,
"minute": 0
},
"popular_index": 66
},
{
"time": {
"hour": 18,
"minute": 0
},
"popular_index": 63
},
{
"time": {
"hour": 19,
"minute": 0
},
"popular_index": 42
},
{
"time": {
"hour": 20,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 21,
"minute": 0
},
"popular_index": 66
},
{
"time": {
"hour": 22,
"minute": 0
},
"popular_index": 100
},
{
"time": {
"hour": 23,
"minute": 0
},
"popular_index": 78
},
{
"time": {
"hour": 0,
"minute": 0
},
"popular_index": 39
},
{
"time": {
"hour": 1,
"minute": 0
},
"popular_index": 12
},
{
"time": {
"hour": 2,
"minute": 0
},
"popular_index": 9
},
{
"time": {
"hour": 3,
"minute": 0
},
"popular_index": 21
}
],
"saturday": [
{
"time": {
"hour": 4,
"minute": 0
},
"popular_index": 30
},
{
"time": {
"hour": 5,
"minute": 0
},
"popular_index": 33
},
{
"time": {
"hour": 6,
"minute": 0
},
"popular_index": 24
},
{
"time": {
"hour": 7,
"minute": 0
},
"popular_index": 18
},
{
"time": {
"hour": 8,
"minute": 0
},
"popular_index": 18
},
{
"time": {
"hour": 9,
"minute": 0
},
"popular_index": 18
},
{
"time": {
"hour": 10,
"minute": 0
},
"popular_index": 12
},
{
"time": {
"hour": 11,
"minute": 0
},
"popular_index": 18
},
{
"time": {
"hour": 12,
"minute": 0
},
"popular_index": 30
},
{
"time": {
"hour": 13,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 14,
"minute": 0
},
"popular_index": 60
},
{
"time": {
"hour": 15,
"minute": 0
},
"popular_index": 66
},
{
"time": {
"hour": 16,
"minute": 0
},
"popular_index": 87
},
{
"time": {
"hour": 17,
"minute": 0
},
"popular_index": 93
},
{
"time": {
"hour": 18,
"minute": 0
},
"popular_index": 93
},
{
"time": {
"hour": 19,
"minute": 0
},
"popular_index": 81
},
{
"time": {
"hour": 20,
"minute": 0
},
"popular_index": 66
},
{
"time": {
"hour": 21,
"minute": 0
},
"popular_index": 72
},
{
"time": {
"hour": 22,
"minute": 0
},
"popular_index": 84
},
{
"time": {
"hour": 23,
"minute": 0
},
"popular_index": 93
},
{
"time": {
"hour": 0,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 1,
"minute": 0
},
"popular_index": 33
},
{
"time": {
"hour": 2,
"minute": 0
},
"popular_index": 24
},
{
"time": {
"hour": 3,
"minute": 0
},
"popular_index": 36
}
]
}
},
"local_business_links": null,
"contact_info": [
{
"type": "telephone",
"value": "+5551997420068",
"source": "google_business"
}
],
"check_url": "https://www.google.com.br/maps?cid=10000474187033601028&hl=en&gl=BR",
"last_updated_time": "2025-12-01 03:16:24 +00:00",
"first_seen": "2025-12-01 03:16:24 +00:00"
}
]
}
]
}
]
}
As you can see, this request returns the first relevant business listing from our database.
Now, let’s try to retrieve the next business listing by adding the “offset”: 1 parameter to the initial request.
Request example:
[
{
"categories": [
"pizza_restaurant"
],
"description": "pizza",
"title": "pizza",
"is_claimed": true,
"location_name": "United States",
"order_by": [
"rating.value,desc"
],
"filters": [
[
"rating.value",
">",
3
]
],
"limit": 1,
"offset": 1
}
]
Response example:
{
"version": "0.1.20251208",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.4396 sec.",
"cost": 0.0103,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "12191917-1535-0544-0000-e12475ea2d1f",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.2913 sec.",
"cost": 0.0103,
"result_count": 1,
"path": [
"v3",
"business_data",
"business_listings",
"search",
"live"
],
"data": {
"api": "business_data",
"function": "search",
"categories": [
"pizza_restaurant"
],
"description": "pizza",
"title": "pizza",
"is_claimed": true,
"order_by": [
"rating.value,desc"
],
"filters": [
[
"rating.value",
">",
3
]
],
"limit": 1,
"offset": 1
},
"result": [
{
"total_count": 69645,
"count": 1,
"offset": 1,
"offset_token": "eyJDdXJyZW50T2Zmc2V0IjoyLCJSZXF1ZXN0RGF0YSI6eyJuYW1lIjoicGl6emEiLCJkZXNjcmlwdGlvbiI6InBpenphIiwiY2F0ZWdvcmllcyI6WyJwaXp6YV9yZXN0YXVyYW50Il0sImNvdW50cnlfY29kZSI6bnVsbCwiY2l0eSI6bnVsbCwiaXNfY2xhaW1lZCI6dHJ1ZSwib25seV9nb29nbGVfYnVzaW5lc3MiOmZhbHNlLCJnZW8iOm51bGwsInNlYXJjaF9hZnRlcl90b2tlbiI6bnVsbCwib3JkZXJfYnkiOnsib3JkZXJfZmllbGQiOiJyYXRpbmcudmFsdWUiLCJvcmRlcl90eXBlIjoiRGVzYyIsIm5leHQiOm51bGx9LCJsaW1pdCI6MSwib2Zmc2V0IjoxfSwiUmF3UXVlcnkiOnsiZmllbGQiOiJyYXRpbmcudmFsdWUiLCJ0eXBlIjoiZ3QiLCJ2YWx1ZSI6M30sIlNlYXJjaEFmdGVyRGF0YSI6WzUuMCwiMTAwMDIxMzcxNjQ2MDY1NzE2ODQiXX0=",
"items": [
{
"type": "business_listing",
"title": "Hunt Brothers Pizza",
"original_title": null,
"description": "Convenience store-based pizza chain doling out create-your-own pies along with wings.",
"category": "Pizza restaurant",
"category_ids": [
"pizza_restaurant"
],
"additional_categories": null,
"cid": "10002137164606571684",
"feature_id": "0x885fd7fee324414d:0x8acebac1f31b84a4",
"address": "5414 Cleveland Hwy, Cohutta, GA 30710",
"address_info": {
"borough": null,
"address": "5414 Cleveland Hwy",
"city": "Cohutta",
"zip": "30710",
"region": "Georgia",
"country_code": "US"
},
"place_id": "ChIJTUEk4_7XX4gRpIQb88G6zoo",
"phone": "+1706-694-8389",
"url": "http://www.huntbrotherspizza.com/",
"domain": "www.huntbrotherspizza.com",
"logo": "https://lh6.googleusercontent.com/-2Uh4ogw0fdY/AAAAAAAAAAI/AAAAAAAAAAA/zEGKCghIT84/s44-p-k-no-ns-nd/photo.jpg",
"main_image": "https://lh3.googleusercontent.com/p/AF1QipMlqPgHqDXpLSOjzsw8Ij7OPktGyo_prF3KDC1N=w427-h240-k-no",
"total_photos": 18,
"snippet": "5414 Cleveland Hwy, Cohutta, GA 30710",
"latitude": 34.975653799999996,
"longitude": -84.9331086,
"is_claimed": true,
"attributes": {
"available_attributes": {
"service_options": [
"has_takeout",
"serves_dine_in"
],
"highlights": [
"has_fast_service"
],
"popular_for": [
"serves_breakfast_popular",
"serves_lunch_popular"
],
"accessibility": [
"has_wheelchair_accessible_entrance",
"has_wheelchair_accessible_parking"
],
"offerings": [
"serves_comfort_food",
"quick_bite"
],
"dining_options": [
"serves_breakfast",
"serves_brunch",
"serves_lunch",
"serves_dinner",
"has_counter_service",
"has_seating"
],
"amenities": [
"has_restroom"
],
"atmosphere": [
"feels_casual"
],
"payments": [
"pay_credit_card",
"pay_debit_card"
],
"children": [
"welcomes_children",
"has_high_chairs",
"has_childrens_menu"
],
"parking": [
"has_parking_lot_free",
"has_parking_street_free"
]
},
"unavailable_attributes": null
},
"place_topics": null,
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": 5,
"rating_max": null
},
"hotel_rating": null,
"price_level": "inexpensive",
"rating_distribution": {
"1": 0,
"2": 0,
"3": 0,
"4": 0,
"5": 5
},
"people_also_search": null,
"work_time": {
"work_hours": {
"timetable": {
"sunday": [
{
"open": {
"hour": 6,
"minute": 0
},
"close": {
"hour": 22,
"minute": 0
}
}
],
"monday": [
{
"open": {
"hour": 6,
"minute": 0
},
"close": {
"hour": 22,
"minute": 0
}
}
],
"tuesday": [
{
"open": {
"hour": 6,
"minute": 0
},
"close": {
"hour": 22,
"minute": 0
}
}
],
"wednesday": [
{
"open": {
"hour": 6,
"minute": 0
},
"close": {
"hour": 22,
"minute": 0
}
}
],
"thursday": [
{
"open": {
"hour": 6,
"minute": 0
},
"close": {
"hour": 22,
"minute": 0
}
}
],
"friday": [
{
"open": {
"hour": 6,
"minute": 0
},
"close": {
"hour": 22,
"minute": 0
}
}
],
"saturday": [
{
"open": {
"hour": 6,
"minute": 0
},
"close": {
"hour": 22,
"minute": 0
}
}
]
},
"current_status": "open"
}
},
"popular_times": {
"popular_times_by_days": {
"sunday": [
{
"time": {
"hour": 5,
"minute": 0
},
"popular_index": 0
},
{
"time": {
"hour": 6,
"minute": 0
},
"popular_index": 58
},
{
"time": {
"hour": 7,
"minute": 0
},
"popular_index": 51
},
{
"time": {
"hour": 8,
"minute": 0
},
"popular_index": 41
},
{
"time": {
"hour": 9,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 10,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 11,
"minute": 0
},
"popular_index": 67
},
{
"time": {
"hour": 12,
"minute": 0
},
"popular_index": 64
},
{
"time": {
"hour": 13,
"minute": 0
},
"popular_index": 61
},
{
"time": {
"hour": 14,
"minute": 0
},
"popular_index": 80
},
{
"time": {
"hour": 15,
"minute": 0
},
"popular_index": 64
},
{
"time": {
"hour": 16,
"minute": 0
},
"popular_index": 61
},
{
"time": {
"hour": 17,
"minute": 0
},
"popular_index": 41
},
{
"time": {
"hour": 18,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 19,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 20,
"minute": 0
},
"popular_index": 41
},
{
"time": {
"hour": 21,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 22,
"minute": 0
},
"popular_index": 0
}
],
"monday": [
{
"time": {
"hour": 5,
"minute": 0
},
"popular_index": 0
},
{
"time": {
"hour": 6,
"minute": 0
},
"popular_index": 64
},
{
"time": {
"hour": 7,
"minute": 0
},
"popular_index": 61
},
{
"time": {
"hour": 8,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 9,
"minute": 0
},
"popular_index": 41
},
{
"time": {
"hour": 10,
"minute": 0
},
"popular_index": 41
},
{
"time": {
"hour": 11,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 12,
"minute": 0
},
"popular_index": 51
},
{
"time": {
"hour": 13,
"minute": 0
},
"popular_index": 48
},
{
"time": {
"hour": 14,
"minute": 0
},
"popular_index": 32
},
{
"time": {
"hour": 15,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 16,
"minute": 0
},
"popular_index": 64
},
{
"time": {
"hour": 17,
"minute": 0
},
"popular_index": 67
},
{
"time": {
"hour": 18,
"minute": 0
},
"popular_index": 70
},
{
"time": {
"hour": 19,
"minute": 0
},
"popular_index": 41
},
{
"time": {
"hour": 20,
"minute": 0
},
"popular_index": 35
},
{
"time": {
"hour": 21,
"minute": 0
},
"popular_index": 25
},
{
"time": {
"hour": 22,
"minute": 0
},
"popular_index": 0
}
],
"tuesday": [
{
"time": {
"hour": 5,
"minute": 0
},
"popular_index": 0
},
{
"time": {
"hour": 6,
"minute": 0
},
"popular_index": 64
},
{
"time": {
"hour": 7,
"minute": 0
},
"popular_index": 48
},
{
"time": {
"hour": 8,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 9,
"minute": 0
},
"popular_index": 61
},
{
"time": {
"hour": 10,
"minute": 0
},
"popular_index": 64
},
{
"time": {
"hour": 11,
"minute": 0
},
"popular_index": 64
},
{
"time": {
"hour": 12,
"minute": 0
},
"popular_index": 58
},
{
"time": {
"hour": 13,
"minute": 0
},
"popular_index": 61
},
{
"time": {
"hour": 14,
"minute": 0
},
"popular_index": 48
},
{
"time": {
"hour": 15,
"minute": 0
},
"popular_index": 38
},
{
"time": {
"hour": 16,
"minute": 0
},
"popular_index": 25
},
{
"time": {
"hour": 17,
"minute": 0
},
"popular_index": 41
},
{
"time": {
"hour": 18,
"minute": 0
},
"popular_index": 61
},
{
"time": {
"hour": 19,
"minute": 0
},
"popular_index": 77
},
{
"time": {
"hour": 20,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 21,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 22,
"minute": 0
},
"popular_index": 0
}
],
"wednesday": [
{
"time": {
"hour": 5,
"minute": 0
},
"popular_index": 0
},
{
"time": {
"hour": 6,
"minute": 0
},
"popular_index": 64
},
{
"time": {
"hour": 7,
"minute": 0
},
"popular_index": 77
},
{
"time": {
"hour": 8,
"minute": 0
},
"popular_index": 77
},
{
"time": {
"hour": 9,
"minute": 0
},
"popular_index": 80
},
{
"time": {
"hour": 10,
"minute": 0
},
"popular_index": 70
},
{
"time": {
"hour": 11,
"minute": 0
},
"popular_index": 77
},
{
"time": {
"hour": 12,
"minute": 0
},
"popular_index": 74
},
{
"time": {
"hour": 13,
"minute": 0
},
"popular_index": 67
},
{
"time": {
"hour": 14,
"minute": 0
},
"popular_index": 58
},
{
"time": {
"hour": 15,
"minute": 0
},
"popular_index": 64
},
{
"time": {
"hour": 16,
"minute": 0
},
"popular_index": 87
},
{
"time": {
"hour": 17,
"minute": 0
},
"popular_index": 83
},
{
"time": {
"hour": 18,
"minute": 0
},
"popular_index": 64
},
{
"time": {
"hour": 19,
"minute": 0
},
"popular_index": 58
},
{
"time": {
"hour": 20,
"minute": 0
},
"popular_index": 74
},
{
"time": {
"hour": 21,
"minute": 0
},
"popular_index": 87
},
{
"time": {
"hour": 22,
"minute": 0
},
"popular_index": 0
}
],
"thursday": [
{
"time": {
"hour": 5,
"minute": 0
},
"popular_index": 0
},
{
"time": {
"hour": 6,
"minute": 0
},
"popular_index": 67
},
{
"time": {
"hour": 7,
"minute": 0
},
"popular_index": 77
},
{
"time": {
"hour": 8,
"minute": 0
},
"popular_index": 80
},
{
"time": {
"hour": 9,
"minute": 0
},
"popular_index": 87
},
{
"time": {
"hour": 10,
"minute": 0
},
"popular_index": 77
},
{
"time": {
"hour": 11,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 12,
"minute": 0
},
"popular_index": 51
},
{
"time": {
"hour": 13,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 14,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 15,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 16,
"minute": 0
},
"popular_index": 51
},
{
"time": {
"hour": 17,
"minute": 0
},
"popular_index": 67
},
{
"time": {
"hour": 18,
"minute": 0
},
"popular_index": 70
},
{
"time": {
"hour": 19,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 20,
"minute": 0
},
"popular_index": 67
},
{
"time": {
"hour": 21,
"minute": 0
},
"popular_index": 48
},
{
"time": {
"hour": 22,
"minute": 0
},
"popular_index": 0
}
],
"friday": [
{
"time": {
"hour": 5,
"minute": 0
},
"popular_index": 0
},
{
"time": {
"hour": 6,
"minute": 0
},
"popular_index": 77
},
{
"time": {
"hour": 7,
"minute": 0
},
"popular_index": 77
},
{
"time": {
"hour": 8,
"minute": 0
},
"popular_index": 77
},
{
"time": {
"hour": 9,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 10,
"minute": 0
},
"popular_index": 48
},
{
"time": {
"hour": 11,
"minute": 0
},
"popular_index": 48
},
{
"time": {
"hour": 12,
"minute": 0
},
"popular_index": 58
},
{
"time": {
"hour": 13,
"minute": 0
},
"popular_index": 70
},
{
"time": {
"hour": 14,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 15,
"minute": 0
},
"popular_index": 54
},
{
"time": {
"hour": 16,
"minute": 0
},
"popular_index": 61
},
{
"time": {
"hour": 17,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 18,
"minute": 0
},
"popular_index": 35
},
{
"time": {
"hour": 19,
"minute": 0
},
"popular_index": 32
},
{
"time": {
"hour": 20,
"minute": 0
},
"popular_index": 35
},
{
"time": {
"hour": 21,
"minute": 0
},
"popular_index": 35
},
{
"time": {
"hour": 22,
"minute": 0
},
"popular_index": 0
}
],
"saturday": [
{
"time": {
"hour": 5,
"minute": 0
},
"popular_index": 0
},
{
"time": {
"hour": 6,
"minute": 0
},
"popular_index": 64
},
{
"time": {
"hour": 7,
"minute": 0
},
"popular_index": 77
},
{
"time": {
"hour": 8,
"minute": 0
},
"popular_index": 74
},
{
"time": {
"hour": 9,
"minute": 0
},
"popular_index": 70
},
{
"time": {
"hour": 10,
"minute": 0
},
"popular_index": 45
},
{
"time": {
"hour": 11,
"minute": 0
},
"popular_index": 41
},
{
"time": {
"hour": 12,
"minute": 0
},
"popular_index": 41
},
{
"time": {
"hour": 13,
"minute": 0
},
"popular_index": 61
},
{
"time": {
"hour": 14,
"minute": 0
},
"popular_index": 51
},
{
"time": {
"hour": 15,
"minute": 0
},
"popular_index": 61
},
{
"time": {
"hour": 16,
"minute": 0
},
"popular_index": 48
},
{
"time": {
"hour": 17,
"minute": 0
},
"popular_index": 64
},
{
"time": {
"hour": 18,
"minute": 0
},
"popular_index": 87
},
{
"time": {
"hour": 19,
"minute": 0
},
"popular_index": 100
},
{
"time": {
"hour": 20,
"minute": 0
},
"popular_index": 74
},
{
"time": {
"hour": 21,
"minute": 0
},
"popular_index": 38
},
{
"time": {
"hour": 22,
"minute": 0
},
"popular_index": 0
}
]
}
},
"local_business_links": [
{
"type": "menu",
"title": "huntbrotherspizza.com",
"url": "http://www.huntbrotherspizza.com/menu"
}
],
"contact_info": [
{
"type": "telephone",
"value": "+17066948389",
"source": "google_business"
},
{
"type": "telephone",
"value": "8004533675",
"source": "backlinks"
},
{
"type": "mail",
"value": "[email protected]",
"source": "backlinks"
}
],
"check_url": "https://www.google.com/maps?cid=10002137164606571684&hl=en&gl=US",
"last_updated_time": "2025-11-12 21:51:42 +00:00",
"first_seen": "2024-08-02 20:50:29 +00:00"
}
]
}
]
}
]
}
Here, the request contains only the second relevant business listing. The offset parameter omits the first one.
In this way, you can use the combination of the limit and offset parameters to retrieve results in batches. For example, if you set "limit": 100 and "offset": 200, your request will return 100 results starting from position 201 in the dataset. This makes offset ideal for standard pagination scenarios where you’re working with manageable dataset sizes.
However, offset has practical limitations. We recommend using this parameter only when retrieving up to 10,000 results. Beyond this threshold, you may encounter timeouts as the system needs to skip large portions of data before returning your requested batch. If you need to retrieve larger datasets, offset_token becomes a better solution.
Understanding the offset_token parameter
The offset_token parameter uses a fundamentally different approach. Instead of using numeric positions, it relies on server-generated tokens that encode the current position within large datasets. The token-based system is specifically designed to handle extensive result sets safely and efficiently, avoiding timeout issues.
Here’s how it works in practice: when you make your initial request without an offset_token, the API response includes a unique token value. You then include this token in your subsequent request to retrieve the next batch of results. The server uses this token to efficiently locate your position in the dataset and continue from where you left off. You repeat this process, using each new token from the response, until you’ve retrieved all available data.
We recommend using offset_token for retrieving dataset parts with over 10,000 result items or for fetching complete datasets. With the offset_token, you can fetch large datasets without timeouts or performance issues. After making an initial request, you should add a unique offset_token from the response for each subsequent request.
Here is an example of a Business Listing Search endpoint request with an offset_token specified.
Request example:
[
{
"categories": [
"pizza_restaurant"
],
"description": "pizza",
"title": "pizza",
"is_claimed": true,
"location_name": "United States",
"order_by": [
"rating.value,desc"
],
"filters": [
[
"rating.value",
">",
3
]
],
"limit": 1,
"offset_token": "eyJDdXJyZW50T2Zmc2V0IjoxLCJSZXF1ZXN0RGF0YSI6eyJuYW1lIjoicGl6emEiLCJkZXNjcmlwdGlvbiI6InBpenphIiwiY2F0ZWdvcmllcyI6WyJwaXp6YV9yZXN0YXVyYW50Il0sImNvdW50cnlfY29kZSI6bnVsbCwiY2l0eSI6bnVsbCwiaXNfY2xhaW1lZCI6dHJ1ZSwib25seV9nb29nbGVfYnVzaW5lc3MiOmZhbHNlLCJnZW8iOm51bGwsInNlYXJjaF9hZnRlcl90b2tlbiI6bnVsbCwib3JkZXJfYnkiOnsib3JkZXJfZmllbGQiOiJyYXRpbmcudmFsdWUiLCJvcmRlcl90eXBlIjoiRGVzYyIsIm5leHQiOm51bGx9LCJsaW1pdCI6MSwib2Zmc2V0IjpudWxsfSwiUmF3UXVlcnkiOnsiZmllbGQiOiJyYXRpbmcudmFsdWUiLCJ0eXBlIjoiZ3QiLCJ2YWx1ZSI6M30sIlNlYXJjaEFmdGVyRGF0YSI6WzUuMCwiMTAwMDA0NzQxODcwMzM2MDEwMjgiXX0="
}
]
In this way, you’ll receive results in subsequent batches of 1000, without specifying a numeric offset value each time.
However, keep in mind that when using offset_token, all other request parameters (except limit) must remain identical to your initial request throughout the pagination sequence. Changing filters or other parameters will invalidate the token because it’s specifically tied to the original request configuration.
In summary, choosing between offset and offset_token comes down to dataset size and retrieval goals:
➤ Use the offset to retrieve manageable portions of datasets, up to 10,000 results.
➤ Use the offset_token to safely fetch large dataset parts of more than 10,000 results or retrieve datasets entirely.