Leer datos (GET)

Las solicitudes GET devuelven las filas de tu hoja como JSON. La primera fila de la hoja proporciona los nombres de columna que usa la respuesta.

Leer todas las filas

cURL

curl 'https://api.sheetbest.com/sheets/<api-id>'

JavaScript

fetch('https://api.sheetbest.com/sheets/<api-id>')
  .then((r) => r.json())
  .then(console.log);

Python

import requests

requests.get('https://api.sheetbest.com/sheets/<api-id>').json()

Respuesta:

[
  { "Id": "1", "Name": "John Doe", "Age": "23" },
  { "Id": "2", "Name": "Jane Doe", "Age": "34" }
]

Leer una sola fila

Añade el índice de fila a la URL. Los índices empiezan en cero, por lo que /2 devuelve la tercera fila de datos.

cURL

curl 'https://api.sheetbest.com/sheets/<api-id>/2'

JavaScript

fetch('https://api.sheetbest.com/sheets/<api-id>/2');

Python

requests.get('https://api.sheetbest.com/sheets/<api-id>/2')

Leer un rango de filas

Usa la notación abreviada <start>:<end> para leer un rango continuo. Equivale a pasar _limit y _offset:

# Rows 2 and 3
curl 'https://api.sheetbest.com/sheets/<api-id>/2:4'

# Same request, expanded
curl 'https://api.sheetbest.com/sheets/<api-id>?_limit=2&_offset=2'

Consulta Paginación para más detalles.

Valores procesados y valores originales

Por defecto, todos los valores se devuelven como cadenas procesadas. Añade ?_raw=1 para recibir los tipos nativos (números, booleanos, fechas) tal como los almacena Google Sheets:

curl 'https://api.sheetbest.com/sheets/<api-id>?_raw=1'

Para otras estructuras de respuesta (records, dict, list, series, split, index), consulta Formatos de datos.

Leer una pestaña específica

Por defecto se usa la primera pestaña. Para leer otra, añade /tabs/<TabName>:

curl 'https://api.sheetbest.com/sheets/<api-id>/tabs/Admin'

Consulta Trabajar con pestañas.

Filtros y consultas

Puedes filtrar filas por el valor de una columna (/<Column>/<Value>, con comodines * opcionales) o usar operadores de comparación con /query. Se documentan por separado:

• Filtrar datos: coincidencias exactas y filtros con comodines.
• Consultas avanzadas: operadores __eq, __ne, __lt, __lte, __gt, __gte.

Encabezados de respuesta

Cada respuesta incluye encabezados que describen la hoja y el uso de tu cuota, entre ellos X-Sheet-Rows, X-Sheet-Columns y la serie X-RateLimit-*. Consulta Encabezados de respuesta.