{"id":20706812,"url":"https://github.com/michael2to3/netlas-java","last_synced_at":"2025-05-10T20:30:59.269Z","repository":{"id":94990067,"uuid":"607489689","full_name":"michael2to3/netlas-java","owner":"michael2to3","description":"Netlas.io Java library","archived":true,"fork":false,"pushed_at":"2023-04-23T21:14:06.000Z","size":258,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-17T01:28:58.974Z","etag":null,"topics":["java","library","netlas","netlas-io","netlas-io-api","search","shodan"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/michael2to3.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":"2023-02-28T04:12:47.000Z","updated_at":"2024-10-08T17:31:55.000Z","dependencies_parsed_at":"2024-11-17T02:16:51.182Z","dependency_job_id":null,"html_url":"https://github.com/michael2to3/netlas-java","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michael2to3%2Fnetlas-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michael2to3%2Fnetlas-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michael2to3%2Fnetlas-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michael2to3%2Fnetlas-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/michael2to3","download_url":"https://codeload.github.com/michael2to3/netlas-java/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253480322,"owners_count":21915245,"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":["java","library","netlas","netlas-io","netlas-io-api","search","shodan"],"created_at":"2024-11-17T01:23:55.643Z","updated_at":"2025-05-10T20:30:59.262Z","avatar_url":"https://github.com/michael2to3.png","language":"Java","funding_links":[],"categories":["Java Search Automation Tools"],"sub_categories":[],"readme":"# Netlas Java Library\n\n[![GitHub license](https://img.shields.io/github/license/michael2to3/netlas-java)](https://github.com/michael2to3/netlas-java/blob/master/LICENSE)\n[![GitHub issues](https://img.shields.io/github/issues/michael2to3/netlas-java.svg)](https://GitHub.com/michael2to3/netlas-java/issues/)\n![Build Status](https://img.shields.io/github/actions/workflow/status/michael2to3/netlas-java/build.yml?branch=main)\n[![Codacy Badge](https://app.codacy.com/project/badge/Grade/db5aeb5920234d20a4951f85c9171e9d)](https://app.codacy.com/gh/michael2to3/netlas-java/dashboard?utm_source=gh\u0026utm_medium=referral\u0026utm_content=\u0026utm_campaign=Badge_grade)\n[![Codacy Badge](https://app.codacy.com/project/badge/Coverage/db5aeb5920234d20a4951f85c9171e9d)](https://app.codacy.com/gh/michael2to3/netlas-java/dashboard?utm_source=gh\u0026utm_medium=referral\u0026utm_content=\u0026utm_campaign=Badge_coverage)\n[![](https://jitpack.io/v/michael2to3/netlas-java.svg)](https://jitpack.io/#michael2to3/netlas-java)\n\nThis Java library is designed to interact with the Netlas API, allowing you to easily search for certificates, domains, and WHOIS information. It requires an API key, and makes use of the following dependencies:\n\n- [Gradle](https://gradle.org/) - for building and managing the project\n- [JUnit Jupiter](https://junit.org/) - for unit testing\n- [Fasterxml Jackson](https://fasterxml.github.io/jackson-databind/) - for JSON parsing\n- [OkHttp3](https://square.github.io/okhttp/) - for making HTTP requests\n\n## Installation\n\nTo use this library, you'll need to add it as a dependency to your Gradle project. You can do this by adding the following to your `build.gradle` file:\n\n```groovy\ndependencies {\n  implementation 'com.michael2to3:netlas:VERSION'\n}\n```\n\nReplace `VERSION` with the desired version of the library.\n\n## Usage\n\nFirst, create an instance of the `Netlas` class with your API key and the base URL of the Netlas API.\n\n```java\nNetlas netlas = new Netlas(\"YOUR_API_KEY\", \"https://api.netlas.io\");\n```\n\nOnce you have a `Netlas` instance, you can use its methods to search for information:\n\n```java\n// Search for certificate information\nnetlas.java.scheme.Response response = netlas.search(\"example.com\", DataType.CERT, 1, null, null, false);\n\n// Search for domain information\nnetlas.java.scheme.Response response = netlas.search(\"example.com\", DataType.DOMAIN, 1, null, null, false);\n\n// Search for WHOIS information for an IP address\nnetlas.java.scheme.Response response = netlas.search(\"8.8.8.8\", DataType.WHOIS_IP, 1, null, null, false);\n\n// Search for WHOIS information for a domain\nnetlas.java.scheme.Response response = netlas.search(\"example.com\", DataType.WHOIS_DOMAIN, 1, null, null, false);\n```\n\n## Testing\n\nThis library includes unit tests using JUnit Jupiter. You can run the tests by executing the following Gradle command:\n\n```bash\n./gradlew test\n```\n\n## Exceptions\n\nThis library throws a `NetlasRequestException` when an error occurs while sending an HTTP request. You should handle this exception appropriately in your code.\n\n## License\n\nThis project is licensed under the License - see the [LICENSE](https://github.com/michael2to3/netlas-java/blob/master/LICENSE) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichael2to3%2Fnetlas-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmichael2to3%2Fnetlas-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichael2to3%2Fnetlas-java/lists"}