Cowin-notification

a python script that can look for vaccine avaiability based on your preferences

Setup Guide:

Install dependecies:
```
pip install -r requirements.txt
```
Setup a telegram bot and obtain the API token
Obtain the telegram chat ID you wish to use
```
python3 Cowin-Notify.py --api=<API_TOKEN> --cid=<CHAT_ID> --did=<DISTRICT_ID> [OPTIONS]
```
Argument Description:

Required Arguments:
- API_Token:
  - --api=<API_TOKEN> Replace <API_TOKEN> with the API access token of your telegram bot
- Chat_ID:
  - --cid=<CHAT_ID> Replace <CHAT_ID> with the Chat ID you want your bot to report to
- DISTRICT_ID:
  - --did=<DISTRICT_ID> Replace <DISTRICT_ID> with the District ID you want to search in
Basic Arguments ( Optional )
- DATE:
  - --date=dd-mm-yyyy enter the date(s) you wish to search
  - default value will be the current date
- AGE:
  - --age=<AGE> Replace <AGE> with the Age range you wish to search. Currently the options are: 18,45
  - default value is: 18,45
- VACCINE_TYPE:
  - --vaccine=<VACCINE> Replace <VACCINE> with the type of vaccine you prefer
  - Currently the options are: COVAXIN,COVISHIELD,SPUTNIK
  - default value is: COVAXIN,COVISHIELD,SPUTNIK
- DOSES:
  - --dose=<DOSE_NUMBER> Replace <DOSE_NUMBER> with the dose number the to look for specific doeses
  - default value is: 1,2 (This may cause issues in the future depending on if dose2 does not exist)
- THRESHOLD:
  - --threshold=<THRESHOLD> Replace <THRESHOLD> with the number of doses ( of each type ) that need to be present for you to be notified
  - default value is: 1
  - For example: if you use the option -threshold=12, you will only be notified if there are 12 dose1 or 12 dose2 vaccines respectively
  - Warning: changing this value to 0 will notify you of every slot available and likely cause a crash with telegram bot
Advanced Arguments ( Optional )
- EXPIRE_TIME:
  - --expire=<EXPIRE_TIME> Replace <EXPIRE_TIME> with the TTL for each message entry
  - changing this will resend messages that have not updated after <EXPIRE_TIME> mins
- ALTERNATE_SEARCH:
  - --alternate Include this option to try alternate search.
  - Use this when it appears the regular search is not finding slots available
  - Uses calendarByDistrict
  - Alternate seach will look for slots for the next 7 days after a given date so it is not neccessary to provide multiple dates

Example

python3 Cowin-Notify.py --date=02-06-2021,03-06-2021 --age=18,45 --vaccine=COVAXIN,COVISHIELD --did=265,273 --api=<API_KEY> --cid=<CHAT_ID>

Note: You can add mutiple arguments to each field by seperating with commas
Warning: Adding more dates or Districts will slow down bot response time

Setting up a Telegram Bot:

Open Telegram and search for the user @BotFather
Use /newbot to create a new bot. The BotFather will ask you for a name and username
Upon entering a valid name and username, BotFather will then generate an API token for your new bot.
Use the API token as mentioned above

Get your Telegram Chat ID :

Paste the following link in your browser. Replace <API_TOKEN> with the API access token that you identified or created in the previous section:
```
https://api.telegram.org/bot<API_TOKEN>/getUpdates?offset=0
```
Send a message to your bot in the Telegram application. The message text can be anything. Your chat history must include at least one message to get your chat ID.
Refresh your browser.
Identify the numerical chat ID by finding the id inside the chat JSON object. In the example below, the chat ID is 123456789.

{  
   "ok":true,
   "result":[  
      {  
         "update_id":XXXXXXXXX,
         "message":{  
            "message_id":2,
            "from":{  
               "id":123456789,
               "first_name":"Mushroom",
               "last_name":"Kap"
            },
            "chat":{  
               "id":123456789,
               "first_name":"Mushroom",
               "last_name":"Kap",
               "type":"private"
            },
            "date":1487183963,
            "text":"hi"
         }
      }
   ]
}

District IDs

Andaman & Nicobar Islands

3: Nicobar
1: North and Middle Andaman
2: South Andaman

Andhra Pradesh

