Python client for Reincubate's iCloud API. Yes, it works with iOS 12 & iPhone Xs backups!
Branch: master
Clone or download
Latest commit 4a51922 Dec 11, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore v2.3.8 Nov 1, 2018
LICENSE LGPL v3 Nov 23, 2015
Makefile v2.3.2 Jan 3, 2018
requirements-local.txt v2.3.3 Jan 4, 2018

ricloud-py: iCloud access made easy

pypi CircleCI docs

This is the sample Python client for ricloud, Reincubate's Cloud Data API.

Refer to the comprehensive ricloud documentation for a fuller picture of the API's capabilities, specifications, and benefits. See also the Apple iCloud service documentation for its rich capabilities in accessing iCloud data.


The library can be installed with a single command:

$ pip install ricloud


A sample script is included which provides an example of how the API can be used to access a range of datatypes in a way that is compatible with Apple's 2FA mechanism.

To run the sample script in interactive mode, execute the following command:

$ python -m ricloud --password=joshua

ricloud's Python quickstart documentation covers in detail the other modes in which this sample client can be used.

For a simple tutorial on downloading photos from the iCloud, please see the tutorial.


See the support & service status page.

Need more functionality?

Reincubate's vision is to provide data access, extraction and recovery technology for all app platforms - be they mobile, desktop, web, appliance or in-vehicle.

The company was founded in 2008 and was first to market with both iOS and iCloud data extraction technology. With over half a decade's experience helping law enforcement and security organisations access iOS data, Reincubate has licensed software to government, child protection and corporate clients around the world.

The company can help users with:

  • iCloud access and data recovery
  • Recovery of data deleted from SQLite databases
  • Bulk iOS data recovery
  • Forensic examination of iOS data
  • Passcode, password, keybag and keychain analysis
  • Custom iOS app data extraction
  • Advanced PList, TypedStream and Mbdb manipulation

Contact Reincubate for more information.

Terms & license

See the file for details on this implementation's license. Users must not use the API in any way that is unlawful, illegal, fraudulent or harmful; or in connection with any unlawful, illegal, fraudulent or harmful purpose or activity.