aiograpi

🔥 Asynchronous Python library for Instagram Private API 2024

View on GitHub

Common Exceptions

Exception Base Description
ClientError Exception Base Exception for Instagram calls
GenericRequestError ClientError Base Exception for Request (Solution: try changing your proxy)
ClientGraphqlError ClientError Exception for GraphQL calls
ClientJSONDecodeError ClientError JSON Exception
ClientConnectionError ClientError Connection error (Solution: try changing your proxy)
ClientBadRequestError ClientError HTTP 400 Exception
ClientUnauthorizedError ClientError HTTP 401 Exception
ClientForbiddenError ClientError HTTP 403 Exception
ClientNotFoundError ClientError HTTP 404 Exception
ClientThrottledError ClientError HTTP 429 Exception (Solution: try changing your proxy)
ClientRequestTimeout ClientError Request Timeout Exception
ClientIncompleteReadError ClientError Raises when response interrupted
ClientLoginRequired ClientError Raises when Instagram required Login (Solution: try changing your proxy)
ReloginAttemptExceeded ClientError Raises when all attempts exceeded
ClientErrorWithTitle ClientError Occurs when Instagram returns an unknown error with the title
ClientUnknownError ClientError Occurs when Instagram returns an unknown error
WrongCursorError ClientError Occurs when the cursor for pagination is passed in the wrong format
ClientStatusFail ClientError Occurs when Instagram returns message with status=fail with details

Proxy Exceptions

Exception Base Description
ProxyError ClientError Base exception for proxy
ConnectProxyError ProxyError Occurs when it is not possible to connect to your proxy
AuthRequiredProxyError ProxyError Occurs when incorrect credentials are passed to authorize your proxy
ProxyAddressIsBlocked PrivateError Happens when your proxy is blocked by Instagram, change your proxy!
SentryBlock PrivateError Raises when get message=sentry_block (most likely you were banned from instagram by ip address. Solution: try changing your proxy)
RateLimitError PrivateError Raises when get message=rate_limit_error (Solution: try changing your proxy)
PleaseWaitFewMinutes PrivateError Raises when get message=”Please wait a few minutes before you try again” (Solution: try changing your proxy)

GraphQL/Public Exceptions

Exception Base Description
AccountSuspended ClientError Your account is suspended
TermsUnblock ClientError Your account may be blocked, you need to agree to the terms
TermsAccept ClientError Your account may be blocked, you need to agree to the terms
AboutUsError ClientError Your account may be blocked

Private Exceptions

Exception Base Description
PrivateError ClientError Base Exception for Private calls (received from Instagram)
FeedbackRequired PrivateError Raises when get message=feedback_required
PreLoginRequired ClientError Raises when authorization is required before calling a method
LoginRequired PrivateError Raises when get message=login_required (from Instagram)
BadPassword PrivateError Raises when get message=bad_password
TwoFactorRequired PrivateError Raises when get message=two_factor_required
UnknownError PrivateError Raises when get unknown message (new message from instagram)
BadCredentials PrivateError The login and password pair for your account have not been passed
IsRegulatedC18Error ClientBadRequestError The user is limited to 18+

Challenge Exceptions

Exception Base Description
ChallengeError PrivateError Base Challenge Exception (received from Instagram)
ChallengeRedirection ChallengeError Raises when get type=CHALLENGE_REDIRECTION
ChallengeRequired ChallengeError Raises when get message=challenge_required
ChallengeSelfieCaptcha ChallengeError Raises when get step=selfie_captcha
ChallengeUnknownStep ChallengeError Occurs when challenge is unknown
SelectContactPointRecoveryForm ChallengeError Raises when get challengeType=SelectContactPointRecoveryForm
RecaptchaChallengeForm ChallengeError Raises when get challengeType=RecaptchaChallengeForm
SubmitPhoneNumberForm ChallengeError Raises when get challengeType=SubmitPhoneNumberForm
LegacyForceSetNewPasswordForm ChallengeError Raises when get challengeType=LegacyForceSetNewPasswordForm
ConsentRequired PrivateError Raises when get message=consent_required
GeoBlockRequired PrivateError Raises when get message=geoblock_required
CheckpointRequired PrivateError Raises when get message=checkpoint_required

