Quick Start

import requests

API_KEY = "fsk_your_api_key"
BASE_URL = "https://api.finscreener.in"

# Step 1: Authenticate
auth_response = requests.post(
    f"{BASE_URL}/api/auth/login",
    json={"api_key": API_KEY}
)
token = auth_response.json()["token"]["access_token"]

# Step 2: Search companies
headers = {"Authorization": f"Bearer {token}"}
search_response = requests.post(
    f"{BASE_URL}/api/screener/search",
    headers=headers,
    json={
        "query": "City == 'Mumbai' AND paidUpCapital > 10000000",
        "type": "company",
        "page": 1,
        "limit": 10
    }
)
companies = search_response.json()["data"]
print(f"Found {len(companies)} companies")

const API_KEY = "fsk_your_api_key";
const BASE_URL = "https://api.finscreener.in";

// Step 1: Authenticate
const authResponse = await fetch(`${BASE_URL}/api/auth/login`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ api_key: API_KEY })
});
const { token } = await authResponse.json();

// Step 2: Search companies
const searchResponse = await fetch(`${BASE_URL}/api/screener/search`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${token.access_token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    query: "City == 'Mumbai' AND paidUpCapital > 10000000",
    type: "company",
    page: 1,
    limit: 10
  })
});
const { data } = await searchResponse.json();
console.log(`Found ${data.length} companies`);