API coverage

class minds.api.Minds(profile: minds.profile.Profile = None, login=True)[source]
authenticate(username, password, save_profile=True) → dict[source]

Authenticate current instance with given user :param: save_profile: whether to save profile locally

channel_subscribers(offset: int = None, limit: int = 24) → dict

Returns channel section subscribers subsection channels

Parameters:
  • offset – pagination offset
  • limit – pagination limit

Note

requires auth

channel_subscriptions(offset: int = None, limit: int = 24) → dict

Returns channel section subscriptions subsection channels

Parameters:
  • offset – pagination offset
  • limit – pagination limit

Note

requires auth

channel_top(offset: int = None, limit: int = 24) → dict

Returns channel section top subsection channels

Parameters:
  • offset – pagination offset
  • limit – pagination limit
comments(guid, offset=None, limit=12) → dict[source]

Return comments of GUID post :param guid: 18digit minds.com guid

delete(url: str) → dict

Delete any sort of post

Parameters:url – direct url to object to be deleted

Note

requires auth

downvote(guid) → dict

Downvote any sort of post

Parameters:guid – guid of post object

Note

requires auth

get_cookies() → dict[source]

get current connection cookies

get_guid(clue: str) → str[source]

get GUID from a clue :param clue: either url, channel id or guid (will return itself after checking) :return: guid

is_authenticated

Return whether current instance is authenticated

static is_guid(guid: str) → bool[source]

Check whether text is minds 18digit long GUID

newsfeed_boost(offset: int = None, limit: int = 12) → dict

Returns newsfeed section boost subsection posts

Parameters:
  • offset – pagination offset
  • limit – pagination limit
newsfeed_channel(channel_guid, offset: int = None, limit: int = 12) → dict

Returns newsfeed section channel subsection posts

Parameters:
  • offset – pagination offset
  • limit – pagination limit
newsfeed_single(guid, offset: int = None, limit: int = 12) → dict

Returns single newsfeed post

Parameters:
  • guid – post guid
  • offset – pagination offset
  • limit – pagination limit
newsfeed_subscribed(offset: int = None, limit: int = 12) → dict

Returns newsfeed section subscribed subsection posts

Parameters:
  • offset – pagination offset
  • limit – pagination limit

Note

requires auth

newsfeed_top(offset: int = None, limit: int = 12) → dict

Returns newsfeed section subscribed subsection posts

Parameters:
  • offset – pagination offset
  • limit – pagination limit
notifications_all(offset: int = None, limit: int = 24) → dict

get all notifications

Parameters:
  • offset – pagination offset
  • limit – pagination limit
notifications_comments(offset: int = None, limit: int = 24) → dict

get only comments notifications

Parameters:
  • offset – pagination offset
  • limit – pagination limit
notifications_groups(offset: int = None, limit: int = 24) → dict

get only groups notifications

Parameters:
  • offset – pagination offset
  • limit – pagination limit
notifications_subscriptions(offset: int = None, limit: int = 24) → dict

get only subscriptions notifications

Parameters:
  • offset – pagination offset
  • limit – pagination limit
notifications_tags(offset: int = None, limit: int = 24) → dict

get only tags notifications

Parameters:
  • offset – pagination offset
  • limit – pagination limit
notifications_votes(offset: int = None, limit: int = 24) → dict

get only votes notifications

Parameters:
  • offset – pagination offset
  • limit – pagination limit
post_blog(title, body, mature=False, category='', license='', published=True, slug=None)

Post blog under user’s blogfeed

Parameters:
  • title – blog title
  • body – html body
  • mature – whether post should be marked mature or not
  • category – blog category
  • license – blog license
  • published – whether to publish on posting (otherwise will be draft)
  • slug – visual url slug that will be set for the blog post

Note

requires auth

post_comment(guid, message, mature=False, **kwargs)

Post comment to guid.

Parameters:
  • guid – under what object message should be posted
  • message – text message of post content
  • attached_url – urls that should be attached to the post
  • mature – whether post should be marked mature or not

Note

requires auth

post_newsfeed(message, attached_url='', mature=False, **kwargs) → dict

Post something to user’s newsfeed.

Parameters:
  • message – text message of post content
  • attached_url – urls that should be attached to the post
  • mature – whether post should be marked mature or not

Note

requires auth

register(email) → dict[source]

register user using self.profile credentials

Try to register a profile using credentials self.profile.username and self.profile.password. The profile will be saved locally if possible.

Parameters:email – email is required for registration however it’s not used anywhere by minds.com
upvote(guid: str) → dict

Upvote any sort of post

Parameters:guid – guid of post object

Note

requires auth