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

# FQL Introduction

> Master the Finscreener Query Language for powerful data filtering

## What is FQL?

FQL (Finscreener Query Language) is your key to unlocking powerful data insights. It lets you filter companies and GST records with simple, precise queries.

Think of queries as conversations with your data. You ask questions, and the system finds answers.

## Query Anatomy

Every FQL query follows a simple pattern:

```
Field Operator Value
```

**Example:**

```
City == 'Mumbai'
```

| Component    | Description                | Example                 |
| ------------ | -------------------------- | ----------------------- |
| **Field**    | What you want to filter by | `City`, `paidUpCapital` |
| **Operator** | How to compare             | `==`, `>`, `CONTAINS`   |
| **Value**    | What you're looking for    | `'Mumbai'`, `10000000`  |

## Quick Start Examples

<AccordionGroup>
  <Accordion title="Beginner: Find Companies in a City">
    ```
    City == 'Mumbai'
    ```

    Simple location-based filtering.
  </Accordion>

  <Accordion title="Intermediate: High-Capital Tech Companies">
    ```
    NICDesc CONTAINS 'software' AND paidUpCapital > 10000000
    ```

    Combining text search with numerical filtering.
  </Accordion>

  <Accordion title="Advanced: Multi-State Investment Targets">
    ```
    (State IN ['Maharashtra', 'Karnataka']) AND ((classOfCompany == 'Public' AND Listed == 'Listed') OR paidUpCapital > 50000000)
    ```

    Complex logic with grouping and multiple conditions.
  </Accordion>
</AccordionGroup>

## Key Concepts

### Case Sensitivity

<Warning>
  **Field names are CASE-SENSITIVE!**

  * Company fields: `City`, `State`, `NICCode` (capitalized)
  * GST fields: `state` (lowercase!)
</Warning>

### String Values

Always wrap string values in single quotes:

```
City == 'Mumbai'  ✓
City == Mumbai    ✗
```

### Numeric Values

Numbers don't need quotes:

```
paidUpCapital > 10000000  ✓
```

### Combining Conditions

| Operator | Description                  | Example                                        |
| -------- | ---------------------------- | ---------------------------------------------- |
| `AND`    | Both conditions must be true | `City == 'Mumbai' AND paidUpCapital > 1000000` |
| `OR`     | Either condition can be true | `City == 'Mumbai' OR City == 'Delhi'`          |

### Grouping with Parentheses

Use parentheses to control evaluation order:

```
(companyType == 'Public' OR companyType == 'Private') AND City == 'Mumbai'
```

## Data Statistics

<CardGroup cols={3}>
  <Card title="5M+" icon="building">
    Companies
  </Card>

  <Card title="12M+" icon="receipt">
    GST Records
  </Card>

  <Card title="100+" icon="database">
    Filterable Fields
  </Card>
</CardGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Operators" icon="code" href="/fql/operators">
    Learn all available FQL operators.
  </Card>

  <Card title="Company Fields" icon="building" href="/fql/company-fields">
    Explore company-specific fields.
  </Card>

  <Card title="GST Fields" icon="receipt" href="/fql/gst-fields">
    Explore GST-specific fields.
  </Card>

  <Card title="Examples" icon="lightbulb" href="/fql/examples">
    Real-world query examples.
  </Card>
</CardGroup>