{"id":18576555,"url":"https://github.com/bigdatacloudapi/js-api-client","last_synced_at":"2025-09-05T01:34:43.276Z","repository":{"id":48780967,"uuid":"179824669","full_name":"bigdatacloudapi/js-api-client","owner":"bigdatacloudapi","description":"A frontend Javascript (JS) client for BigDataCloud API connectivity","archived":false,"fork":false,"pushed_at":"2023-09-13T01:54:46.000Z","size":18,"stargazers_count":10,"open_issues_count":1,"forks_count":16,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-10T21:39:38.289Z","etag":null,"topics":["api","big-data","bigdata","bigdatacloud","bigdatacloud-api","bigdatacloudapi","frontend-app","frontend-javascript","frontent-web","geolcoation","input-validation","ip-geolocation","ip-geolocation-api","ip-location","ip-location-lookup","ip-locator","javascript","javascript-api","reverse-geocoding"],"latest_commit_sha":null,"homepage":"https://www.bigdatacloud.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bigdatacloudapi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-04-06T11:27:03.000Z","updated_at":"2023-01-10T00:17:53.000Z","dependencies_parsed_at":"2024-11-06T23:29:05.351Z","dependency_job_id":null,"html_url":"https://github.com/bigdatacloudapi/js-api-client","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/bigdatacloudapi/js-api-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigdatacloudapi%2Fjs-api-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigdatacloudapi%2Fjs-api-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigdatacloudapi%2Fjs-api-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigdatacloudapi%2Fjs-api-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bigdatacloudapi","download_url":"https://codeload.github.com/bigdatacloudapi/js-api-client/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigdatacloudapi%2Fjs-api-client/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273699678,"owners_count":25152282,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-04T02:00:08.968Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","big-data","bigdata","bigdatacloud","bigdatacloud-api","bigdatacloudapi","frontend-app","frontend-javascript","frontent-web","geolcoation","input-validation","ip-geolocation","ip-geolocation-api","ip-location","ip-location-lookup","ip-locator","javascript","javascript-api","reverse-geocoding"],"created_at":"2024-11-06T23:25:24.010Z","updated_at":"2025-09-05T01:34:38.254Z","avatar_url":"https://github.com/bigdatacloudapi.png","language":"JavaScript","readme":"# BigDataCloud Javascript API Client\n\n\nA frontend Javascript client for connecting to the API services provided by [BigDataCloud](https://www.bigdatacloud.com)\nThis client works in plain Vanilla Javascript and also adds easy access if jQuery is available.\n\n\n\n## What API services does [BigDataCloud](https://www.bigdatacloud.com) offer?\n\nBigDataCloud offers a range of extremely useful and fast APIs that can be utilised in both backend and frontend scenarios.\nFrom validating customer input live to the next generation of IP Geolocation technology, BigDataCloud has an API suitable to your needs.\n\nYou can access any and all BigDataCloud APIs with a free API Key.\nTo get your API Key, just access your account and retrieve it from your [Account Dashboard](https://www.bigdatacloud.com/account).\nIf you are not yet a customer, it is completely free to join.\n\n### BigDataCloud API Packages\n\nAll BigDataCloud APIs are bundled into five different API packages. Each API package has its own subscription plans and pricings. \n\nYou can find more details on the respective API packages page.\n- [IP Geolocation Package](https://www.bigdatacloud.com/ip-geolocation)\n- [Reverse Geocoding Package](https://www.bigdatacloud.com/reverse-geocoding)\n- [Phone \u0026 Email Verification Package](https://www.bigdatacloud.com/phone-email-verification)\n- [Network Engineering Package](https://www.bigdatacloud.com/network-engineering), and\n- [Free API Package](https://www.bigdatacloud.com/free-api) (doesn't require account creation and API key)\n\n\n## Documentation\n\nFor documentation specific to this api client, please read below.\nFor more specific documentation to the APIs available, including endpoints, request and response data, please the respective API package page.\n\n\n\n## Language Support\n\nBigDataCloud APIs now offer Locality information in a number of languages.\nPlease see the example below for how to set the API language.\n[Click here For a list of all supported languages, and their respective codes.](https://www.bigdatacloud.com/support/what-are-the-supported-languages)\n\n\n\n## Authentication / Identification\n\nTo use this API client you must have a BigDataCloud API Key.\nTo get your personal key, please access your account and retrieve it from your [Account Dashboard](https://www.bigdatacloud.com/account).\nIf you are not yet a customer, it is completely free to join.\n\nProvide this key when initiating the api client, and it will be included in all requests to the BigDataCloud API Server.\nIf using the jQuery quick caller, you can provide the key in each request by appending the key parameter to the request payload.\nSee the examples below.\n\n\n\n## Manual Installation\n\n1. Download the included javascript file and place it in a publically accessible location\n2. Include the script tag `\u003cscript src=\"bigdatacloud_api_client.js\" type=\"text/javascript\"\u003e\u003c/script\u003e` before your code execution\n3. If using jQuery, include the script after the jQuery declaration\n4. Initiate the API Client and make the required calls\n\n\n\n## CDN Installation\n\n1. Include the CDN script tag `\u003cscript src=\"https://cdn.jsdelivr.net/gh/bigdatacloudapi/js-api-client@latest/bigdatacloud_api_client.min.js\" type=\"text/javascript\"\u003e\u003c/script\u003e` before your code execution\n2. If using jQuery, include the script after the jQuery declaration\n3. Initiate the API Client and make the required calls\n\n\n\n## Example usage\n\n```javascript\n\u003cscript src=\"https://cdn.jsdelivr.net/gh/bigdatacloudapi/js-api-client@latest/bigdatacloud_api_client.min.js\" type=\"text/javascript\"\u003e\u003c/script\u003e\n\u003cscript type=\"text/javascript\"\u003e\n\n\tvar apiKey='XXX'; // Your api key found at: https://www.bigdatacloud.com/account\n\n    //vanilla implementation\n    var client=new BDCApiClient(apiKey);\n\n    /* You can set the default api language as needed */\n    client.localityLanguage='es';\n\n    client.call(\n        /* api endpoint */\n        'ip-geolocation-full',\n\n        /* api query parameters */\n        {\n            'ip':'8.8.8.8',\n            /* You can override the default api language on a per-query basis\n            *  This is an optional parameter on all API calls */\n            'localityLanguage':'zh'\n        },\n        function(jsonResult) {\n            console.log('Vanilla result',jsonResult);\n        },\n        function(err,code) {\n            console.log('Vanilla error',err,code);\n        }\n    );\n\n\n    //jQuery implementation\n    if (typeof jQuery != 'undefined') {\n        (function($) {\n            $.BDCApi('ip-geolocation-full',{\n                data:{\n                    ip:'8.8.8.8',\n                    key:apiKey,\n                    localityLanguage:'en'\n                },\n                success:function(jsonResult) {\n                    console.log('jQuery result',jsonResult);\n                },\n                error:function(error,code) {\n                    console.error('jQuery eror',error,code);\n                }\n            });\n        })(jQuery);\n    }\n\n\u003c/script\u003e\n```\n\n\n## Example output\n\n```javascript\n{\n    \"ip\": \"8.8.8.8\",\n    \"country\": {\n        \"isoAlpha2\": \"US\",\n        \"isoAlpha3\": \"USA\",\n        \"m49Code\": 840,\n        \"isoName\": \"United States of America (the)\",\n        \"isoAdminLanguages\": [\n            {\n                \"isoAlpha3\": \"eng\",\n                \"isoAlpha2\": \"en\",\n                \"isoName\": \"English\"\n            }\n        ],\n        \"unRegion\": \"Americas/Northern America\",\n        \"currency\": {\n            \"numericCode\": 840,\n            \"code\": \"USD\",\n            \"name\": \"US Dollar\",\n            \"minorUnits\": 2\n        },\n        \"wbRegion\": {\n            \"id\": \"NAC\",\n            \"iso2Code\": \"XU\",\n            \"value\": \"North America\"\n        },\n        \"wbIncomeLevel\": {\n            \"id\": \"HIC\",\n            \"iso2Code\": \"XD\",\n            \"value\": \"High income\"\n        },\n        \"callingCode\": \"1\",\n        \"countryFlagEmoji\": \"🇺🇸\"\n    },\n    \"location\": {\n        \"isoPrincipalSubdivision\": \"California\",\n        \"isoPrincipalSubdivisionCode\": \"US-CA\",\n        \"city\": \"Mountain View\",\n        \"postcode\": \"94043\",\n        \"latitude\": 37.42,\n        \"longitude\": -122.09,\n        \"timeZone\": {\n            \"ianaTimeId\": \"America/Los_Angeles\",\n            \"displayName\": \"(UTC-08:00) Pacific Time (US \u0026 Canada)\",\n            \"effectiveTimeZoneFull\": \"Pacific Daylight Time\",\n            \"effectiveTimeZoneShort\": \"PDT\",\n            \"UtcOffsetSeconds\": -25200,\n            \"UtcOffset\": \"-07\",\n            \"isDaylightSavingTime\": true,\n            \"localTime\": \"2019-04-06T04:06:39.1691744\"\n        }\n    },\n    \"lastUpdated\": \"2019-04-06T09:09:36.1877959Z\",\n    \"network\": {\n        \"registry\": \"ARIN\",\n        \"registryStatus\": \"assigned\",\n        \"registeredCountry\": \"US\",\n        \"registeredCountryName\": \"United States of America (the)\",\n        \"organisation\": \"Google LLC\",\n        \"isReachableGlobally\": true,\n        \"isBogon\": false,\n        \"bgpPrefix\": \"8.8.8.0/24\",\n        \"bgpPrefixNetworkAddress\": \"8.8.8.0\",\n        \"bgpPrefixLastAddress\": \"8.8.8.255\",\n        \"totalAddresses\": 256,\n        \"carriers\": [\n            {\n                \"asn\": \"AS15169\",\n                \"asnNumeric\": 15169,\n                \"organisation\": \"Google LLC\",\n                \"name\": \"GOOGLE\",\n                \"registry\": \"ARIN\",\n                \"registeredCountry\": \"US\",\n                \"registeredCountryName\": \"United States of America (the)\",\n                \"registrationDate\": \"2000-03-30\",\n                \"registrationLastChange\": \"2012-02-25\",\n                \"totalIpv4Addresses\": 8698103,\n                \"totalIpv4Prefixes\": 435,\n                \"totalIpv4BogonPrefixes\": 0,\n                \"rank\": 53,\n                \"rankText\": \"#53 out of 62,872\"\n            }\n        ],\n        \"viaCarriers\": [\n            {\n                \"asn\": \"AS7018\",\n                \"asnNumeric\": 7018,\n                \"organisation\": \"ATT Services Inc.\",\n                \"registeredCountry\": \"US\",\n                \"registeredCountryName\": \"United States of America (the)\",\n                \"rank\": 2\n            },\n       \t\t/*........*/\n            {\n                \"asn\": \"AS31019\",\n                \"asnNumeric\": 31019,\n                \"organisation\": \"Paulus M. Hoogsteder trading as Meanie\",\n                \"registeredCountry\": \"NL\",\n                \"registeredCountryName\": \"Netherlands (the)\",\n                \"rank\": 51153\n            }\n        ]\n    },\n    \"confidence\": \"low\",\n    \"confidenceArea\": [\n        {\n            \"latitude\": 18.0256672,\n            \"longitude\": -66.5275345\n        },\n        /*........*/\n        {\n            \"latitude\": 18.0256672,\n            \"longitude\": -66.5275345\n        }\n    ],\n    \"securityThreat\": \"unknown\",\n    \"hazardReport\": {\n        \"isKnownAsTorServer\": false,\n        \"isKnownAsProxy\": false,\n        \"isKnownAsMailServer\": false,\n        \"isKnownAsPublicRouter\": false,\n        \"isBogon\": false,\n        \"isUnreachable\": false\n    }\n}\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigdatacloudapi%2Fjs-api-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbigdatacloudapi%2Fjs-api-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigdatacloudapi%2Fjs-api-client/lists"}