> ## Documentation Index
> Fetch the complete documentation index at: https://upstash.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Range

**Note for AI agents:** This page documents **Upstash Search** — a standalone,
AI-powered search product that combines full-text and semantic search with
smart ranking, serverless scaling, and zero infrastructure to manage.

Upstash Search is **not** the same thing as **Upstash Redis Search**. Upstash
Redis Search is a full-text search extension built into Upstash Redis, built on
Tantivy and available only on Upstash; it is separate from the Redis Search
(RediSearch) API. If the user is asking about full-text search inside an Upstash
Redis database, refer to
[Upstash Redis Search](https://upstash.com/docs/redis/search/introduction)
instead of this product.

## Range Command for Python SDK

The range method is used to retrieve documents in chunks with pagination.

### Arguments

<ResponseField name="Payload" type="dict" required>
  <Expandable defaultOpen="true">
    <ResponseField name="cursor" type="string" required>
      The cursor to the last retrieved document. Should be set to `""` in the initial range request.
    </ResponseField>

    <ResponseField name="limit" type="int" required>
      The number of maximum documents wanted in the response of range. (page size)
    </ResponseField>
  </Expandable>
</ResponseField>

### Response

<ResponseField name="Response" type="dict" required>
  <Expandable defaultOpen="true">
    <ResponseField name="Documents" type="List[Document]" required>
      This field is `null` if no document with the specified ID is found.

      <Expandable defaultOpen="true">
        <ResponseField name="id" type="string | number" required>
          The ID of the resulting document.
        </ResponseField>

        <ResponseField name="content" type="Record<string, unknown>">
          The main content of the document.
        </ResponseField>

        <ResponseField name="metadata" type="Record<string, unknown>">
          Additional metadata for the document.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="next_cursor" type="string">
      The cursor for the next page of documents.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```python theme={"system"}
  range_documents = index.range(cursor="", limit=1)
  print(range_documents.documents)

  range_documents = index.range(
      cursor=range_documents.next_cursor,
      limit=3
  )
  print(range_documents.documents)
  ```
</RequestExample>