Registry / crm-productivity / advertools

advertools

library0.18.0pypypi✓ verified 84d ago

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.

crm-productivity data web-framework

pip install advertools

github ↗package ↗homepage ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · ADVERTOOLS

advertools

crm-productivitypythonv0.18.0

Install

15.9s avg

Import

3771ms

Disk

407MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.18.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 3.892s · 416.1MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 15.9s · import 3.650s · 384MB

407MB installed

● package 407MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

advertools

✓ import advertools as adv

✗ from advertools import *

Using wildcard imports is discouraged; use 'import advertools as adv' for clarity.

advertools.ad_create

✓ from advertools import ad_create

✗ import advertools.ad_create

ad_create is a function, not a submodule; wrong import leads to ModuleNotFoundError.

Generates keyword permutations for Google Ads using seed words.

import advertools as adv # Generate keywords from a seed list seed_words = ['shoes', 'boots'] keywords = adv.generate_google_keywords(seed_words) print(keywords.head())

advertools --version

Debug

Known issues

deprecatedFunction 'advertools.serp.googlesearch' is deprecated in v0.17.0. Use 'advertools.serp.serp_goog' instead.

fix

Replace serp.googlesearch with serp.serp_goog.

affects: >=0.17.0

breakingIn v0.15.0, the 'advertools.ad_create' function's 'headline' parameter was renamed to 'headlines' (plural).

fix

Update keyword argument from 'headline' to 'headlines'.

affects: >=0.15.0

gotchaGoogle Trends functions require a working internet connection and may raise HTTPError if rate-limited.

fix

Add retries or use proxies. Set user-agent if needed.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'advertools.ad_create'

Incorrect import style: 'import advertools.ad_create' instead of 'from advertools import ad_create'.

fix

Use 'from advertools import ad_create'.

ValueError: The truth value of a DataFrame is ambiguous

Passing a pandas DataFrame directly to a function that expects a boolean or scalar.

fix

Extract scalar values or use .any()/.all() methods.

requests.exceptions.HTTPError: 429 Client Error: Too Many Requests

Rate limiting by Google when using spider or search functions.

fix

Increase delays or reduce request frequency. Use 'adv.spider' with 'max_requests_per_second' parameter.

Upgrade

Version history

0.18.0latest on PyPI · released Jun 17, 2026

Audit

Dependencies

pandasrequiredData manipulation and analysis

requestsrequiredHTTP requests

lxmlrequiredXML/HTML parsing

beautifulsoup4requiredWeb scraping

scikit-learnoptionalMachine learning support

Agent activity

66 hits · last 30 days

node

Perplexity

OpenAI (training)

Resources

githubhttps://github.com/eliasdabbas/advertools ↗

packagehttps://pypi.org/project/advertools/ ↗

homepagehttps://adver.tools ↗

docshttps://advertools.readthedocs.io ↗

changeloghttps://github.com/eliasdabbas/advertools/blob/master/HISTORY.rst ↗