API de datos en tiempo real
para todas las necesidades empresariales

Las API de alimentación de datos son API RESTful que le permiten filtrar conjuntos de datos y crear instantáneas con solo los datos que necesita. El punto final de la API Filter Dataset inicia un trabajo asíncrono que filtra el conjunto de datos seleccionado y crea una instantánea basada en sus criterios, que luego puede descargar o acceder mediante programación.

Cuando llamas a la API Filter Dataset, se crea una tarea asíncrona que aplica tus filtros y genera una instantánea. El proceso tiene un tiempo de espera máximo de 5 minutos. Una vez completado, recibirás un snapshot_id que podrás utilizar para acceder a tus datos filtrados. Solo se te cobrará por el tamaño de la instantánea en función del precio del registro.

La API admite una amplia gama de operadores: = (igual), != (no igual), < y > (menor/mayor que), <= y >= (menor/mayor o igual), «in» y «not_in» (coincidencia de valores), «includes» y «not_includes» (contiene subcadena/matriz), «array_includes» y «not_array_includes» (coincidencia exacta de matriz) e «is_null» / «is_not_null» para comprobar valores vacíos. Se aplican diferentes operadores a diferentes tipos de campos (texto, número, fecha, matriz).

Sí. Puede combinar varios filtros utilizando los operadores lógicos «and» u «or» en grupos de filtros. La API admite una profundidad de anidamiento máxima de 3 niveles. Para matrices de objetos, puede utilizar el parámetro «combine_nested_fields» para garantizar que todos los filtros coincidan dentro de un único objeto en lugar de en toda la matriz.

La API admite dos modos: el modo JSON para el filtrado estándar y el modo Multipart/Form-Data para cargar archivos CSV o JSON que contengan valores de filtro. En el modo Multipart, envíe dataset_id y records_limit como parámetros de consulta y, a continuación, incluya la definición del filtro y los archivos en el cuerpo del formulario. Esto es ideal para filtrar por cientos o miles de valores.

Solo necesita dos cosas: su ID de conjunto de datos (que se encuentra en la página de detalles del conjunto de datos) y su clave API de Bright Data. Incluya su clave API como token Bearer en el encabezado de autorización. No se requieren zonas Proxy, contraseñas ni credenciales adicionales para filtrar conjuntos de datos.

Las instantáneas filtradas están disponibles en formatos JSON, NDJSON, CSV y Parquet. Puede especificar su formato preferido al descargar la instantánea o configurar su método de entrega.

Una vez que la API devuelve un snapshot_id, puede recuperar los datos filtrados mediante descarga directa, respuesta API, devoluciones de llamada Webhook, Amazon S3, Google Cloud Storage, Snowflake, Azure, SFTP o correo electrónico. Elija el método de entrega que mejor se adapte a su flujo de trabajo.

La API devolverá un error 422 con el mensaje «El filtro proporcionado no coincide con ningún registro». Revise la sintaxis y los valores del filtro para asegurarse de que coinciden con los datos del conjunto de datos. Puede obtener una vista previa de los campos del conjunto de datos y los datos de muestra en el Panel de control antes de filtrar.

Sí. Cada conjunto de datos tiene un límite máximo de 100 trabajos paralelos. Si supera este límite, recibirá un error 429. Espere a que se completen los trabajos existentes antes de iniciar otros nuevos, o Contáctanos para casos de uso de gran volumen que requieran límites mayores.

Si el saldo de su cuenta es insuficiente para procesar la instantánea filtrada, recibirá un error 402 indicando la cantidad necesaria. Añada fondos a su cuenta o ajuste su filtro para reducir el número de registros antes de volver a intentarlo.

En la documentación de la API para cURL, Python, JavaScript y Java se pueden encontrar ejemplos de código completos. Cada ejemplo muestra cómo autenticarse, estructurar la solicitud de filtro y gestionar la respuesta. También puede generar la sintaxis del filtro directamente desde el Panel de control aplicando filtros en la interfaz de usuario y haciendo clic en «API de filtro».