---
title: "SPQL"
slug: "spql"
description: "SPQL is a simple, free-form query language (currently in alpha stage) that enables data exploration via the Silent Push API via simple and intuitive syntax. SPQL can be used to search the Silent Push scan data repositories and may eventually be extended to other data repositories."
tags: ["spql"]
status: "update"
updated: 2026-01-07T15:39:53Z
published: 2026-01-07T15:39:53Z
canonical: "help.silentpush.com/spql"
---

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

# SPQL

Silent Push Query Language (SPQL) is a simple, free-form query language designed for exploring Silent Push scan data via an intuitive syntax. It enables users to search web data repositories, construct **Web Search** queries, and integrate with the **Silent Push API** for advanced automation.

## Key Features

- [**Intuitive syntax**](/v1/docs/syntax): Combines field names, operators, and values with `AND` connectors and list-based `OR` conditions for flexible querying.
- **Data exploration**: Queries six [data sources](/v1/docs/data-sources), including web data (**webscan**), .onion sites (**torscan**), and non-HTTP services (**services**).
- **API integration**: Execute queries via the [Silent Push API](/v1/docs/api-functionality-1) for programmatic access.
- **Command-Line support**: Use the `spql_cli.py` [utility](/v1/docs/command-line-utility) to run queries or generate JSON for API calls.
- **Field flexibility**: Supports a wide range of [field names](/v1/docs/supported-field-names) tailored to each data source.

## Use Cases

- Search for specific web server configurations (e.g., non-Apache servers with specific content types).
- Identify domains or SSL certificates matching patterns (e.g., expired certificates or .onion domains).
- Filter scan data by time, IP ranges, or other criteria for threat intelligence or research.

## Get Started

- Learn the syntax and see examples in [SPQL syntax rules](/v1/docs/syntax) and [SPQL query examples](/v1/docs/query-examples).
- Explore available data sources in [SPQL Data Sources](/v1/docs/data-sources).
- Use the API or command-line client for execution, as detailed in [SPQL API functionality](/v1/docs/api-functionality-1) and [SPQL command line utility](/v1/docs/command-line-utility).
- > **Note**: Currently, only RE2 regular expressions are supported.

## Next steps

- Use [SPQL syntax rules](/v1/docs/syntax) to construct queries, and then explore [SPQL query examples](/v1/docs/query-examples) for practical applications.
- For programmatic use, refer to [SPQL API functionality](/v1/docs/api-functionality-1) or [SPQL command line utility](/v1/docs/command-line-utility).