Skip to main content

Unoffice TrustPilot API to download reviews scores and contents

Project description


Unofficial TrustPilot reviews collector. For Academic Use Only. READ: TrustPilot Terms of Use


You, and you alone, are responsible for following TrustPilot terms and using this tool to gather their data. Respect their servers and be thoughtful when gathering large amount of data.

Unmatured Documetation :)

This code implements basic data scraping of TrustPilot [default:Danish] Reviews .

It is a prototype to be used for academic reasons only. TrustPilot offers APIs to gather their data

Get it from PyPI

pip install trustpilotreviews

How to use it:

Import package

from trustpilotreviews import GetReviews

1. Initiat Class

Initiate the class with either (a) passing a dictionary of companies as keys and companies TrustPilot id as items or (b) adding them with dictionary syntax.


# way a: Using dictionary with business ids
id_dict = {'Skat':'470bce96000064000501e32d','DR':'4690598c00006400050003ee'}
d = GetReviews(id_dict)

# ids dictionary can be loaded from text files e.g.
lines = np.genfromtxt('data/business_ids.csv', delimiter=',',
                            dtype=str,skip_header=1) #skipped header
csv_dict = {key:item for key, item in lines}
d = GetReviews(csv_dict)

# way b: Using dictionary assignment 
d = GetReviews()
d['Skat'] = '470bce96000064000501e32d'

No business ids, no problem:

from trustpilotreviews import GetReviews

# Initiate it. Language will be required
t = GetReviews()

# Pass in web-page address as it appears in
mate_id = t.get_id('')

# Check if everything is ok
if mate_id.ok:

# Gather data from that id
data = t.get_reviews() 

Having multiple websites, well, no problem:

from trustpilotreviews import GetReviews

t = GetReviews()

# pass multiple web-pages as a list
ids = t.get_ids(['',''])

print(ids) # same as print(t) as ids are added to que

# gather data for those ids  
data = t.get_reviews()   

Want to save it on a database instead of Pandas, done:

from trustpilotreviews import GetReviews

t = GetReviews()
ids = t.get_ids(['',''])

# mine data for those ids 

# send them to in memory database

2. Reading Data

df = pd.DataFrame(t.dictData)

or from stored source

df = pd.read_pickle('TrustPilotData.pkl')

A full example:

import numpy as np
from trustpilotreviews import GetReviews

# Dictionary from Data 
lines = np.genfromtxt('companies_ids.csv', delimiter=',',
                      dtype=str, skip_header=1)
csv_dict = {key: item for key, item in lines}

d = GetReviews(csv_dict) # Select no for Norwegian Reviews

# Saves as pandas dataframe pickle


  • Allow different saving formats e.g. df.to_XXX
  • Split page_review funciton into connection and data parsing (better way to handler bad requests)
  • Add more features
  • Write a better documetation

TrustPilot Terms of Use


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

trustpilotreviews-0.1.2.tar.gz (8.0 kB view hashes)

Uploaded source

Built Distribution

trustpilotreviews-0.1.2-py3-none-any.whl (8.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page