{"id":18576557,"url":"https://github.com/bigdatacloudapi/js-client-info-client","last_synced_at":"2025-04-10T08:31:20.217Z","repository":{"id":194440906,"uuid":"213784935","full_name":"bigdatacloudapi/js-client-info-client","owner":"bigdatacloudapi","description":"A Javascript client for fetching information about a fronted user","archived":false,"fork":false,"pushed_at":"2023-09-13T02:01:16.000Z","size":6,"stargazers_count":6,"open_issues_count":0,"forks_count":10,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-24T19:05:52.516Z","etag":null,"topics":["api","ip-geolocation","ipinfo","javascript"],"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}},"created_at":"2019-10-09T00:38:47.000Z","updated_at":"2023-01-10T00:17:34.000Z","dependencies_parsed_at":"2023-09-13T10:36:35.559Z","dependency_job_id":null,"html_url":"https://github.com/bigdatacloudapi/js-client-info-client","commit_stats":null,"previous_names":["bigdatacloudapi/js-client-info-client"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigdatacloudapi%2Fjs-client-info-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigdatacloudapi%2Fjs-client-info-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigdatacloudapi%2Fjs-client-info-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigdatacloudapi%2Fjs-client-info-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bigdatacloudapi","download_url":"https://codeload.github.com/bigdatacloudapi/js-client-info-client/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248185411,"owners_count":21061509,"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","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","ip-geolocation","ipinfo","javascript"],"created_at":"2024-11-06T23:25:24.385Z","updated_at":"2025-04-10T08:31:19.952Z","avatar_url":"https://github.com/bigdatacloudapi.png","language":"JavaScript","readme":"# BigDataCloud Free Client Info API Client\n\n\nA Javascript client for fetching information about a fronted user [BigDataCloud](https://www.bigdatacloud.com)\nThis client works without any Javascript dependencies and has no API key or account requirement... Simply load it up and you're ready to fetch information about your frontend users.\n\n## Documentation\n\nDocumentation specific to this Free API Client is detailed below.\nFor more information about the API, please visit [FREE Client Info API](https://www.bigdatacloud.com/free-api/client-info-api).\n\n\n\n## Authentication / Identification\n\nThere is no authentication or identification required to use this API or client.\nYou may use this API and client for Free without an account.\n\n\n\n## Usage Limits\n\nThis client-side API is completely FREE for both commercial and non-commercial use, including unlimited usage with no throttling or limitations.\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_client_info.js\" type=\"text/javascript\"\u003e\u003c/script\u003e` before your code execution\n3. Initiate the Client Info API Client as per the below example\n\n\n\n## CDN Installation\n\n1. Include the CDN script tag `\u003cscript src=\"https://cdn.jsdelivr.net/gh/bigdatacloudapi/js-client-info-client@latest/bigdatacloud_client_info.min.js\" type=\"text/javascript\"\u003e\u003c/script\u003e` before your code execution\n2. Initiate the API Client and make the required calls as necessary\n\n\n\n## Example usage\n\n```javascript\n\u003cscript src=\"https://cdn.jsdelivr.net/gh/bigdatacloudapi/js-client-info-client@latest/bigdatacloud_client_info.min.js\" type=\"text/javascript\"\u003e\u003c/script\u003e\n\u003cscript type=\"text/javascript\"\u003e\n\n    getBDCClientInfo(\n        /* provide a callback function for client info result */\n        function(result) {\n            console.log(result);\n        }\n    );\n\n\u003c/script\u003e\n```\n\n\n## Example output\n\n```javascript\n{\n    \"ipString\": \"8.8.8.8\",\n    \"ipNumeric\": 134744072,\n    \"ipType\": \"IPv4\",\n    \"isBehindProxy\": false,\n    \"device\": \"Desktop\",\n    \"os\": \"Windows 10\",\n    \"userAgent\": \"Chrome 76.0.3809\",\n    \"family\": \"Chrome\",\n    \"versionMajor\": \"76\",\n    \"versionMinor\": \"0\",\n    \"versionPatch\": \"3809\",\n    \"isSpider\": false,\n    \"userAgentDisplay\": \"Windows 10 Desktop Chrome 76.0.3809\",\n    \"userAgentRaw\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/76.0.3809.132 Safari/537.36\",\n    \"userLanguages\": [\"en-US\", \"en\"]\n}\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigdatacloudapi%2Fjs-client-info-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbigdatacloudapi%2Fjs-client-info-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigdatacloudapi%2Fjs-client-info-client/lists"}