{"id":22388314,"url":"https://github.com/google-marketing-solutions/topic-mine","last_synced_at":"2025-07-01T12:03:45.159Z","repository":{"id":238739944,"uuid":"709927909","full_name":"google-marketing-solutions/topic-mine","owner":"google-marketing-solutions","description":"Topic Mine leverages 1st and/or 2nd party data to identify trending topics and uses our GEMINI to create relevant ads' texts. It generates headlines, descriptions and keywords given a list of products, brands or services and (optionally) additional info about them. ","archived":false,"fork":false,"pushed_at":"2025-05-16T06:39:05.000Z","size":1505,"stargazers_count":18,"open_issues_count":14,"forks_count":6,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-07-01T12:03:02.717Z","etag":null,"topics":["analytics","gemini","google-analytics-4","google-trends","trends"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/google-marketing-solutions.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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":"2023-10-25T17:10:21.000Z","updated_at":"2025-05-20T15:47:34.000Z","dependencies_parsed_at":"2024-08-29T21:33:17.538Z","dependency_job_id":"edac7ba6-2db2-4f25-8998-36abfb69a869","html_url":"https://github.com/google-marketing-solutions/topic-mine","commit_stats":null,"previous_names":["google-marketing-solutions/topic-mine"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/google-marketing-solutions/topic-mine","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google-marketing-solutions%2Ftopic-mine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google-marketing-solutions%2Ftopic-mine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google-marketing-solutions%2Ftopic-mine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google-marketing-solutions%2Ftopic-mine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/google-marketing-solutions","download_url":"https://codeload.github.com/google-marketing-solutions/topic-mine/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google-marketing-solutions%2Ftopic-mine/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262959563,"owners_count":23391057,"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":["analytics","gemini","google-analytics-4","google-trends","trends"],"created_at":"2024-12-05T02:13:06.763Z","updated_at":"2025-07-01T12:03:45.026Z","avatar_url":"https://github.com/google-marketing-solutions.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\n Copyright 2023 Google LLC\n\n Licensed under the Apache License, Version 2.0 (the \"License\");\n you may not use this file except in compliance with the License.\n You may obtain a copy of the License at\n\n      https://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing, software\n distributed under the License is distributed on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n See the License for the specific language governing permissions and\n limitations under the License.\n --\u003e\n\n# Topic Mine\n\nTopic Mine is a Google Open Source project that generates ad content for Search Ads and, in some cases, Display Ads, and that can be directly imported to Google Ads, Search Ads 360 and DV360.\n\nTopic Mine leverages 1st and/or 2nd party data to identify trending topics and uses our GEMINI to create relevant ads' texts. It generates headlines, descriptions and keywords given a list of products, brands or services and (optionally) additional info about them.\n\n\u003cimg width=\"1164\" alt=\"Screenshot 2024-11-21 at 10 01 56 AM\" src=\"https://github.com/user-attachments/assets/bd192502-bfe0-420a-bff4-8f0e18f82446\"\u003e\n\n## Operating modes\n\n1. Internal trends: if the client identifies trending topics on their own (e.g.: trending products being purchased on their site, top search terms this week, etc.), Topic Mine takes these trending topics and generate ads' content for them. Clients usually identify trends with Google Analytics (GA4) data on their site. In this case, the input is literally a list of terms and [optionally] their descriptions or extra info about them.\n\n2. External trends: if the client has a fixed list of products, brands or services they want to advertice (might be, for example, a category of products in particular), Topic Mine will take that list and try to find a relationship between each item and trending topics obtained from an external source. If there is a relationship between what the client offers and some trending topic, it will create ads' content for that.\n\n## Benefits\n\n- Always stay relevant to what is trending at the moment\n- Generate ad content in bulk, saving lots of time in the creative process (clients say it takes 10x less time to do the same tasks)\n- Obtain creative ideas for your ads\n- Significantly reduce campaign production time\n- Increased ROAS (about 4:1)\n- Super cheap (between 2-4 USD / month if running once per week)\n- Super easy to install\n\n## Requirements\n\n- A Google Cloud Platform project with a billing account\n- A list of products, brands or services.\n- (Optional) A list of trending topics or other terms to associate with\n- Someone to validate the content generated by Gemini\n\n\n## Docs\n\nTechnical documentation and detailed instructions on how to configure and deploy can be found [here](https://github.com/google-marketing-solutions/topic-mine/wiki).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogle-marketing-solutions%2Ftopic-mine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoogle-marketing-solutions%2Ftopic-mine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogle-marketing-solutions%2Ftopic-mine/lists"}