offset

Type: integer

Engine default: null (no offset)

Parameter syntax

'offset' => record_number

offset: record_number

offset: record_number

'offset': record_number

offset = record_number

offset: Int = record_number

.Offset(record_number)

.setOffset(record_number)

opt.Offset(record_number)

offset = Some(record_number)

Can be used in these methods:
search, browseObjects, generateSecuredApiKey, addApiKey, updateApiKey search, browse_objects, generate_secured_api_key, add_api_key, update_api_key search, browseObjects, generateSecuredApiKey, addApiKey, updateApiKey search, browse_objects, generate_secured_api_key, add_api_key, update_api_key search, browse, generateSecuredApiKey, addAPIKey, updateAPIKey search, browseObjects, generateSecuredApiKey, addApiKey, updateApiKey Search, Browse, GenerateSecuredApiKey, AddApiKey, UpdateApiKey Search, browse, generateSecuredApiKey, addApiKey, updateApiKey Search, BrowseObjects, GenerateSecuredAPIKey, AddAPIKey, UpdateAPIKey search, browse index, generateSecuredApiKey, add key, update key

See code examples

About this parameter# A

Determine the position of a particular record in the dataset.

In most cases, page and hitsPerPage is the recommended method for pagination. This setting is part of an alternative paging approach.

Usage notes#

Offset is the position in the dataset of a particular record. By specifying offset, you retrieve a subset of records tarting with the offset value.

Offset is zero-based: the 10th record is at offset 9.

Use it in combination with length, to retrieve a subset of records. For example, if you have 100 records in your results, and want to retrieve records 50 to 80, use offset=49 and length = 30.

If offset is omitted, length is ignored.
If offset is specified but length omitted, the number of records returned is equal to hitsPerPage. Using offset requires that you specify length as well; otherwise, it defaults to page-based pagination.

Impact on the response:#

Page-based pagination (page / hitsPerPage):

Copy
{
  ...
  "page": 1,
  "nbPages": 20,
  "hitsPerPage": 10,
  ...
}

With offset / length:

Copy
 {
   ...
   "offset": 5,
   "length": 10,
   ...
 }

Examples# A

Get results starting at the nth hit#

Copy

1
2
3
$results = $index->search('query', [
  'offset' => 4
]);

1
2
3
4
5
6
7
8
let query = Query("query")
  .set(\.offset, to: 4)

index.search(query: query) { result in
  if case .success(let response) = result {
    print("Response: \(response)")
  }
}

Did you find this page helpful?

offset

About this parameter# Found an issue? Edit this parameter A Edit this parameter

Usage notes#

Impact on the response:#

Examples# Found an issue? Edit this parameter A Edit this parameter

Get results starting at the nth hit#

On this page

About this parameter# A

Examples# A