9: Anantapur
10: Chittoor
11: East Godavari
5: Guntur
4: Krishna
7: Kurnool
12: Prakasam
13: Sri Potti Sriramulu Nellore
14: Srikakulam
8: Visakhapatnam
15: Vizianagaram
16: West Godavari
6: YSR District, Kadapa (Cuddapah)

Arunachal Pradesh

22: Anjaw
20: Changlang
25: Dibang Valley
23: East Kameng
42: East Siang
17: Itanagar Capital Complex
24: Kamle
27: Kra Daadi
21: Kurung Kumey
33: Lepa Rada
29: Lohit
40: Longding
31: Lower Dibang Valley
18: Lower Siang
32: Lower Subansiri
36: Namsai
19: Pakke Kessang
39: Papum Pare
35: Shi Yomi
37: Siang
30: Tawang
26: Tirap
34: Upper Siang
41: Upper Subansiri
28: West Kameng
38: West Siang

Assam

46: Baksa
47: Barpeta
765: Biswanath
57: Bongaigaon
66: Cachar
766: Charaideo
58: Chirang
48: Darrang
62: Dhemaji
59: Dhubri
43: Dibrugarh
67: Dima Hasao
60: Goalpara
53: Golaghat
68: Hailakandi
764: Hojai
54: Jorhat
49: Kamrup Metropolitan
50: Kamrup Rural
51: Karbi-Anglong
69: Karimganj
61: Kokrajhar
63: Lakhimpur
767: Majuli
55: Morigaon
56: Nagaon
52: Nalbari
44: Sivasagar
64: Sonitpur
768: South Salmara Mankachar
45: Tinsukia
65: Udalguri
769: West Karbi Anglong

Bihar

74: Araria
78: Arwal
77: Aurangabad
83: Banka
98: Begusarai
82: Bhagalpur
99: Bhojpur
100: Buxar
94: Darbhanga
105: East Champaran
79: Gaya
104: Gopalganj
107: Jamui
91: Jehanabad
80: Kaimur
75: Katihar
101: Khagaria
76: Kishanganj
84: Lakhisarai
70: Madhepura
95: Madhubani
85: Munger
86: Muzaffarpur
90: Nalanda
92: Nawada
97: Patna
73: Purnia
81: Rohtas
71: Saharsa
96: Samastipur
102: Saran
93: Sheikhpura
87: Sheohar
88: Sitamarhi
103: Siwan
72: Supaul
89: Vaishali
106: West Champaran

Chandigarh

108 Chandigarh

Chhattisgarh

110: Balod
111: Baloda bazar
112: Balrampur
113: Bastar
114: Bemetara
115: Bijapur
116: Bilaspur
117: Dantewada
118: Dhamtari
119: Durg
120: Gariaband
136: Gaurela Pendra Marwahi
121: Janjgir-Champa
122: Jashpur
123: Kanker
135: Kawardha
124: Kondagaon
125: Korba
126: Koriya
127: Mahasamund
128: Mungeli
129: Narayanpur
130: Raigarh
109: Raipur
131: Rajnandgaon
132: Sukma
133: Surajpur
134: Surguja

Dadra And Nagar Haveli

137 Dadra and Nagar Haveli

Delhi

141: Central Delhi
145: East Delhi
140: New Delhi
146: North Delhi
147: North East Delhi
143: North West Delhi
148: Shahdara
149: South Delhi
144: South East Delhi
150: South West Delhi
142: West Delhi

Goa

151: North Goa
152: South Goa

Gujarat

154: Ahmedabad
770: Ahmedabad Corporation
174: Amreli
179: Anand
158: Aravalli
159: Banaskantha
180: Bharuch
175: Bhavnagar
771: Bhavnagar Corporation
176: Botad
181: Chhotaudepur
182: Dahod
163: Dang
168: Devbhumi Dwaraka
153: Gandhinagar
772: Gandhinagar Corporation
177: Gir Somnath
169: Jamnagar
773: Jamnagar Corporation
178: Junagadh
774: Junagadh Corporation
156: Kheda
170: Kutch
183: Mahisagar
160: Mehsana
171: Morbi
184: Narmada
164: Navsari
185: Panchmahal
161: Patan
172: Porbandar
173: Rajkot
775: Rajkot Corporation
162: Sabarkantha
165: Surat
776: Surat Corporation
157: Surendranagar
166: Tapi
155: Vadodara
777: Vadodara Corporation
167: Valsad

