borisat

a python library for retrieving company public data in thailand. It has its own public database for caching, so, it is really fast, smart, and save lot of time and energy.

Get Started

pip install borisat

import borisat

a_valid_tax_id = tax_id = '0105558096348'

if borisat.is_exist(tax_id):
    company = borisat.get_info(tax_id=tax_id) 
    print(company)
# NID='0105558096348' title_name='บริษัท' name='โฟลว์แอคเคาท์ จำกัด' surname='-' branch_name='โฟลว์แอคเคาท์ จำกัด' branch_number=0 branch_title_name='บริษัท' business_first_date='2016/04/07' building_name='ชุดสกุลไทย สุรวงศ์ ทาวเวอร์' floor_number='11' room_number='12B' village_name='-' house_number='141/12' moo_number='-' soi_name='-' street_name='สุรวงศ์' thambol='สุริยวงศ์' amphur='บางรัก' province='กรุงเทพมหานคร' post_code='10500'

another_valid_tax_id = tax_id = "0994000160097"
company = borisat.get_info(tax_id=tax_id) 
print(company)
# NID='0994000160097' title_name='มหาวิทยาลัย' name='เทคโนโลยีพระจอมเกล้าธนบุรี' surname='-' branch_name='กลุ่มงานส่งเสริมและบริการวิจัย' branch_number=0 branch_title_name='-' business_first_date='2013/09/17' building_name='สำนักงานอธิการบดี' floor_number='-' room_number='-' village_name='-' house_number='126' moo_number='-' soi_name='-' street_name='ประชาอุทิศ' thambol='บางมด' amphur='ทุ่งครุ' province='กรุงเทพมหานคร' post_code='10140'

Why it is the way it is?

0. the government public api is obsolete, doc is unclear and this is 2020, and it is SOAP api. OMG. thus, we need some kinds of modern interface.
1. retriving data from the government public api is F**king slow in the business hours. thus, we need some kinds of cache. a public one where who use this lib could enjoy.

A public cache?

There is no such thing as a public cache/database. There is a close thing.

1. Public Google BigQuery
2. Smart contact. Blockchain

being a cache key value access is so critical. if you use BigQuery to query for a single row, since it is a column-based db in will cost a lot when your database get bigger, very costly. and to let other have your write-only key to the database is nut.

on surface Blockchain seems legit. there is a mapping data type on solidity. Wow, this might be a way to go. I took my word back when I saw a blog, No, you don’t store data on the blockchain – here’s why 1MB for 700 Dollars, holy cow! I knows that there is a hashgraph blockchain. the price is great, but there is no official python support + the unofficial is 2 years old of unmaintain.

ok then, my last combo would be create a cache serverless api + store on a serverless database which I pay myself and let the lib call my fast api first, if there is no data, call the gov server, then lib call my api to store the cache. open source everything that is my experiment.

Roadmap

See project board