one
onegram
pypi i onegram
one

onegram

This repository is no longer maintained.

by Paulo Romeira

1.3.2 (see all)
pypi i onegram
Readme

onegram

pypi pyversions travis codecov requires gitter license
donate bitcoin

A simplistic api-like instagram bot powered by requests.

Warnings!

  • This isn't an official api. Use at your own risk.
  • Make sure you have the latest version installed. To update: pip install -U onegram.
  • Default rate limits are not configured properly, so adjust them to not get banned!

Installation

pip install onegram

Dependencies

Python 3.6

Examples

Follow someone

from onegram import follow

follow('<someone>')

Like all someone posts

from onegram import like, posts

for post in posts('<someone>'):
  like(post)

Who likes you most?

from collections import defaultdict
from operator import itemgetter

from onegram import posts, likes

rank = defaultdict(int)
for post in posts():
    for like_info in likes(post):
        username = like_info['username']
        rank[username] += 1

rank = sorted(rank.items(), key=itemgetter(1), reverse=True)

print(rank[:10]) # TOP 10!

Explicit login (optional)

from onegram import Login, posts

with Login(username='user', password='pass'):
  user_posts = list(posts())
  other_posts = list(posts('other'))
Also possible
from onegram import *

login()

last_post = next(posts())
post_likes = list(likes(last_post))

logout()

Cheatsheet

The set of functions are divided into queries and actions. For some queries the user is optional, with default set to the logged user.

QueryArgument(s)ActionArgument(s)
user_info[user]followuser
followers[user]unfollowuser
following[user]likepost
posts[user]unlikepost
post_infopostcommentcomment[, post]
likespostuncommentcomment[, post]
commentspostsavepost
feedunsavepost
explore[tag]

Rate Limits

Settings can be overridden if you use one of the explicit login forms (defaults: onegram/settings.py). It's possible to define a fixed User-Agent, for example. Overall, the most userful setting is RATE_LIMITS, where you can set rate limits for:

  1. Each query or action
  2. All queries or all actions
  3. All queries and actions

Example

from onegram import login

minute = 60
hour = minute * 60
day = hour * 24

rate_limits = {
  'queries': [(1, 1)], # One query per second
  'actions': [(1, 3)], # One action per 3 seconds
  'like': [
    (5, minute), # A maximum of 5 likes in a minute
    (100, day)   # A maximum of 100 likes in a day
  ],
  'comment': [(1, 5)], # One comment per 5 seconds
}
# You can use '*' to set limits for all queries and actions.

settings = {
  'RATE_LIMITS': rate_limits,
  'RATE_PERSIST_ENABLED': True, # enabled by default
  'RATE_PERSIST_DIR': '.onegram/rates' # default directory
}

login(custom_settings=settings)
# ...

Notice that you can specify a greedy or patient behaviour, or both. This is possible because you can have different rates for different time intervals.

For example, both (10, 10) and (1, 1) will do 10 requests in 10 seconds, but the first one is greedy. It will make 10 requests and wait 10 seconds to continue, whereas the second one will make one request at each second.

As general rule:

Greedy = (times, seconds)
Patient = (1, seconds/times)

Tips

  • Export your credentials so you don't have to type it:
    export INSTA_USERNAME=username
    export INSTA_PASSWORD=password
    

GitHub Stars

136

LAST COMMIT

4yrs ago

MAINTAINERS

1

CONTRIBUTORS

1

OPEN ISSUES

7

OPEN PRs

0
VersionTagPublished
1.3.2
4yrs ago
1.3.1
4yrs ago
1.3.0
4yrs ago
1.2.3
4yrs ago
No alternatives found
No tutorials found
Add a tutorial