Haryana

193: Ambala
200: Bhiwani
201: Charkhi Dadri
199: Faridabad
196: Fatehabad
188: Gurgaon
191: Hisar
189: Jhajjar
204: Jind
190: Kaithal
203: Karnal
186: Kurukshetra
206: Mahendragarh
205: Nuh
207: Palwal
187: Panchkula
195: Panipat
202: Rewari
192: Rohtak
194: Sirsa
198: Sonipat
197: Yamunanagar

Himachal Pradesh

219: Bilaspur
214: Chamba
217: Hamirpur
213: Kangra
216: Kinnaur
211: Kullu
210: Lahaul Spiti
215: Mandi
208: Shimla
212: Sirmaur
209: Solan
218: Una

Jammu & Kashmir

224: Anantnag
223: Bandipore
225: Baramulla
229: Budgam
232: Doda
228: Ganderbal
230: Jammu
234: Kathua
231: Kishtwar
221: Kulgam
226: Kupwara
238: Poonch
227: Pulwama
237: Rajouri
235: Ramban
239: Reasi
236: Samba
222: Shopian
220: Srinagar
233: Udhampur

Jharkhand

242: Bokaro
245: Chatra
253: Deoghar
257: Dhanbad
258: Dumka
247: East Singhbhum
243: Garhwa
256: Giridih
262: Godda
251: Gumla
255: Hazaribagh
259: Jamtara
252: Khunti
241: Koderma
244: Latehar
250: Lohardaga
261: Pakur
246: Palamu
254: Ramgarh
240: Ranchi
260: Sahebganj
248: Seraikela Kharsawan
249: Simdega
263: West Singhbhum

Karnataka

270: Bagalkot
276: Bangalore Rural
265: Bangalore Urban
294: BBMP
264: Belgaum
274: Bellary
272: Bidar
271: Chamarajanagar
273: Chikamagalur
291: Chikkaballapur
268: Chitradurga
269: Dakshina Kannada
275: Davanagere
278: Dharwad
280: Gadag
267: Gulbarga
289: Hassan
279: Haveri
283: Kodagu
277: Kolar
282: Koppal
290: Mandya
266: Mysore
284: Raichur
292: Ramanagara
287: Shimoga
288: Tumkur
286: Udupi
281: Uttar Kannada
293: Vijayapura
285: Yadgir

Kerala

301: Alappuzha
307: Ernakulam
306: Idukki
297: Kannur
295: Kasaragod
298: Kollam
304: Kottayam
305: Kozhikode
302: Malappuram
308: Palakkad
300: Pathanamthitta
296: Thiruvananthapuram
303: Thrissur
299: Wayanad

Ladakh

309: Kargil
310: Leh

Lakshwadweep islands

796: Agatti Island
311: Lakshadweep

Madhya Pradesh

320: Agar
357: Alirajpur
334: Anuppur
354: Ashoknagar
338: Balaghat
343: Barwani
362: Betul
351: Bhind
312: Bhopal
342: Burhanpur
328: Chhatarpur
337: Chhindwara
327: Damoh
350: Datia
324: Dewas
341: Dhar
336: Dindori
348: Guna
313: Gwalior
361: Harda
360: Hoshangabad
314: Indore
315: Jabalpur
340: Jhabua
353: Katni
339: Khandwa
344: Khargone
335: Mandla
319: Mandsaur
347: Morena
352: Narsinghpur
323: Neemuch
326: Panna
359: Raisen
358: Rajgarh
322: Ratlam
316: Rewa
317: Sagar
333: Satna
356: Sehore
349: Seoni
332: Shahdol
321: Shajapur
346: Sheopur
345: Shivpuri
331: Sidhi
330: Singrauli
325: Tikamgarh
318: Ujjain
329: Umaria
355: Vidisha

Maharashtra

391: Ahmednagar
364: Akola
366: Amravati
397: Aurangabad
384: Beed
370: Bhandara
367: Buldhana
380: Chandrapur
388: Dhule
379: Gadchiroli
378: Gondia
386: Hingoli
390: Jalgaon
396: Jalna
371: Kolhapur
383: Latur
395: Mumbai
365: Nagpur
382: Nanded
387: Nandurbar
389: Nashik
381: Osmanabad
394: Palghar
385: Parbhani
363: Pune
393: Raigad
372: Ratnagiri
373: Sangli
376: Satara
374: Sindhudurg
375: Solapur
392: Thane
377: Wardha
369: Washim
368: Yavatmal

