FSSAI FoSCoS Scraper

An Apify Actor for verifying FSSAI (Food Safety and Standards Authority of India) license numbers using the FoSCoS (Food Safety Compliance System) portal. This scraper uses advanced encryption/decryption techniques to securely communicate with the FSSAI API and extract comprehensive license information.

Features

• Advanced Encryption: Implements AES-ECB encryption with custom key generation for secure API communication
• Comprehensive License Data: Extracts complete FSSAI license information including company details, addresses, and license status
• Robust Error Handling: Detailed error logging and graceful failure handling
• Structured JSON Output: Well-formatted data with proper data types and validation
• Apify Integration: Full Apify platform support with dataset storage and logging
• Detailed Logging: Saves encrypted requests, API responses, and decrypted data for debugging

Input Parameters

Parameter	Type	Required	Default	Description
fssaiNos	Array	Yes	["12421012003663"]	Array of 14-digit FSSAI license numbers to verify

Input Schema Example

{
  "fssaiNos": ["12421012003663", "12418012002769"]
}

Output Schema

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

Field	Type	Description
fssai_no	String	The 14-digit FSSAI license number that was verified
success	Boolean	Whether the verification was successful
logs_dir	String	Path to the detailed logs directory for this verification
premiseaddress	String	Registered business address
licenseno	String	FSSAI license number
fboid	Number	FBO (Food Business Operator) ID
displayrefid	String	Display reference ID
licensecategoryname	String	License category (State/Central)
statename	String	State name
statusdesc	String	License status description
licensecategoryid	Number	License category ID
talukname	String	Taluk/Block name
districtname	String	District name
companyname	String	Registered company/business name
licenseactiveflag	Boolean	Whether the license is currently active
refid	Number	Reference ID
apptypedesc	String	Application type description
villagename	String	Village name (if applicable)
premisepincode	Number	PIN code of the premises

Technical Details

Encryption Implementation

• Algorithm: AES-128-ECB with PKCS7 padding
• Key Generation: Custom XOR-based key derivation using predefined arrays
• Request Encryption: Plain JSON payloads are encrypted before sending
• Response Decryption: Encrypted API responses are decrypted using matching keys
• Security: Implements the exact encryption scheme used by FoSCoS portal

API Communication

• Endpoint: https://foscos.fssai.gov.in/webgateway/commonauth_readonly/commonapi/getsearchapplicationdetails/1
• Method: POST with encrypted payload
• Headers: Standard web headers with proper User-Agent and Referer
• Response Format: JSON with encryptedResponse and signature fields

Data Processing

• Validation: 14-digit FSSAI number format validation
• Error Handling: Comprehensive error catching with detailed logging
• Data Extraction: Automatic parsing of decrypted license information
• Logging: Saves all request/response data for debugging

Logging System

• Directory Structure: storage/logs/{fssaiNo}/
• Files Saved:
  • api_response.json: Full API response with headers and metadata
  • decrypted_response.json: Decrypted license data
  • error.log: Detailed error information (if any)

Sample Output

{
  "fssai_no": "12421012003663",
  "success": true,
  "logs_dir": "storage/logs/12421012003663",
  "premiseaddress": "2-C, Vinayaga Nagar",
  "licenseno": "12421012003663",
  "fboid": 29501920051690868,
  "displayrefid": "20241121106688114",
  "licensecategoryname": "State License",
  "statename": "Tamil Nadu",
  "statusdesc": "License Issued",
  "licensecategoryid": 2,
  "talukname": "Madurai Corporation Ward-44",
  "districtname": "Madurai",
  "companyname": "Sapphire Foods India Limited (KFC)",
  "licenseactiveflag": true,
  "refid": 106688114,
  "apptypedesc": "Renewal",
  "villagename": null,
  "premisepincode": 625020
}

Usage Examples

Single License Verification

{
  "fssaiNos": ["12421012003663"]
}

Multiple License Verification

{
  "fssaiNos": [
    "12421012003663",
    "12418012002769",
    "10011011000123"
  ]
}

Error Handling

The scraper handles various error scenarios:

• Invalid FSSAI Format: Returns error for non-14-digit numbers
• API Errors: Logs detailed error information with response codes
• Decryption Failures: Saves encrypted responses for manual analysis
• Network Issues: Comprehensive error logging with timestamps

Security Notes

• Encryption Keys: Uses the same encryption scheme as the official FoSCoS portal
• Data Privacy: All sensitive data is properly encrypted in transit
• API Compliance: Follows the official FSSAI API specifications
• No Data Storage: Only processes and returns license verification results

Support

For issues and questions:

• Check the detailed logs in storage/logs/{fssaiNo}/ directories
• Review the Apify Actor logs in the platform
• Ensure FSSAI numbers are valid 14-digit format
• Verify API connectivity to FoSCoS portal
• Email : lakshmanan.w3dev@gmail.com