Media Exceptions

Exception Base Description
MediaError PrivateError Base Media Exception (received from Instagram)
MediaNotFound MediaError Raises when user unavailable
InvalidTargetUser PrivateError Occurs when the selected user cannot be mentioned (does not exist, has been deleted or is closed by privacy settings)
InvalidMediaId PrivateError Occurs when the selected media does not exists
MediaUnavailable PrivateError Occurs when the selected media is no longer available

User Exceptions

Exception Base Description
UserError PrivateError Base User Exception (received from Instagram)
UserNotFound UserError Raises when user unavailable
PrivateAccount PrivateError The target user is closed by privacy settings

Account Exceptions

Exception Base Description
ResetPasswordError ClientError Raises when password is not reset
UnsupportedError ClientError Raises when option is supported
UnsupportedSettingValue UnsupportedError Raises when account setting value is not supported

Collection Exceptions

Exception Base Description
CollectionError PrivateError Base Collection Exception (received from Instagram)
CollectionNotFound CollectionError Raises when collection unavailable

Direct Exceptions

Exception Base Description
DirectError PrivateError Base Direct Exception
DirectThreadNotFound DirectError Raises when thread not found
DirectMessageNotFound DirectError Raises when message in thread not found

Photo Exceptions

Exception Base Description
PhotoNotDownload PrivateError Raises when source photo not found
PhotoNotUpload PrivateError Raises when photo not upload
PhotoConfigureError PhotoNotUpload Raises when photo not configured
PhotoConfigureStoryError PhotoConfigureError Raises when photo story not configured

Video Exceptions

Exception Base Description
VideoNotDownload PrivateError Raises when source video not found
VideoNotUpload PrivateError Raises when video not upload
VideoConfigureError VideoNotUpload Raises when video not configured
VideoConfigureStoryError VideoConfigureError Raises when video story not configured
VideoTooLongException PrivateError Raises when video too long

IGTV Exceptions

Exception Base Description
IGTVNotUpload PrivateError Raises when IGTV not upload
IGTVConfigureError IGTVNotUpload Raises when IGTV not configured

Reels/Clip Exceptions

Exception Base Description
ClipNotUpload PrivateError Raises when Reels Clip not upload
ClipConfigureError ClipNotUpload Raises when Reels Clip not configured

Album Exceptions

Exception Base Description
AlbumNotDownload PrivateError Raises when album not found
AlbumUnknownFormat PrivateError Raises when format of media not MP4 or JPG
AlbumConfigureError PrivateError Raises when album not configured

Story Exceptions

Exception Base Description
StoryNotFound NotFoundError Raises when story not found

Highlight Exceptions

Exception Base Description
HighlightNotFound NotFoundError Raises when highlight not found

Hashtag Exceptions

Exception Base Description
HashtagError PrivateError Base exception for hashtag
HashtagNotFound NotFoundError Raises when hashtag not found
HashtagPageWarning ClientForbiddenError Occurs when Instagram returns warning_message with category_name=HASHTAG_PAGE_WARNING_MESSAGE

Location Exceptions

Exception Base Description
LocationError PrivateError Base exception for location
LocationNotFound NotFoundError Raises when location not found

Comment Exceptions

Exception Base Description
CommentNotFound PrivateError Raises when comment not found
CommentsDisabled PrivateError The ability to comment has been disabled by the author of the post

Share Exceptions

Exception Base Description
ShareDecodeError PrivateError Occurs when the data format for Share-obj is incorrect

Note Exceptions

Exception Base Description
NoteNotFound NotFoundError Raises when note not found

Track Exceptions

Exception Base Description
TrackNotFound NotFoundError Raises when track not found

SignUp Exceptions

Exception Base Description
InvalidNonce PrivateError Occurs when instagram returns error_type=invalid_nonce when registering a new account