Manipur

398: Bishnupur
399: Chandel
400: Churachandpur
401: Imphal East
402: Imphal West
410: Jiribam
413: Kakching
409: Kamjong
408: Kangpokpi
412: Noney
411: Pherzawl
403: Senapati
404: Tamenglong
407: Tengnoupal
405: Thoubal
406: Ukhrul

Meghalaya

424: East Garo Hills
418: East Jaintia Hills
414: East Khasi Hills
423: North Garo Hills
417: Ri-Bhoi
421: South Garo Hills
422: South West Garo Hills
415: South West Khasi Hills
420: West Garo Hills
416: West Jaintia Hills
419: West Khasi Hills

Mizoram

425: Aizawl East
426: Aizawl West
429: Champhai
428: Kolasib
432: Lawngtlai
431: Lunglei
427: Mamit
430: Serchhip
433: Siaha

Nagaland

434: Dimapur
444: Kiphire
441: Kohima
438: Longleng
437: Mokokchung
439: Mon
435: Peren
443: Phek
440: Tuensang
436: Wokha
442: Zunheboto

Odisha

445: Angul
448: Balangir
447: Balasore
472: Bargarh
454: Bhadrak
468: Boudh
457: Cuttack
473: Deogarh
458: Dhenkanal
467: Gajapati
449: Ganjam
459: Jagatsinghpur
460: Jajpur
474: Jharsuguda
464: Kalahandi
450: Kandhamal
461: Kendrapara
455: Kendujhar
446: Khurda
451: Koraput
469: Malkangiri
456: Mayurbhanj
470: Nabarangpur
462: Nayagarh
465: Nuapada
463: Puri
471: Rayagada
452: Sambalpur
466: Subarnapur
453: Sundargarh

Puducherry

476: Karaikal
477: Mahe
475: Puducherry
478: Yanam

Punjab

485: Amritsar
483: Barnala
493: Bathinda
499: Faridkot
484: Fatehgarh Sahib
487: Fazilka
480: Ferozpur
489: Gurdaspur
481: Hoshiarpur
492: Jalandhar
479: Kapurthala
488: Ludhiana
482: Mansa
491: Moga
486: Pathankot
494: Patiala
497: Rup Nagar
498: Sangrur
496: SAS Nagar
500: SBS Nagar
490: Sri Muktsar Sahib
495: Tarn Taran

Rajasthan

507: Ajmer
512: Alwar
519: Banswara
516: Baran
528: Barmer
508: Bharatpur
523: Bhilwara
501: Bikaner
514: Bundi
521: Chittorgarh
530: Churu
511: Dausa
524: Dholpur
520: Dungarpur
517: Hanumangarh
505: Jaipur I
506: Jaipur II
527: Jaisalmer
533: Jalore
515: Jhalawar
510: Jhunjhunu
502: Jodhpur
525: Karauli
503: Kota
532: Nagaur
529: Pali
522: Pratapgarh
518: Rajsamand
534: Sawai Madhopur
513: Sikar
531: Sirohi
509: Sri Ganganagar
526: Tonk
504: Udaipur

Sikkim

535: East Sikkim
537: North Sikkim
538: South Sikkim
536: West Sikkim

Tamil Nadu

779: Aranthangi
555: Ariyalur
578: Attur
565: Chengalpet
571: Chennai
778: Cheyyar
539: Coimbatore
547: Cuddalore
566: Dharmapuri
556: Dindigul
563: Erode
552: Kallakurichi
557: Kanchipuram
544: Kanyakumari
559: Karur
780: Kovilpatti
562: Krishnagiri
540: Madurai
576: Nagapattinam
558: Namakkal
577: Nilgiris
564: Palani
573: Paramakudi
570: Perambalur
575: Poonamallee
546: Pudukkottai
567: Ramanathapuram
781: Ranipet
545: Salem
561: Sivaganga
580: Sivakasi
551: Tenkasi
541: Thanjavur
569: Theni
554: Thoothukudi (Tuticorin)
560: Tiruchirappalli
548: Tirunelveli
550: Tirupattur
568: Tiruppur
572: Tiruvallur
553: Tiruvannamalai
574: Tiruvarur
543: Vellore
542: Viluppuram
549: Virudhunagar

