Skip to main content

API to integrate Ubersuggest with Python

Project description



This package implements a simple class to integrate with amazing Ubersuggest tool. But what is the Ubersuggest tool anyway? It's a powerfull engine that can give statistics about keywords choosed by the user, taking as params the locale. Unfortanelly, this tool doesn't have a native API, so I decide to contribute. Home made.



pip install pyusuggest


  • requests
  • pytest


Instancing the Ubersuggest

from pyusuggest import Ubersuggest
keyword = 'algorithm'
ubersuggest = Ubersuggest(keyword)

Request data from Uberssugest



For instancing Ubersuggest:

  • keyword

    • Keyword or prase that will be used in the query of Ubersuggest tool.
  • locale

    • The region that will be used in the query. Must follow the padron en-us. Default locale is en-us.

For use look_up method:

  • results

    • Quantity of results that will be returned by the query. The default number is 50.

Get monthly statistics

You can get monthly statistics for the keyword searched and the related searches. The monthly statics show how many times that keyword was searched for each month.



For use the get_monthly_statistics method:

  • period: number of months that the user wants to track. If no period is passed as argument, every month will be returned.

Download results as CSV

You can also download the results from each keyword in CSV format. It will write a CSV file in the current working directory with the Search Volume, CPC and Competition info.



For use the get_monthly_statistics method:

  • No params are required for this method.


Other methods and option params can be checked at documentation.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyusuggest-1.0.4.tar.gz (4.7 kB view hashes)

Uploaded source

Built Distribution

pyusuggest-1.0.4-py3-none-any.whl (5.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page