Metadata-Version: 2.1
Name: techieray-ai-reg-tracker-api
Version: 2.0.1
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests

# techieray_ai_reg_tracker-api
Python client library for connecting to API of techie_ray's Global AI Regulation Tracker (www.techieray.com/GlobalAIRegulationTracker)

# API key
To use this API, you need to purchase an API key on a subscription basis.
Details are set out in the 'API Access' tab on https://www.techieray.com/GlobalAIRegulationTracker

# Example Usage:
    from techieray_ai_reg_tracker_api import GlobalAIRegulationTrackerClient
    api_key = "###INSERT API KEY###"

    client = GlobalAIRegulationTrackerClient(api_key)

    try:
        response = client.call(
            market = "US", 
            target_news = "latest_news", 
            target_date = "2024-10-06"
        )    
        print("Response:", response)
        
    except requests.exceptions.RequestException as e:
        print(f"Error: {e}")
    
    except ValueError as e:
        print(f"Value Error: {e}")


# Types of searches:
The API currently supports 4 types of searches:

### Search updates for a specific date across all markets 
    client.call(
        market = "global",
        target_news = "",
        target_date = "2023-10-25"
    )

This searches for news updates dated 25 October 2023 across the world. Note that the target_news argument is intentionally left as "".

### Search updates for a specific date in a specific market
    client.call(
        market = "US",
        target_news = "",
        target_date = "2023-10-25"
    )
This searches for news updates dated 25 October 2023 in the United States of America ('US'). The search will go through all latest_news, sector_news and bilateral_multilateral_news (unless target_news argument is specified)

### Search specific class of updates in a specific market
    client.call(
        market = "US",
        target_news = "latest_news",
        target_date = ""
    )
This searches for latest_news (across all dates) in the United States of America ('US'). Note that the target_date argument is intentionally left as "".

### Search specific class of updates on specific date in a specific market
    client.call(
        market = "US",
        target_news = "latest_news",
        target_date = "2023-10-25"
    )
This searches for latest_news dated 25 October 2023 in the United States of America ('US').


# Arguments for target_news:
'latest_news' - retrieve entries from the "Latest Developments" section

'sector_news' - retrieve entries from the "Sector Developments" section

'bilateral_multilateral_news' - retrieve entries from the "Bilateral & Multilateral Developments" section

'official_materials' - retrieve entries from the "Official Materials" section

'acts_bills_reform' - retrieve entries from the "Acts, Bills & Reforms" section

'orders_admin_regs' - retrieve entries from the "Executive & Regulatory Instruments", "Executive Orders" (US) or "Measures, Provisions & Regulations" (China) sections

'guidelines_standards_frameworks' - retrieve entries from the "Guidelines, Frameworks & Standards" section

# Arguments for target_date:
The target_date argument is a string, and must be in the format 'yyyy-mm-dd'
For example, '2023-10-25'

