{"id":18251785,"url":"https://github.com/hiroakis/sendgrid-reporter","last_synced_at":"2025-08-22T18:03:11.091Z","repository":{"id":33681885,"uuid":"37334642","full_name":"hiroakis/sendgrid-reporter","owner":"hiroakis","description":null,"archived":false,"fork":false,"pushed_at":"2015-06-12T17:38:30.000Z","size":91,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-14T16:39:44.619Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hiroakis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-06-12T17:15:54.000Z","updated_at":"2015-06-13T10:10:10.000Z","dependencies_parsed_at":"2022-09-13T17:22:07.680Z","dependency_job_id":null,"html_url":"https://github.com/hiroakis/sendgrid-reporter","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiroakis%2Fsendgrid-reporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiroakis%2Fsendgrid-reporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiroakis%2Fsendgrid-reporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiroakis%2Fsendgrid-reporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hiroakis","download_url":"https://codeload.github.com/hiroakis/sendgrid-reporter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247927089,"owners_count":21019504,"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":[],"created_at":"2024-11-05T09:48:29.767Z","updated_at":"2025-04-08T20:46:48.307Z","avatar_url":"https://github.com/hiroakis.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# sendgrid-reporter\n\nA comman-line tool to get sendgrid statistics using [sendgrid web api](https://sendgrid.com/docs/API_Reference/index.html).\n\n## Installation\n\n```\ngo get github.com/hiroakis/sendgrid-reporter\n```\n\n## Usage\n\n* prepare\n\nSet ENV of sendgrid user and key\n\n```\nexport SENDGRID_API_USER=XXXXX@kke.com\nexport SENDGRID_API_KEY=XXXXXXXXXXXX\n```\n\n### Basic\n\n* show general statistics\n\n```\nsendgrid-reporter stat\n```\n\n* show bounced mail\n\n```\nsendgrid-reporter bounce\n```\n\n* show blocked mail\n\n```\nsendgrid-reporter block\n```\n\n* show invalid mail\n\n```\nsendgrid-reporter invalid\n```\n\n* show spam report\n\n```\nsendgrid-reporter spam\n```\n\n### Using options\n\n* -s: \"The start of the date range for which to retrieve invalid emails. Date must be in YYYY-MM-DD format. Default: Today's date\"\n* -e: \"The end of the date range for which to retrieve invalid emails. Date must be in YYYY-MM-DD format. Default: Today's date\"\n* -d: \"Number of days in the past for which to retrieve invalid emails (includes today).\"\n* -l: \"Optional field to limit the number of results returned.\"\n* -o: \"Optional beginning point in the list to retrieve from.\"\n* -t: \"Hard or Soft. Choose the type of bounce to search for.\"\n* -email: \"Optional email to search.\"\n\n### Pretty print\n\nUse [jq](http://stedolan.github.io/jq/). The following is a example.\n\n```\nsendgrid-reporter -s 2015-06-12 stat | jq .\n[\n  {\n    \"delivered\": 3777,\n    \"unsubscribes\": 0,\n    \"repeat_bounces\": 49,\n    \"invalid_domain\": 0,\n    \"invalid_email\": 47,\n    \"bounces\": 27,\n    \"repeat_unsubscribes\": 0,\n    \"unique_clicks\": 0,\n    \"blocked\": 6,\n    \"spam_drop\": 0,\n    \"opens\": 0,\n    \"repeat_spamreports\": 0,\n    \"replies\": 0,\n    \"date\": \"2015-06-12\",\n    \"requests\": 3904,\n    \"spamreports\": 0,\n    \"clicks\": 0,\n    \"umd_drop\": 0,\n    \"unique_opens\": 0\n  },\n  {\n    \"delivered\": 157,\n    \"unsubscribes\": 0,\n    \"repeat_bounces\": 0,\n    \"invalid_domain\": 0,\n    \"invalid_email\": 1,\n    \"bounces\": 3,\n    \"repeat_unsubscribes\": 0,\n    \"unique_clicks\": 0,\n    \"blocked\": 0,\n    \"spam_drop\": 0,\n    \"opens\": 0,\n    \"repeat_spamreports\": 0,\n    \"replies\": 0,\n    \"date\": \"2015-06-13\",\n    \"requests\": 161,\n    \"spamreports\": 0,\n    \"clicks\": 0,\n    \"umd_drop\": 0,\n    \"unique_opens\": 0\n  }\n]\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhiroakis%2Fsendgrid-reporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhiroakis%2Fsendgrid-reporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhiroakis%2Fsendgrid-reporter/lists"}