Skip to main content

Package for making calls to metrics.tools API

Project description

metrics_tools

A simple python package for making API calls to metrics.tools API. https://metrics.tools/

It builds upon the requests package. The goal is to achiev an easy syntax for the API calls like: mt.domain('example.com').rankings.get()

Note: I am not professional programmer. Install at your own risk. Useful tips are welcome :-).

Install via pip

pip install metrics-tools

Basic usage

from metrics_tools import MetricsTools

api_key = 'your api key'
mt = MetricsTools(api_key, verbose=True)

domain = mt.domain('example.com')

visibility = domain.sk.get()
rankings = domain.rankings.get()

keyword_details = mt.keyword('api').details.get()

Response

The response is parsed into a simple object with fields as object attributes. Additionaly it contains the requests response as '._response'.

example_domain.values # if values are present
example_domain.json # parsed json response
example_domain.result # 'success' or 'error'

More Parameters

The API supports some additional parameters, respectifly filters, to narrow down the API answer. These filters can be used through the avalible functions.

#Visibility for specific date
domain.sk.from_('2018-05-07').get()

#Min and max visibility value
domain.sk.minmax().get()

#Ranking position for domain and given keyword
domain.position.for_keyword('jens fauldrath').get()

API calls

The minimum interval for calls is 0.2 sec.

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

metrics_tools-0.0.2.tar.gz (6.6 kB view hashes)

Uploaded Source

Built Distribution

metrics_tools-0.0.2-py3-none-any.whl (10.3 kB view hashes)

Uploaded Python 3

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