{"id":20904,"library":"advertools","title":"Advertools","description":"Advertools is a Python library for digital marketing and SEO analysis, providing tools for keyword research, spider simulations, social media analysis, and more. Current version: 0.17.2, released irregularly.","status":"active","version":"0.17.2","language":"python","source_language":"en","source_url":"https://github.com/eliasdabbas/advertools","tags":["seo","digital-marketing","keyword-research","google-ads","web-scraping","social-media"],"install":[{"cmd":"pip install advertools","lang":"bash","label":"Standard install"}],"dependencies":[{"reason":"Data manipulation and analysis","package":"pandas","optional":false},{"reason":"HTTP requests","package":"requests","optional":false},{"reason":"XML/HTML parsing","package":"lxml","optional":false},{"reason":"Web scraping","package":"beautifulsoup4","optional":false},{"reason":"Machine learning support","package":"scikit-learn","optional":true}],"imports":[{"note":"Using wildcard imports is discouraged; use 'import advertools as adv' for clarity.","wrong":"from advertools import *","symbol":"advertools","correct":"import advertools as adv"},{"note":"ad_create is a function, not a submodule; wrong import leads to ModuleNotFoundError.","wrong":"import advertools.ad_create","symbol":"advertools.ad_create","correct":"from advertools import ad_create"}],"quickstart":{"code":"import advertools as adv\n\n# Generate keywords from a seed list\nseed_words = ['shoes', 'boots']\nkeywords = adv.generate_google_keywords(seed_words)\nprint(keywords.head())","lang":"python","description":"Generates keyword permutations for Google Ads using seed words."},"warnings":[{"fix":"Replace serp.googlesearch with serp.serp_goog.","message":"Function 'advertools.serp.googlesearch' is deprecated in v0.17.0. Use 'advertools.serp.serp_goog' instead.","severity":"deprecated","affected_versions":">=0.17.0"},{"fix":"Update keyword argument from 'headline' to 'headlines'.","message":"In v0.15.0, the 'advertools.ad_create' function's 'headline' parameter was renamed to 'headlines' (plural).","severity":"breaking","affected_versions":">=0.15.0"},{"fix":"Add retries or use proxies. Set user-agent if needed.","message":"Google Trends functions require a working internet connection and may raise HTTPError if rate-limited.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'0.17.2':27 'ad':39 'advertool':1,2 'analysi':12,22 'current':25 'digit':8,32 'digital-market':31 'googl':38 'google-ad':37 'irregular':29 'keyword':16,35 'keyword-research':34 'librari':6 'market':9,33 'media':21,45 'provid':13 'python':5 'releas':28 'research':17,36 'scrape':42 'seo':11,30 'simul':19 'social':20,44 'social-media':43 'spider':18 'tool':14 'version':26 'web':41 'web-scrap':40","created_at":"2026-04-27T16:57:03.218990+00:00","updated_at":"2026-04-27T16:57:03.218990+00:00","problems":[{"fix":"Use 'from advertools import ad_create'.","cause":"Incorrect import style: 'import advertools.ad_create' instead of 'from advertools import ad_create'.","error":"ModuleNotFoundError: No module named 'advertools.ad_create'"},{"fix":"Extract scalar values or use .any()/.all() methods.","cause":"Passing a pandas DataFrame directly to a function that expects a boolean or scalar.","error":"ValueError: The truth value of a DataFrame is ambiguous"},{"fix":"Increase delays or reduce request frequency. Use 'adv.spider' with 'max_requests_per_second' parameter.","cause":"Rate limiting by Google when using spider or search functions.","error":"requests.exceptions.HTTPError: 429 Client Error: Too Many Requests"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"0.18.0","cli_name":"advertools","cli_version":"advertools 0.17.2","type":"library","homepage":"https://adver.tools","github":"https://github.com/eliasdabbas/advertools","docs":"https://advertools.readthedocs.io","changelog":"https://github.com/eliasdabbas/advertools/blob/master/HISTORY.rst","pypi":"https://pypi.org/project/advertools/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["crm-productivity","data","web-framework"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-28","last_verified":"2026-06-28","next_check":"2026-07-28","install_tag":null}}