> ## 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.

# Screener Guide

> Create powerful custom queries to filter companies and GST records

## Overview

The Finscreener Screener allows you to create custom FQL (Finscreener Query Language) queries to filter through millions of company and GST records with precision.

## Creating a Screener

<Steps>
  <Step title="Navigate to Screener">
    Go to the Screener section in your Finscreener dashboard.
  </Step>

  <Step title="Create New Screener">
    Click "Create" to start a new screener.
  </Step>

  <Step title="Configure Screener">
    * Enter a name and description
    * Select the entity type: **Company** or **GST**
    * Write your FQL query
  </Step>

  <Step title="Run & Analyze">
    Execute the screener and review your results.
  </Step>
</Steps>

## Quick Start Examples

<AccordionGroup>
  <Accordion title="Find Active Companies in Mumbai" icon="building">
    ```
    City == 'Mumbai' AND llpStatus == 'Active'
    ```

    This finds all companies with registered office in Mumbai that are currently active.
  </Accordion>

  <Accordion title="High Capital Tech Companies" icon="microchip">
    ```
    NICDesc CONTAINS 'software' AND paidUpCapital > 10000000
    ```

    Find software companies with paid-up capital over 1 crore.
  </Accordion>

  <Accordion title="Recently Incorporated Companies" icon="calendar">
    ```
    dateOfIncorporation > '2023-01-01' AND State == 'Karnataka'
    ```

    Companies incorporated after January 2023 in Karnataka.
  </Accordion>

  <Accordion title="GST Registrations by Turnover" icon="chart-line">
    ```
    Turnover > 10000000 AND state == 'Maharashtra'
    ```

    GST registrations in Maharashtra with turnover over 1 crore.
  </Accordion>
</AccordionGroup>

## Saving Screeners

Your screeners are saved automatically and can be:

* **Run again** with updated data
* **Modified** to adjust criteria
* **Shared** via the API
* **Exported** to Excel or CSV

## Best Practices

<CardGroup cols={2}>
  <Card title="Start Simple" icon="seedling">
    Begin with basic queries and add complexity as needed.
  </Card>

  <Card title="Use Indexed Fields" icon="bolt">
    Fields like City, State, and Status are indexed for faster queries.
  </Card>

  <Card title="Test Incrementally" icon="flask">
    Add one condition at a time to understand its impact.
  </Card>

  <Card title="Save Templates" icon="bookmark">
    Create screener templates for common use cases.
  </Card>
</CardGroup>

## Next Steps

<Card title="Learn FQL" icon="code" href="/fql/introduction">
  Master the Finscreener Query Language for advanced filtering.
</Card>
