Consultar datos

El endpoint /query permite comparar valores de columnas mediante un pequeño conjunto de operadores. Úsalo para comparar números o fechas; para buscar texto con comodines, consulta Filtros.

Operadores

Operador	Significado	Ejemplo
__eq()	Igual a	?Id=__eq(1)
__ne()	Distinto de	?Id=__ne(5)
__lt()	Menor que	?Amount=__lt(5.75)
__lte()	Menor o igual que	?Amount=__lte(5.75)
__gt()	Mayor que	?Created Date=__gt(8/01/2021)
__gte()	Mayor o igual que	?Created Date=__gte(8/01/2021)

El valor del operador va entre paréntesis. Los operadores se aplican a columnas numéricas y de fechas.

Consultas de una columna

cURL

# Amount greater than 5.75
curl 'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Amount=__gt(5.75)'

# Hire Date earlier than 7/01/2021
curl 'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Hire Date=__lt(7/01/2021)'

JavaScript

fetch(
  'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Amount=__gt(5.75)'
);

fetch(
  'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Hire Date=__lt(7/01/2021)'
);

Python

import requests

requests.get(
    'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query',
    params={'Amount': '__gt(5.75)'},
)

requests.get(
    'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query',
    params={'Hire Date': '__lt(7/01/2021)'},
)

Varias columnas

Combina varios parámetros en la misma URL /query. Deben cumplirse todas las condiciones. Los comodines de Filtros funcionan junto con los operadores.

cURL

# Amount >= 1000 AND Age <= 56
curl 'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Amount=__gte(1000)&Age=__lte(56)'

# Name contains "Jane", Age >= 21, Hire Date before 7/01/2020
curl 'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Name=*Jane*&Age=__gte(21)&Hire Date=__lt(7/01/2020)'

# Amount < 500 AND Customer Email starts with "L"
curl 'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Amount=__lt(500)&Customer%20Email=L*'

JavaScript

fetch(
  'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Amount=__gte(1000)&Age=__lte(56)'
);

fetch(
  'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Name=*Jane*&Age=__gte(21)&Hire Date=__lt(7/01/2020)'
);

Python

import requests

requests.get(
    'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query',
    params={'Amount': '__gte(1000)', 'Age': '__lte(56)'},
)

requests.get(
    'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query',
    params={
        'Name': '*Jane*',
        'Age': '__gte(21)',
        'Hire Date': '__lt(7/01/2020)',
    },
)

Valores vacíos

Para buscar filas con un valor vacío en una columna, deja el valor en blanco:

# Rows where Name is empty
curl 'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Name='

Para columnas numéricas o de fechas, usa None:

# Rows where Created at is empty (date column)
curl 'https://api.sheetbest.com/sheets/YOUR_SHEET_ID/query?Created%20at=None'

Consejos

• Codifica los nombres de columna con espacios para usarlos en URLs (Customer%20Email) cuando sea necesario; los clientes HTTP suelen hacerlo por ti.
• Las fechas siguen el formato de tu hoja (por ejemplo, 7/01/2021).
• Para buscar texto contenido sin operadores de comparación, usa Filtros y su sintaxis de comodines.

Siguientes pasos

• Paginación para limitar los resultados de una consulta.
• Pestañas para consultar una pestaña específica.