Telangana

582: Adilabad
583: Bhadradri Kothagudem
581: Hyderabad
584: Jagtial
585: Jangaon
586: Jayashankar Bhupalpally
587: Jogulamba Gadwal
588: Kamareddy
589: Karimnagar
590: Khammam
591: Kumuram Bheem
592: Mahabubabad
593: Mahabubnagar
594: Mancherial
595: Medak
596: Medchal
612: Mulugu
597: Nagarkurnool
598: Nalgonda
613: Narayanpet
599: Nirmal
600: Nizamabad
601: Peddapalli
602: Rajanna Sircilla
603: Rangareddy
604: Sangareddy
605: Siddipet
606: Suryapet
607: Vikarabad
608: Wanaparthy
609: Warangal(Rural)
610: Warangal(Urban)
611: Yadadri Bhuvanagiri

Tripura

614: Dhalai
615: Gomati
616: Khowai
617: North Tripura
618: Sepahijala
619: South Tripura
620: Unakoti
621: West Tripura

Uttar Pradesh

622: Agra
623: Aligarh
625: Ambedkar Nagar
626: Amethi
627: Amroha
628: Auraiya
646: Ayodhya
629: Azamgarh
630: Badaun
631: Baghpat
632: Bahraich
633: Balarampur
634: Ballia
635: Banda
636: Barabanki
637: Bareilly
638: Basti
687: Bhadohi
639: Bijnour
640: Bulandshahr
641: Chandauli
642: Chitrakoot
643: Deoria
644: Etah
645: Etawah
647: Farrukhabad
648: Fatehpur
649: Firozabad
650: Gautam Buddha Nagar
651: Ghaziabad
652: Ghazipur
653: Gonda
654: Gorakhpur
655: Hamirpur
656: Hapur
657: Hardoi
658: Hathras
659: Jalaun
660: Jaunpur
661: Jhansi
662: Kannauj
663: Kanpur Dehat
664: Kanpur Nagar
665: Kasganj
666: Kaushambi
667: Kushinagar
668: Lakhimpur Kheri
669: Lalitpur
670: Lucknow
671: Maharajganj
672: Mahoba
673: Mainpuri
674: Mathura
675: Mau
676: Meerut
677: Mirzapur
678: Moradabad
679: Muzaffarnagar
680: Pilibhit
682: Pratapgarh
624: Prayagraj
681: Raebareli
683: Rampur
684: Saharanpur
685: Sambhal
686: Sant Kabir Nagar
688: Shahjahanpur
689: Shamli
690: Shravasti
691: Siddharthnagar
692: Sitapur
693: Sonbhadra
694: Sultanpur
695: Unnao
696: Varanasi

Uttarakhand

704: Almora
707: Bageshwar
699: Chamoli
708: Champawat
697: Dehradun
702: Haridwar
709: Nainital
698: Pauri Garhwal
706: Pithoragarh
700: Rudraprayag
701: Tehri Garhwal
705: Udham Singh Nagar
703: Uttarkashi

West Bengal

710: Alipurduar District
711: Bankura
712: Basirhat HD (North 24 Parganas)
713: Birbhum
714: Bishnupur HD (Bankura)
715: Cooch Behar
783: COOCHBEHAR
716: Dakshin Dinajpur
717: Darjeeling
718: Diamond Harbor HD (S 24 Parganas)
719: East Bardhaman
720: Hoogly
721: Howrah
722: Jalpaiguri
723: Jhargram
724: Kalimpong
725: Kolkata
726: Malda
727: Murshidabad
728: Nadia
729: Nandigram HD (East Medinipore)
730: North 24 Parganas
731: Paschim Medinipore
732: Purba Medinipore
733: Purulia
734: Rampurhat HD (Birbhum)
735: South 24 Parganas
736: Uttar Dinajpur
737: West Bardhaman

Daman&Diu

138: Daman
139: Diu

Himachal Pradesh

791: Chamba
795: Kangra
792: Kinnaur
793: Mandi
794: Shimla

Nikateen / Cowin-notification

Cowin-notification

Setup Guide:

Argument Description:

Required Arguments:

Basic Arguments ( Optional )

Advanced Arguments ( Optional )

Example

Setting up a Telegram Bot:

Get your Telegram Chat ID :

District IDs

About

Languages