# Arguments for market
Countries, regions and groups are represented the following codes.
    
    #Groups
    Europe: 'European Union',
    COE: 'Council of Europe',
    ASEAN: 'Association of Southeast Asian Nations',
    LAC: 'Intergovernmental Council on Artificial Intelligence for Latin America and the Caribbean',
    CLAD: 'Latin American Center for Development Administration',
    AFU: 'African Union',
    EARFAI: 'Eastern Africa Sub-Regional Forum on Artificial Intelligence',
    SARFAI: 'Southern Africa Sub-Regional Forum on Artificial Intelligence',
    CIS: ' Commonwealth of Independent States'
    G7: 'Group of Seven',
    G20: 'Group of Twenty',
    OECD: 'Organisation for Economic Co-operation and Development',
    
    #Countries
    AF: 'Afghanistan',
    AX: 'Åland Islands',
    AL: 'Albania',
    DZ: 'Algeria',
    AS: 'American Samoa',
    AD: 'Andorra',
    AO: 'Angola',
    AI: 'Anguilla',
    AQ: 'Antarctica',
    AG: 'Antigua and Barbuda',
    AR: 'Argentina',
    AM: 'Armenia',
    AW: 'Aruba',
    AU: 'Australia',
    AT: 'Austria (EU)',
    AZ: 'Azerbaijan',
    BS: 'Bahamas',
    BH: 'Bahrain',
    BD: 'Bangladesh',
    BB: 'Barbados',
    BY: 'Belarus',
    BE: 'Belgium (EU)',
    BZ: 'Belize',
    BJ: 'Benin',
    BM: 'Bermuda',
    BT: 'Bhutan',
    BO: 'Bolivia',
    BA: 'Bosnia and Herzegovina',
    BW: 'Botswana',
    BR: 'Brazil',
    IO: 'British Indian Ocean Territory',
    VG: 'British Virgin Islands',
    BN: 'Brunei Darussalam',
    BG: 'Bulgaria (EU)',
    BF: 'Burkina Faso',
    BI: 'Burundi',
    KH: 'Cambodia',
    CM: 'Cameroon',
    CA: 'Canada',
    CV: 'Cape Verde',
    BQ: 'Caribbean Netherlands',
    KY: 'Cayman Islands',
    CF: 'Central African Republic',
    TD: 'Chad',
    CL: 'Chile',
    CN: 'People\'s Republic of China',
    CX: 'Christmas Island',
    CC: 'Cocos Islands',
    CO: 'Colombia',
    KM: 'Comoros',
    CG: 'Congo',
    CK: 'Cook Islands',
    CR: 'Costa Rica',
    HR: 'Croatia (EU)',
    CU: 'Cuba',
    CW: 'Curaçao',
    CY: 'Cyprus (EU)',
    CZ: 'Czech Republic (EU)',
    CD: 'Democratic Republic of the Congo',
    DK: 'Denmark (EU)',
    DJ: 'Djibouti',
    DM: 'Dominica',
    DO: 'Dominican Republic',
    EC: 'Ecuador',
    EG: 'Egypt',
    SV: 'El Salvador',
    GQ: 'Equatorial Guinea',
    ER: 'Eritrea',
    EE: 'Estonia (EU)',
    ET: 'Ethiopia',
    FK: 'Falkland Islands',
    FO: 'Faroe Islands',
    FM: 'Federated States of Micronesia',
    FJ: 'Fiji',
    FI: 'Finland (EU)',
    FR: 'France (EU)',
    GF: 'French Guiana',
    PF: 'French Polynesia',
    TF: 'French Southern Territories',
    GA: 'Gabon',
    GM: 'Gambia',
    GE: 'Georgia',
    DE: 'Germany (EU)',
    GH: 'Ghana',
    GI: 'Gibraltar',
    GR: 'Greece (EU)',
    GL: 'Greenland',
    GD: 'Grenada',
    GP: 'Guadeloupe',
    GU: 'Guam',
    GT: 'Guatemala',
    GN: 'Guinea',
    GW: 'Guinea-Bissau',
    GY: 'Guyana',
    HT: 'Haiti',
    HN: 'Honduras',
    HK: 'Hong Kong SAR',
    HU: 'Hungary (EU)',
    IS: 'Iceland',
    IN: 'India',
    ID: 'Indonesia',
    IR: 'Iran',
    IQ: 'Iraq',
    IE: 'Ireland (EU)',
    IM: 'Isle of Man',
    IL: 'Israel',
    IT: 'Italy (EU)',
    CI: 'Ivory Coast',
    JM: 'Jamaica',
    JP: 'Japan',
    JE: 'Jersey',
    JO: 'Jordan',
    KZ: 'Kazakhstan',
    KE: 'Kenya',
    KI: 'Kiribati',
    XK: 'Kosovo',
    KW: 'Kuwait',
    KG: 'Kyrgyzstan',
    LA: 'Laos',
    LV: 'Latvia (EU)',
    LB: 'Lebanon',
    LS: 'Lesotho',
    LR: 'Liberia',
    LY: 'Libya',
    LI: 'Liechtenstein',
    LT: 'Lithuania (EU)',
    LU: 'Luxembourg (EU)',
    MO: 'Macau',
    MK: 'Macedonia',
    MG: 'Madagascar',
    MW: 'Malawi',
    MY: 'Malaysia',
    MV: 'Maldives',
    ML: 'Mali',
    MT: 'Malta (EU)',
    MH: 'Marshall Islands',
    MQ: 'Martinique',
    MR: 'Mauritania',
    MU: 'Mauritius',
    YT: 'Mayotte',
    MX: 'Mexico',
    MD: 'Moldova',
    MC: 'Monaco',
    MN: 'Mongolia',
    ME: 'Montenegro',
    MS: 'Montserrat',
    MA: 'Morocco',
    MZ: 'Mozambique',
    MM: 'Myanmar',
    NA: 'Namibia',
    NR: 'Nauru',
    NP: 'Nepal',
    NL: 'Netherlands (EU)',
    NC: 'New Caledonia',
    NZ: 'New Zealand',
    NI: 'Nicaragua',
    NE: 'Niger',
    NG: 'Nigeria',
    NU: 'Niue',
    NF: 'Norfolk Island',
    KP: 'North Korea',
    MP: 'Northern Mariana Islands',
    NO: 'Norway',
    OM: 'Oman',
    PK: 'Pakistan',
    PW: 'Palau',
    PS: 'Palestine',
    PA: 'Panama',
    PG: 'Papua New Guinea',
    PY: 'Paraguay',
    PE: 'Peru',
    PH: 'Philippines',
    PN: 'Pitcairn Islands',
    PL: 'Poland (EU)',
    PT: 'Portugal (EU)',
    PR: 'Puerto Rico',
    QA: 'Qatar',
    RE: 'Réunion',
    RO: 'Romania (EU)',
    RU: 'Russia',
    RW: 'Rwanda',
    SH: 'Saint Helena',
    KN: 'Saint Kitts and Nevis',
    LC: 'Saint Lucia',
    PM: 'Saint Pierre and Miquelon',
    VC: 'Saint Vincent and the Grenadines',
    WS: 'Samoa',
    SM: 'San Marino',
    ST: 'São Tomé and Príncipe',
    SA: 'Saudi Arabia',
    SN: 'Senegal',
    RS: 'Serbia',
    SC: 'Seychelles',
    SL: 'Sierra Leone',
    SG: 'Singapore',
    SX: 'Sint Maarten',
    SK: 'Slovakia (EU)',
    SI: 'Slovenia (EU)',
    SB: 'Solomon Islands',
    SO: 'Somalia',
    ZA: 'South Africa',
    GS: 'South Georgia and the South Sandwich Islands',
    KR: 'South Korea',
    SS: 'South Sudan',
    ES: 'Spain (EU)',
    LK: 'Sri Lanka',
    SD: 'Sudan',
    SR: 'Suriname',
    SJ: 'Svalbard and Jan Mayen',
    SZ: 'Eswatini',
    SE: 'Sweden (EU)',
    CH: 'Switzerland',
    SY: 'Syria',
    TW: 'Taiwan',
    TJ: 'Tajikistan',
    TZ: 'Tanzania',
    TH: 'Thailand',
    TL: 'Timor-Leste',
    TG: 'Togo',
    TK: 'Tokelau',
    TO: 'Tonga',
    TT: 'Trinidad and Tobago',
    TN: 'Tunisia',
    TR: 'Turkey',
    TM: 'Turkmenistan',
    TC: 'Turks and Caicos Islands',
    TV: 'Tuvalu',
    UG: 'Uganda',
    UA: 'Ukraine',
    AE: 'United Arab Emirates',
    GB: 'United Kingdom',
    US: 'United States',
    UM: 'United States Minor Outlying Islands',
    VI: 'United States Virgin Islands',
    UY: 'Uruguay',
    UZ: 'Uzbekistan',
    VU: 'Vanuatu',
    VA: 'Vatican City',
    VE: 'Venezuela',
    VN: 'Vietnam',
    WF: 'Wallis and Futuna',
    EH: 'Western Sahara',
    YE: 'Yemen',
    ZM: 'Zambia',
    ZW: 'Zimbabwe'

# LICENCE TERMS
The licence terms are available here: https://drive.google.com/file/d/1HklQHBTV8BaR0kdNRyvTbsFI_dFGz-v0/preview

