{"id":20216672,"url":"https://github.com/intelowlproject/go-intelowl","last_synced_at":"2026-03-18T01:04:16.418Z","repository":{"id":37468222,"uuid":"334662588","full_name":"intelowlproject/go-intelowl","owner":"intelowlproject","description":"IntelOwl's client library/SDK in golang.","archived":false,"fork":false,"pushed_at":"2025-05-06T23:34:22.000Z","size":156,"stargazers_count":23,"open_issues_count":9,"forks_count":13,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-10-17T07:03:31.929Z","etag":null,"topics":["golang","intelowl","intelowl-api","threat-hunting","threat-intelligence"],"latest_commit_sha":null,"homepage":"https://pkg.go.dev/github.com/intelowlproject/go-intelowl","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/intelowlproject.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,"zenodo":null}},"created_at":"2021-01-31T13:32:31.000Z","updated_at":"2025-06-28T02:52:53.000Z","dependencies_parsed_at":"2025-05-16T11:41:17.326Z","dependency_job_id":null,"html_url":"https://github.com/intelowlproject/go-intelowl","commit_stats":{"total_commits":30,"total_committers":6,"mean_commits":5.0,"dds":"0.33333333333333337","last_synced_commit":"a75415acce5b55ac1275373fc70248d250dcdf60"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/intelowlproject/go-intelowl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intelowlproject%2Fgo-intelowl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intelowlproject%2Fgo-intelowl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intelowlproject%2Fgo-intelowl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intelowlproject%2Fgo-intelowl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/intelowlproject","download_url":"https://codeload.github.com/intelowlproject/go-intelowl/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intelowlproject%2Fgo-intelowl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30638906,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-18T00:09:27.587Z","status":"ssl_error","status_checked_at":"2026-03-18T00:09:26.123Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["golang","intelowl","intelowl-api","threat-hunting","threat-intelligence"],"created_at":"2024-11-14T06:29:12.470Z","updated_at":"2026-03-18T01:04:16.387Z","avatar_url":"https://github.com/intelowlproject.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# go-intelowl\n[![GitHub issues](https://img.shields.io/github/issues/intelowlproject/go-intelowl?style=plastic)](https://github.com/intelowlproject/go-intelowl/issues)\n[![GitHub license](https://img.shields.io/github/license/intelowlproject/go-intelowl?style=plastic)](https://github.com/intelowlproject/go-intelowl/blob/main/LICENSE)\n\n![go-banner](./Banner.png)\ngo-intelowl is a client library/SDK that allows developers to easily automate and integrate [IntelOwl](https://github.com/intelowlproject/IntelOwl) with their own set of tools!\n\n\u003c!-- omit in toc --\u003e\n# Table of Contents\n- [go-intelowl](#go-intelowl)\n- [Getting Started](#getting-started)\n\t- [Pre requisites](#pre-requisites)\n\t- [Installation](#installation)\n\t- [Usage](#usage)\n\t- [Examples](#examples)\n- [Contribute](#contribute)\n- [License](#liscence)\n- [Links](#links)\n- [FAQ](#faq)\n\t- [Generate API key](#generate-api-key)\n\t\t- [v4.0 and above](#v40-and-above)\n\t\t- [v4.0 below](#v40-below)\n\n\n\n# Getting Started\n\n## Pre requisites\n- Go 1.17+\n\n## Installation\nUse go get to retrieve the SDK to add it to your GOPATH workspace, or project's Go module dependencies.\n\n```bash\n$ go get github.com/intelowlproject/go-intelowl\n```\n\n## Usage\nThis library was built with ease of use in mind! Here are some quick examples to get you started. If you need more example you can go to the [examples directory](./examples/)\n\nTo start using the go-intelowl library you first need to import it:\n```\nimport \"github.com/intelowlproject/go-intelowl/gointelowl\"\n```\nConstruct a new `IntelOwlClient`, then use the various services to easily access different parts of Intelowl's REST API. Here's an example of getting all jobs:\n\n```Go\nclientOptions := gointelowl.IntelOwlClientOptions{\n\tUrl:         \"your-cool-URL-goes-here\",\n\tToken:       \"your-super-secret-token-goes-here\",\n\t// This is optional\n\tCertificate: \"your-optional-certificate-goes-here\",\n}\n\nintelowl := gointelowl.NewIntelOwlClient(\n\t\u0026clientOptions,\n\tnil\n)\n\nctx := context.Background()\n\n// returns *[]Jobs or an IntelOwlError!\njobs, err := intelowl.JobService.List(ctx)\n```\nFor easy configuration and set up we opted for `options` structs. Where we can customize the client API or service endpoint to our liking! For more information go [here](). Here's a quick example!\n\n```Go\n// ...Making the client and context!\n\ntagOptions = gointelowl.TagParams{\n  Label: \"NEW TAG\",\n  Color: \"#ffb703\",\n}\n\ncreatedTag, err := intelowl.TagService.Create(ctx, tagOptions)\nif err != nil {\n\tfmt.Println(err)\n} else {\n\tfmt.Println(createdTag)\n}\n```\n## Examples\nThe [examples](./examples/) directory contains a couple for clear examples, of which one is partially listed here as well:\n\n```Go\npackage main\n\nimport (\n\t\"fmt\"\n\n\t\"github.com/intelowlproject/go-intelowl/gointelowl\"\n)\n\nfunc main(){\n\tintelowlOptions := gointelowl.IntelOwlClientOptions{\n\t\tUrl:         \"your-cool-url-goes-here\",\n\t\tToken:       \"your-super-secret-token-goes-here\",\n\t\tCertificate: \"your-optional-certificate-goes-here\",\n\t}\t\n\n\tclient := gointelowl.NewIntelOwlClient(\n\t\t\u0026intelowlOptions,\n\t\tnil,\n\t)\n\n\tctx := context.Background()\n\n\t// Get User details!\n\tuser, err := client.UserService.Access(ctx)\n\tif err != nil {\n\t\tfmt.Println(\"err\")\n\t\tfmt.Println(err)\n\t} else {\n\t\tfmt.Println(\"USER Details\")\n\t\tfmt.Println(*user)\n\t}\n}\n\n```\nFor complete usage of go-intelowl, see the full [package docs](https://pkg.go.dev/github.com/intelowlproject/go-intelowl).\n\n# Contribute\nIf you want to follow the updates, discuss, contribute, or just chat then please join our [slack](https://honeynetpublic.slack.com/archives/C01KVGMAKL6) channel we'd love to hear your feedback!\n\n# License\nLicensed under the GNU AFFERO GENERAL PUBLIC LICENSE.\n\n# Links\n- [Intelowl](https://github.com/intelowlproject/IntelOwl)\n- [Documentation](https://intelowlproject.github.io/docs/)\n- [API documentation](https://intelowlproject.github.io/docs/IntelOwl/api_docs/)\n- [Examples](./examples/)\n\n# FAQ\n## Generate API key\nYou need a valid API key to interact with the IntelOwl server.\n### v4.0 and above\nYou can get an API by doing the following:\n1. Log / Signin into intelowl\n2. At the upper right click on your profile from the drop down select `API Access/ Sessions`\n3. Then generate an API key or see it!\n\n### v4.0 below\nKeys should be created from the admin interface of [IntelOwl](https://github.com/intelowlproject/intelowl): you have to go in the *Durin* section (click on `Auth tokens`) and generate a key there.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fintelowlproject%2Fgo-intelowl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fintelowlproject%2Fgo-intelowl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fintelowlproject%2Fgo-intelowl/lists"}