{"library":"pytrends","title":"pytrends","description":"Pytrends is an unofficial Python library that provides a pseudo-API for Google Trends, allowing users to automate the downloading of search interest data. The current version, 4.9.2, was released in April 2023. Due to its unofficial nature, it does not adhere to a fixed release cadence but rather updates as needed to adapt to changes in Google's backend, which can frequently introduce breaking changes.","language":"python","status":"active","last_verified":"Fri May 15","install":{"commands":["pip install pytrends"],"cli":null},"imports":["from pytrends.request import TrendReq"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"from pytrends.request import TrendReq\nimport pandas as pd\n\n# Initialize pytrends object\n# hl: host language, tz: timezone offset (e.g., 360 for US CST, NOT -360)\npytrends = TrendReq(hl='en-US', tz=360)\n\n# Define keyword list\nkw_list = [\"Python programming\", \"Data Science\"]\n\n# Build payload for the request\n# timeframe: e.g., 'today 5-y' for last 5 years\npytrends.build_payload(kw_list, cat=0, timeframe='today 5-y', geo='US', gprop='')\n\n# Get Interest Over Time data\ninterest_over_time_df = pytrends.interest_over_time()\n\n# Print the first few rows of the DataFrame\nprint(\"Interest Over Time (first 5 rows):\")\nprint(interest_over_time_df.head())\n\n# Get Interest by Region data\ninterest_by_region_df = pytrends.interest_by_region(resolution='COUNTRY', inc_low_vol=True, inc_geo_code=True)\nprint(\"\\nInterest By Region (first 5 rows):\")\nprint(interest_by_region_df.head())","lang":"python","description":"This quickstart demonstrates how to initialize the `TrendReq` object, build a search payload for multiple keywords, and retrieve 'Interest Over Time' and 'Interest by Region' data from Google Trends. The data is returned as pandas DataFrames. Note the `tz` parameter for timezone offset, where '360' represents UTC-6 (e.g., US Central Standard Time) and not '-360'.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-15","installed_version":"4.9.2","pypi_latest":"4.9.2","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":8.9,"avg_import_s":1.39,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"pytrends","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.24,"mem_mb":34.4,"disk_size":"180.0M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"pytrends","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":8.7,"import_time_s":0.96,"mem_mb":34.4,"disk_size":"173M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"pytrends","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.7,"mem_mb":39.4,"disk_size":"192.8M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"pytrends","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":8.6,"import_time_s":1.6,"mem_mb":39.4,"disk_size":"185M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"pytrends","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.54,"mem_mb":38.4,"disk_size":"178.1M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"pytrends","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":8.6,"import_time_s":1.58,"mem_mb":38.4,"disk_size":"170M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"pytrends","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.42,"mem_mb":39.4,"disk_size":"177.1M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"pytrends","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":8.5,"import_time_s":1.46,"mem_mb":39.4,"disk_size":"169M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"pytrends","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.25,"mem_mb":34.7,"disk_size":"187.6M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"pytrends","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":10.3,"import_time_s":1.14,"mem_mb":34.7,"disk_size":"182M"}]}}