curl -X POST https://api.finscreener.in/api/screener/screeners \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Mumbai IT Companies",
"type": "company",
"query": "City == '\''Mumbai'\'' AND NICCode IN [62011, 62012]",
"description": "IT companies in Mumbai"
}'
import requests
response = requests.post(
"https://api.finscreener.in/api/screener/screeners",
headers={"Authorization": f"Bearer {token}"},
json={
"name": "Mumbai IT Companies",
"type": "company",
"query": "City == 'Mumbai' AND NICCode IN [62011, 62012]",
"description": "IT companies in Mumbai"
}
)
screener = response.json()
{
"data": {
"id": "scr_789",
"name": "Mumbai IT Companies",
"type": "company",
"query": "City == 'Mumbai' AND NICCode IN [62011, 62012]",
"description": "IT companies in Mumbai",
"created_at": "2026-02-04T12:00:00Z"
}
}
Screener
Create Screener
Save a new screener query
POST
/
api
/
screener
/
screeners
curl -X POST https://api.finscreener.in/api/screener/screeners \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Mumbai IT Companies",
"type": "company",
"query": "City == '\''Mumbai'\'' AND NICCode IN [62011, 62012]",
"description": "IT companies in Mumbai"
}'
import requests
response = requests.post(
"https://api.finscreener.in/api/screener/screeners",
headers={"Authorization": f"Bearer {token}"},
json={
"name": "Mumbai IT Companies",
"type": "company",
"query": "City == 'Mumbai' AND NICCode IN [62011, 62012]",
"description": "IT companies in Mumbai"
}
)
screener = response.json()
{
"data": {
"id": "scr_789",
"name": "Mumbai IT Companies",
"type": "company",
"query": "City == 'Mumbai' AND NICCode IN [62011, 62012]",
"description": "IT companies in Mumbai",
"created_at": "2026-02-04T12:00:00Z"
}
}
Save an FQL query as a named screener for future use.
Headers
string
required
Bearer token:
Bearer <access_token>Request Body
string
required
Screener name
string
required
Entity type:
company or gststring
required
FQL query string
string
Optional description
Field names are case-sensitive! Company fields use PascalCase (
City, State), GST fields use lowercase (state).curl -X POST https://api.finscreener.in/api/screener/screeners \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Mumbai IT Companies",
"type": "company",
"query": "City == '\''Mumbai'\'' AND NICCode IN [62011, 62012]",
"description": "IT companies in Mumbai"
}'
import requests
response = requests.post(
"https://api.finscreener.in/api/screener/screeners",
headers={"Authorization": f"Bearer {token}"},
json={
"name": "Mumbai IT Companies",
"type": "company",
"query": "City == 'Mumbai' AND NICCode IN [62011, 62012]",
"description": "IT companies in Mumbai"
}
)
screener = response.json()
{
"data": {
"id": "scr_789",
"name": "Mumbai IT Companies",
"type": "company",
"query": "City == 'Mumbai' AND NICCode IN [62011, 62012]",
"description": "IT companies in Mumbai",
"created_at": "2026-02-04T12:00:00Z"
}
}