GSTIN Scraper

Pricing

Rating

Developer

Actor stats

Categories

Share

Features

• Comprehensive GST Data Extraction: Scrapes all available GSTIN information from GST portal
• Taxpayer Details: Extracts complete taxpayer information including legal name, trade name, registration details, business activities, and address
• State Jurisdiction Parsing: Automatically splits state jurisdiction into separate fields (state, division, zone, circle) for easier filtering and analysis
• HSN Codes & Services: Captures goods and services information with HSN codes for goods and SAC codes for services
• Filing Status & History: Extracts complete return filing status for all financial years with detailed monthly/quarterly filing information
• Financial Years Data: Retrieves available financial years and filing frequency preferences
• Flexible Data Extraction: Choose which data to extract (HSN codes, filing details, or both) using input parameters
• Usage-based Billing: Pay only for the data you actually extract with transparent per-item charging

Input Parameters

Input Schema Example

{
"gstins":["06AAICK7471J1Z4","07AABCT1234F1Z5"],
"extractHsnCodes":true,
"extractFilingDetails":true
}

Advanced Usage Examples

Extract only taxpayer details (no HSN codes or filing details):

{
"gstins":["06AAICK7471J1Z4"],
"extractHsnCodes":false,
"extractFilingDetails":false
}

Extract taxpayer details and HSN codes only:

{
"gstins":["06AAICK7471J1Z4"],
"extractHsnCodes":true,
"extractFilingDetails":false
}

Extract taxpayer details and filing details only:

{
"gstins":["06AAICK7471J1Z4"],
"extractHsnCodes":false,
"extractFilingDetails":true
}

Billing and Charges

This actor uses a usage-based billing system. You are charged based on the data you actually extract:

Billing Events

Output Schema

The scraper outputs structured JSON data for each GSTIN. Below is the complete output schema:

Detailed Output Structure

Good Service Object

{
"services":[
{
"sacCode":"998361",
"description":"Advertising Services"
},
{
"sacCode":"998599",
"description":"Other support services nowhere else classified"
}
]
}

Financial Years Array

[
{
"year":"2021-2022",
"value":"2021"
},
{
"year":"2022-2023",
"value":"2022"
}
]

Filing Status Array (Each year contains)

[
{
"year":"2021",
"returns":[
{
"financialYear":"2021-2022",
"taxPeriod":"March",
"modeOfFiling":"ONLINE",
"dateOfFiling":"11/04/2022",
"returnType":"GSTR1",
"arn":"NA",
"status":"Filed"
}
]
}
]

Filing Frequency Array

[
{
"quarter":"Q1",
"preference":"M",
"year":"2021"
}
]

Principal Address Object

{
"adr":"4th Floor, Unit No. 401 and Unit No. 402, Worldmark 2, Sector 65, Village Maidawas, Gurugram, Haryana, 122001"
}

Sample Output

here's a sample of the GSTIN data structure:

{
"goodservice":{
"services":[
{
"sacCode":"998361",
"description":"Advertising Services"
},
{
"sacCode":"998599",
"description":"Other support services nowhere else classified"
}
]
},
"finanacialYears":[
{
"year":"2021-2022",
"value":"2021"
},
{
"year":"2022-2023",
"value":"2022"
},
{
"year":"2023-2024",
"value":"2023"
},
{
"year":"2024-2025",
"value":"2024"
},
{
"year":"2025-2026",
"value":"2025"
}
],
"filingStatus":[
{
"year":"2025",
"returns":[
{
"financialYear":"2025-2026",
"taxPeriod":"April",
"modeOfFiling":"ONLINE",
"dateOfFiling":"20/05/2025",
"returnType":"GSTR3B",
"arn":"NA",
"status":"Filed"
}
]
}
],
"filingFrequency":[
{
"quarter":"Q4",
"preference":"M",
"year":"2025"
}
],
"natureOfTaxpayer":"SPO",
"isAadhaarVerified":"No",
"legalName":"KFC INDIA MARKETING PRIVATE LIMITED",
"stateJurisdiction":"State - Haryana,Range - Gurgaon,District - Gurgaon (South),Ward - Gurgaon (South) Ward 1",
"state":"Haryana",
"division":null,
"zone":null,
"circle":null,
"taxpayerType":"Regular",
"cancellationDate":"",
"gstinNumber":"06AAICK7471J1Z4",
"businessActivities":[
"Export",
"Supplier of Services",
"Recipient of Goods or Services",
"Others"
],
"isEKYCVerified":"No",
"compositionScheme":"NA",
"registrationDate":"07/07/2021",
"companyType":"Private Limited Company",
"principalAddress":{
"adr":"4th Floor, Unit No. 401 and Unit No. 402, Worldmark 2, Sector 65, Village Maidawas, Gurugram, Haryana, 122001"
},
"status":"Active",
"tradeName":"KFC INDIA MARKETING PRIVATE LIMITED",
"fieldVisitConducted":"No",
"taxJurisdiction":"State - CBIC,Zone - PANCHKULA,Commissionerate - GURUGRAM,Division - DIVISION-SOUTH-1,Range - R-20 (Jurisdictional Office)",
"eInvoiceEnabled":"Yes"
}

Changelog

For a detailed list of changes and version history, see CHANGELOG.md.

Support

For issues and questions:

• Ensure GSTIN numbers are valid 15-digit format
• Verify GST portal accessibility
• Email : lakshmanan.w3dev@gmail.com