API Reference

https://api.finscreener.in

POST /api/auth/login
Content-Type: application/json

{
  "api_key": "fsk_your_api_key"
}

{
  "token": {
    "access_token": "eyJhbGciOiJIUzI1NiIs...",
    "refresh_token": "eyJhbGciOiJIUzI1NiIs...",
    "token_type": "bearer"
  }
}

Authorization: Bearer <access_token>

POST /api/auth/refresh-token
Content-Type: application/json

{
  "refresh_token": "your_refresh_token"
}

{
  "data": { ... },
  "message": "Success"
}

{
  "detail": "Error message describing what went wrong"
}

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 2026-03-25T23:59:59Z

import requests

class FinscreenerClient:
    def __init__(self, api_key):
        self.base_url = "https://api.finscreener.in"
        self.api_key = api_key
        self.token = None

    def login(self):
        response = requests.post(
            f"{self.base_url}/api/auth/login",
            json={"api_key": self.api_key}
        )
        self.token = response.json()["token"]["access_token"]
        return self.token

    def _headers(self):
        return {"Authorization": f"Bearer {self.token}"}

    def search(self, query, entity_type="company", page=1, limit=10):
        return requests.post(
            f"{self.base_url}/api/screener/search",
            json={"query": query, "type": entity_type, "page": page, "limit": limit},
            headers=self._headers()
        ).json()

    def filter_companies(self, **filters):
        return requests.get(
            f"{self.base_url}/api/company/company-filter",
            params=filters,
            headers=self._headers()
        ).json()

    def get_company_details(self, cin):
        return requests.get(
            f"{self.base_url}/api/company/details",
            params={"cin": cin},
            headers=self._headers()
        ).json()

# Usage
client = FinscreenerClient("fsk_your_api_key")
client.login()
results = client.filter_companies(company="Reliance", state="Maharashtra")

const axios = require('axios');

class FinscreenerClient {
  constructor(apiKey) {
    this.baseUrl = 'https://api.finscreener.in';
    this.apiKey = apiKey;
    this.token = null;
  }

  async login() {
    const response = await axios.post(`${this.baseUrl}/api/auth/login`, {
      api_key: this.apiKey
    });
    this.token = response.data.token.access_token;
    return this.token;
  }

  get headers() {
    return { Authorization: `Bearer ${this.token}` };
  }

  async search(query, type = 'company', page = 1, limit = 10) {
    const response = await axios.post(
      `${this.baseUrl}/api/screener/search`,
      { query, type, page, limit },
      { headers: this.headers }
    );
    return response.data;
  }

  async filterCompanies(filters) {
    const response = await axios.get(
      `${this.baseUrl}/api/company/company-filter`,
      { params: filters, headers: this.headers }
    );
    return response.data;
  }

  async getCompanyDetails(cin) {
    const response = await axios.get(
      `${this.baseUrl}/api/company/details`,
      { params: { cin }, headers: this.headers }
    );
    return response.data;
  }
}

// Usage
const client = new FinscreenerClient('fsk_your_api_key');
await client.login();
const results = await client.filterCompanies({ company: 'Reliance', state: 'Maharashtra' });

# Login with API key
TOKEN=$(curl -s -X POST https://api.finscreener.in/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"api_key": "fsk_your_api_key"}' | jq -r '.token.access_token')

# Filter companies
curl -X GET "https://api.finscreener.in/api/company/company-filter?company=Reliance&state=Maharashtra" \
  -H "Authorization: Bearer $TOKEN"

# Get company details
curl -X GET "https://api.finscreener.in/api/company/details?cin=L17110MH1973PLC019786" \
  -H "Authorization: Bearer $TOKEN"