/awis

A python script to query Amazon's Alexa Web Information Service (AWIS).

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

awis Travis CI Scrutinizer Code Quality

A python script that generates a custom url and query string used to query Amazon's Alexa Web Information Service (AWIS). You may want to check the getting started section on the FAQ.

UrlInfo request

from myawis import *

obj = CallAwis(Access_Key_ID, Secret_Access_Key)
urlinfo = obj.urlinfo("www.example.com")

More info in the docs on UrlInfo

Output sample

import pprint

pprint.pprint(flatten_urlinfo(urlinfo))

{'CategoryData.0.AbsolutePath': 'Top/Computers/Software/Configuration_Management/Tools/Git',
 'CategoryData.0.Title': 'Tools/Git',
 'CategoryData.1.AbsolutePath': 'Top/Computers/Open_Source/Project_Hosting',
 'CategoryData.1.Title': 'Open Source/Project Hosting',
 'ContactInfo.CompanyStockTicker': None,
 'ContactInfo.DataUrl.#text': 'github.com',
 'ContactInfo.DataUrl.@type': 'canonical',
 'ContactInfo.Email': None,
 'ContactInfo.OwnerName': None,
 'ContactInfo.PhoneNumbers.PhoneNumber': None,
 'ContactInfo.PhysicalAddress': None,
 'ContentData.AdultContent': None,
 'ContentData.DataUrl.#text': 'github.com',
 'ContentData.DataUrl.@type': 'canonical',
 'ContentData.Language': None,
 'ContentData.LinksInCount': '81310',
 'ContentData.OwnedDomains': None,
 'ContentData.SiteData.Description': 'GitHub is the best place to share code '
                                     'with friends, co-workers, classmates, '
                                     'and complete strangers. Over four '
                                     'million people use GitHub to build '
                                     'amazing things together.',
 'ContentData.SiteData.Title': 'GitHub',
 'ContentData.Speed.MedianLoadTime': '1675',
 'ContentData.Speed.Percentile': '53',
 'ContributingSubdomain.codeload.github.com.Months.1.PageViews.PerUser': '1.26',
 'ContributingSubdomain.codeload.github.com.Months.1.PageViews.Percentage': '0.58%',
 'ContributingSubdomain.codeload.github.com.Months.1.Reach.Percentage': '2.39%',
[...]
 'ContributingSubdomain.status.github.com.Months.1.PageViews.PerUser': '1.1',
 'ContributingSubdomain.status.github.com.Months.1.PageViews.Percentage': '0.07%',
 'ContributingSubdomain.status.github.com.Months.1.Reach.Percentage': '0.34%',
 'Country.AU.Contribution.PageViews': '0.8%',
 'Country.AU.Contribution.Users': '1.0%',
 'Country.AU.Rank': '74',
[...]
 'Country.US.Contribution.PageViews': '21.0%',
 'Country.US.Contribution.Users': '21.3%',
 'Country.US.Rank': '45',
 'OutputTimestamp': '2017-08-14T18:48:45.026723',
 'Related.DataUrl.#text': 'github.com',
 'Related.DataUrl.@type': 'canonical',
 'RelatedLink.0.DataUrl.#text': 'zenofshen.com/posts/ajax-sortable-lists-tutorial',
 'RelatedLink.0.DataUrl.@type': 'canonical',
 'RelatedLink.0.NavigableUrl': 'http://zenofshen.com/posts/ajax-sortable-lists-tutorial',
 'RelatedLink.0.Title': 'zen of shen - script.aculo.us Ajax Sortable Lists '
                        'Tutorial',
[...]
 'RelatedLink.9.DataUrl.#text': 'www.ubuntu.com/',
 'RelatedLink.9.DataUrl.@type': 'canonical',
 'RelatedLink.9.NavigableUrl': 'http://www.ubuntu.com/',
 'RelatedLink.9.Title': 'Ubuntu Linux',
 'TrafficData.DataUrl.#text': 'github.com',
 'TrafficData.DataUrl.@type': 'canonical',
 'TrafficData.Rank': '58',
 'UsageStatistic.Days.1.PageViews.PerMillion.Delta': '-44.22%',
 'UsageStatistic.Days.1.PageViews.PerMillion.Value': '944',
 'UsageStatistic.Days.1.PageViews.PerUser.Delta': '-14.06%',
 'UsageStatistic.Days.1.PageViews.PerUser.Value': '4.28',
 'UsageStatistic.Days.1.PageViews.Rank.Delta': '40',
 'UsageStatistic.Days.1.PageViews.Rank.Value': '92',
 'UsageStatistic.Days.1.Rank.Delta': '+26',
 'UsageStatistic.Days.1.Rank.Value': '84',
 'UsageStatistic.Days.1.Reach.PerMillion.Delta': '-34.99%',
 'UsageStatistic.Days.1.Reach.PerMillion.Value': '8,380',
 'UsageStatistic.Days.1.Reach.Rank.Delta': '+19',
 'UsageStatistic.Days.1.Reach.Rank.Value': '83',
[...]
 'UsageStatistic.Months.3.PageViews.PerMillion.Delta': '+5.46%',
 'UsageStatistic.Months.3.PageViews.PerMillion.Value': '1,573',
 'UsageStatistic.Months.3.PageViews.PerUser.Delta': '-3.69%',
 'UsageStatistic.Months.3.PageViews.PerUser.Value': '5.220',
 'UsageStatistic.Months.3.PageViews.Rank.Delta': '-1',
 'UsageStatistic.Months.3.PageViews.Rank.Value': '49',
 'UsageStatistic.Months.3.Rank.Delta': '-3',
 'UsageStatistic.Months.3.Rank.Value': '58',
 'UsageStatistic.Months.3.Reach.PerMillion.Delta': '+9.67%',
 'UsageStatistic.Months.3.Reach.PerMillion.Value': '12,830',
 'UsageStatistic.Months.3.Reach.Rank.Delta': '-1',
 'UsageStatistic.Months.3.Reach.Rank.Value': '67'}

TrafficHistory request

from myawis import *

obj = CallAwis(Access_Key_ID, Secret_Access_Key)
obj.traffichistory("www.example.com",RANGE, START)
# RANGE is optional. Defaults to 31
# START is optional. Defaults to 20070801

More info in the docs on TrafficHistory