Amazon Photos API
Project description
Amazon Photos API
Table of Contents
Installation
pip install amazon-photos
Setup
A .env
file must be created with these cookie values.
session-id=...
ubid-acbca=...
at-acbca=...
Query Syntax
For valid location and people IDs, see the results from the
aggregations()
method.
Example query:
type:(PHOTOS OR VIDEOS)
AND things:(plant AND beach OR moon)
AND timeYear:(2019)
AND timeMonth:(7)
AND timeDay:(1)
AND location:(CAN#BC#Vancouver)
AND people:(CyChdySYdfj7DHsjdSHdy)
Examples
from amazon_photos import Photos
ap = Photos()
# get entire Amazon Photos library
ap.query("type:(PHOTOS OR VIDEOS)")
# query Amazon Photos library for specific photos/videos
ap.query("type:(PHOTOS OR VIDEOS) AND things:(plant AND beach OR moon) AND timeYear:(2023) AND timeMonth:(8) AND timeDay:(14) AND location:(CAN#BC#Vancouver)")
# convenience method to get all photos
ap.photos()
# convenience method to get all videos
ap.videos()
# get current usage stats
ap.usage()
# get all identifiers calculated by Amazon.
ap.aggregations(category="all")
# get specific identifiers calculated by Amazon.
ap.aggregations(category="location")
# get trash bin contents
ap.trashed()
# move a batch of images/videos to the trash bin
ap.trash([...])
# restore a batch of images/videos from the trash bin
ap.restore([...])
# upload a batch of images/videos
ap.upload([...])
# download a batch of images/videos
ap.download([...])
# permanently delete a batch of images/videos.
ap.delete([...])
Common Paramters
name | type | description |
---|---|---|
ContentType | str | "JSON" |
_ | int | 1690059771064 |
asset | str | "ALL" "MOBILE" "NONE "DESKTOP" default: "ALL" |
filters | str | "type:(PHOTOS OR VIDEOS) AND things:(plant AND beach OR moon) AND timeYear:(2019) AND timeMonth:(7) AND location:(CAN#BC#Vancouver) AND people:(CyChdySYdfj7DHsjdSHdy)" default: "type:(PHOTOS OR VIDEOS)" |
groupByForTime | str | "day" "month" "year" |
limit | int | 200 |
lowResThumbnail | str | "true" "false" default: "true" |
resourceVersion | str | "V2" |
searchContext | str | "customer" "all" "unknown" "family" "groups" default: "customer" |
sort | str | "['contentProperties.contentDate DESC']" "['contentProperties.contentDate ASC']" "['createdDate DESC']" "['createdDate ASC']" "['name DESC']" "['name ASC']" default: "['contentProperties.contentDate DESC']" |
tempLink | str | "false" "true" default: "false" |
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
amazon-photos-0.0.4.tar.gz
(10.8 kB
view hashes)
Built Distribution
Close
Hashes for amazon_photos-0.0.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 099f5d66d575bb57e3a916c8de5ec287b20485fbb7f5056f00b33e6455b415e5 |
|
MD5 | 9c6c31cf136dc67d0273a626b0d762c1 |
|
BLAKE2b-256 | b90728f2f4fd9cc1819f5873deeeb97b544a38bf194c4e91c73d3ec23b108dbc |