{"id":24211185,"url":"https://github.com/ipdata/java","last_synced_at":"2025-10-04T12:07:32.155Z","repository":{"id":57716284,"uuid":"236467949","full_name":"ipdata/java","owner":"ipdata","description":"Official Java client library for the ipdata API","archived":false,"fork":false,"pushed_at":"2020-10-13T19:10:27.000Z","size":119,"stargazers_count":2,"open_issues_count":4,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-09-22T03:46:55.295Z","etag":null,"topics":["api-client","ipdata"],"latest_commit_sha":null,"homepage":"https://ipdata.co","language":"Java","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/ipdata.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}},"created_at":"2020-01-27T10:39:22.000Z","updated_at":"2025-06-14T08:44:17.000Z","dependencies_parsed_at":"2022-09-14T11:20:52.299Z","dependency_job_id":null,"html_url":"https://github.com/ipdata/java","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/ipdata/java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipdata%2Fjava","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipdata%2Fjava/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipdata%2Fjava/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipdata%2Fjava/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ipdata","download_url":"https://codeload.github.com/ipdata/java/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipdata%2Fjava/sbom","scorecard":{"id":493620,"data":{"date":"2025-08-11","repo":{"name":"github.com/ipdata/java","commit":"af781298bc9673ed24828eb26f17453ef037c246"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.6,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Code-Review","score":0,"reason":"Found 0/24 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":10,"reason":"SAST tool detected","details":["Info: SAST configuration detected: Sonar","Warn: 0 commits out of 9 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"60 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-h46c-h94j-95f3","Warn: Project is vulnerable to: GHSA-wf8f-6423-gfxg","Warn: Project is vulnerable to: GHSA-288c-cq4h-88gq","Warn: Project is vulnerable to: GHSA-4gq5-ch57-c2mg","Warn: Project is vulnerable to: GHSA-4w82-r329-3q67","Warn: Project is vulnerable to: GHSA-57j2-w4cx-62h2","Warn: Project is vulnerable to: GHSA-5949-rw7g-wx7w","Warn: Project is vulnerable to: GHSA-5r5r-6hpj-8gg9","Warn: Project is vulnerable to: GHSA-5ww9-j83m-q7qx","Warn: Project is vulnerable to: GHSA-645p-88qh-w398","Warn: Project is vulnerable to: GHSA-6fpp-rgj9-8rwc","Warn: Project is vulnerable to: GHSA-85cw-hj65-qqv9","Warn: Project is vulnerable to: GHSA-89qr-369f-5m5x","Warn: Project is vulnerable to: GHSA-8c4j-34r4-xr8g","Warn: Project is vulnerable to: GHSA-8w26-6f25-cm9x","Warn: Project is vulnerable to: GHSA-9gph-22xh-8x98","Warn: Project is vulnerable to: GHSA-9m6f-7xcq-8vf8","Warn: Project is vulnerable to: GHSA-c8hm-7hpq-7jhg","Warn: Project is vulnerable to: GHSA-cf6r-3wgc-h863","Warn: Project is vulnerable to: GHSA-cggj-fvv3-cqwv","Warn: Project is vulnerable to: GHSA-cjjf-94ff-43w7","Warn: Project is vulnerable to: GHSA-cmfg-87vq-g5g4","Warn: Project is vulnerable to: GHSA-cvm9-fjm9-3572","Warn: Project is vulnerable to: GHSA-f3j5-rmmp-3fc5","Warn: Project is vulnerable to: GHSA-f9xh-2qgp-cq57","Warn: Project is vulnerable to: GHSA-fmmc-742q-jg75","Warn: Project is vulnerable to: GHSA-fqwf-pjwf-7vqv","Warn: Project is vulnerable to: GHSA-gjmw-vf9h-g25v","Warn: Project is vulnerable to: GHSA-gwp4-hfv6-p7hw","Warn: Project is vulnerable to: GHSA-gww7-p5w4-wrfv","Warn: Project is vulnerable to: GHSA-h3cw-g4mq-c5x2","Warn: Project is vulnerable to: GHSA-h592-38cm-4ggp","Warn: Project is vulnerable to: GHSA-h822-r4r5-v8jg","Warn: Project is vulnerable to: GHSA-jjjh-jjxp-wpff","Warn: Project is vulnerable to: GHSA-m6x4-97wx-4q27","Warn: Project is vulnerable to: GHSA-mph4-vhrx-mv67","Warn: Project is vulnerable to: GHSA-mx7p-6679-8g3q","Warn: Project is vulnerable to: GHSA-p43x-xfjf-5jhr","Warn: Project is vulnerable to: GHSA-q93h-jc49-78gg","Warn: Project is vulnerable to: GHSA-qjw2-hr98-qgfh","Warn: Project is vulnerable to: GHSA-qr7j-h6gg-jmgc","Warn: Project is vulnerable to: GHSA-qxxx-2pp7-5hmx","Warn: Project is vulnerable to: GHSA-r3gr-cxrf-hg25","Warn: Project is vulnerable to: GHSA-r695-7vr9-jgc2","Warn: Project is vulnerable to: GHSA-rfx6-vp9g-rh7v","Warn: Project is vulnerable to: GHSA-rgv9-q543-rqg4","Warn: Project is vulnerable to: GHSA-rpr3-cw39-3pxh","Warn: Project is vulnerable to: GHSA-v585-23hc-c647","Warn: Project is vulnerable to: GHSA-vfqx-33qm-g869","Warn: Project is vulnerable to: GHSA-w3f4-3q6j-rh82","Warn: Project is vulnerable to: GHSA-wh8g-3j2c-rqj5","Warn: Project is vulnerable to: GHSA-5mg8-w23w-74h3","Warn: Project is vulnerable to: GHSA-7g45-4rm6-3mm3","Warn: Project is vulnerable to: GHSA-mvr2-9pj6-7w5j","Warn: Project is vulnerable to: GHSA-2qrg-x229-3v8q","Warn: Project is vulnerable to: GHSA-65fg-84f6-3jq3","Warn: Project is vulnerable to: GHSA-f7vh-qwp3-x37m","Warn: Project is vulnerable to: GHSA-fp5r-v3w9-4333","Warn: Project is vulnerable to: GHSA-w9p3-5cr8-m3jj","Warn: Project is vulnerable to: GHSA-7r82-7xv7-xcpj"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-19T19:52:29.978Z","repository_id":57716284,"created_at":"2025-08-19T19:52:29.979Z","updated_at":"2025-08-19T19:52:29.979Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278308756,"owners_count":25965694,"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-10-04T02:00:05.491Z","response_time":63,"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-client","ipdata"],"created_at":"2025-01-14T02:19:56.821Z","updated_at":"2025-10-04T12:07:32.123Z","avatar_url":"https://github.com/ipdata.png","language":"Java","readme":"# ipdata-java-client\n![Build Status](https://www.travis-ci.org/yassine/ipdata-java-client.svg?branch=master)\n[![Coverage Status](https://sonarcloud.io/api/project_badges/measure?metric=coverage\u0026project=yassine_ipdata-java-client)](https://sonarcloud.io/dashboard/index/yassine_ipdata-java-client)\n[![Quality Gate](https://sonarcloud.io/api/project_badges/measure?metric=alert_status\u0026project=yassine_ipdata-java-client)](https://sonarcloud.io/dashboard/index/yassine_ipdata-java-client)\n[![Maintainability](https://sonarcloud.io/api/project_badges/measure?metric=sqale_rating\u0026project=yassine_ipdata-java-client)](https://sonarcloud.io/dashboard/index/yassine_ipdata-java-client)\n[![Reliability](https://sonarcloud.io/api/project_badges/measure?metric=reliability_rating\u0026project=yassine_ipdata-java-client)](https://sonarcloud.io/dashboard/index/yassine_ipdata-java-client)\n\n\nAn 100% compliant [ipdata.co](https://ipdata.co) API java client.\n\n**Table of Contents**\n\n- [Install](#install)\n- [Use](#use)\n  - [Configuration](#configuration)\n  - [API](#create-an-instance)\n    - [Basic Usage](#basic-usage)\n    - [Single Field Selection](#single-field-selection)\n    - [Multiple Field Selection](#multiple-field-selection)\n    - [Bulk data](#bulk-data)\n  \n\n## Install\nYou can have the library from Maven Central.\n```\n\u003cdependency\u003e\n    \u003cgroupId\u003eco.ipdata.client\u003c/groupId\u003e\n    \u003cartifactId\u003eipdata-java-client\u003c/artifactId\u003e\n    \u003cversion\u003e0.2.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## Use\n\n### Configuration\nA builder is available to help configure your client configuration, you'll have to provide the API endpoint and an [API key](https://ipdata.co/pricing.html):\n```java\nimport io.ipdata.client.Ipdata;\n\n/.../\nURL url = new URL(\"https://api.ipdata.co\");\nIpdataService ipdataService = Ipdata.builder().url(url)\n      .key(\"MY_KEY\").get();\n/.../\n```\nOptionally, you can configure a cache for faster access (less than 1ms latency on requests that hit the cache). \n\nThe cache is configurable for time and space eviction policies:\n\n```java\nURL url = new URL(\"https://api.ipdata.co\");\nIpdataService ipdataService = Ipdata.builder().url(url)\n      .withCache()\n        .timeout(30, TimeUnit.MINUTES) //ttl after first write\n        .maxSize(8 * 1024) //no more than 8*1024 items shall be stored in cache\n        .registerCacheConfig()\n      .key(\"MY_KEY\")\n      .get();\nIpdataModel model = ipdataService.ipdata(\"1.1.1.1\"); //cache miss here\nipdataService.ipdata(\"1.1.1.1\"); //cache hit from now on on ip address \"1.1.1.1\"\n```\n\n### API\nThe client is fully compliant with the API. The data model of the api is available under the package ``io.ipdata.client.model``.\nInteraction with the API is captured by the Service Interface ``io.ipdata.client.service.IpdataService``:\n\n#### Basic Usage\nTo get all available information about a given IP address, you can use the ``ipdata`` method of the service Interface:\n```java\nIpdataModel model = ipdataService.ipdata(\"1.1.1.1\");\nSystem.out.println(jsonSerialize(model));\n```\n\nOutput:\n```json\n{\n    \"ip\": \"1.1.1.1\",\n    \"is_eu\": false,\n    \"city\": null,\n    \"region\": null,\n    \"region_code\": null,\n    \"country_name\": \"Australia\",\n    \"country_code\": \"AU\",\n    \"continent_name\": \"Oceania\",\n    \"continent_code\": \"OC\",\n    \"latitude\": -33.494,\n    \"longitude\": 143.2104,\n    \"postal\": null,\n    \"calling_code\": \"61\",\n    \"flag\": \"https://ipdata.co/flags/au.png\",\n    \"emoji_flag\": \"\\ud83c\\udde6\\ud83c\\uddfa\",\n    \"emoji_unicode\": \"U+1F1E6 U+1F1FA\",\n    \"asn\": {\n        \"asn\": \"AS13335\",\n        \"name\": \"Cloudflare, Inc.\",\n        \"domain\": \"cloudflare.com\",\n        \"route\": \"1.1.1.0/24\",\n        \"type\": \"hosting\"\n    },\n    \"languages\": [\n        {\n            \"name\": \"English\",\n            \"native\": \"English\"\n        }\n    ],\n    \"currency\": {\n        \"name\": \"Australian Dollar\",\n        \"code\": \"AUD\",\n        \"symbol\": \"AU$\",\n        \"native\": \"$\",\n        \"plural\": \"Australian dollars\"\n    },\n    \"time_zone\": {\n        \"name\": \"Australia/Sydney\",\n        \"abbr\": \"AEDT\",\n        \"offset\": \"+1100\",\n        \"is_dst\": true,\n        \"current_time\": \"2020-01-29T20:22:52.283874+11:00\"\n    },\n    \"threat\": {\n        \"is_tor\": false,\n        \"is_proxy\": false,\n        \"is_anonymous\": false,\n        \"is_known_attacker\": false,\n        \"is_known_abuser\": false,\n        \"is_threat\": false,\n        \"is_bogon\": false\n    },\n    \"count\": \"0\"\n}\n```\n\n#### Single Field Selection\nIf you're interested in only one field from the model capturing an IP address information, The service interface\nexposes a method on each available field:\n\n```java\nboolean isEu = ipdataService.isEu(\"1.1.1.1\");\nAsnModel asn = ipdataService.asn(\"1.1.1.1\");\nTimeZone tz  = ipdataService.timeZone(\"1.1.1.1\");\nThreatModel threat = ipdataService.threat(\"1.1.1.1\");\n/*...*/\n```\nThe list of available fields is available [here](https://docs.ipdata.co/api-reference/response-fields)\n\n#### Multiple Field Selection\nIf you're interested in multiple fields for a given IP address, you'll use the ``getFields`` method:\n```java\nimport io.ipdata.client.service.IpdataField;\nimport io.ipdata.client.service.IpdataService;\n\n/* The model will be hydrated by the selected fields only */\nIpdataModel model = ipdataService.getFields(\"1.1.1.1\", IpdataField.ASN, IpdataField.CURRENCY);\n\n```\n\n### Bulk data\nYou can as well get multiple responses at once by using the ``bulk`` api:\n\n```java\nList\u003cIpdataModel\u003e models = ipdataService.bulk(Arrays.asList(\"1.1.1.1\", \"8.8.8.8\"));\n```\n\n\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fipdata%2Fjava","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fipdata%2Fjava","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fipdata%2Fjava/lists"}