Skip to main content

​
InstagramClient

The InstagramClient class provides methods to fetch Instagram media content using the RapidAPI Instagram Downloader service.

​
Integration

The client integrates with RapidAPI’s Instagram Downloader service:
  • RapidAPI Host: instagram-downloader-download-instagram-stories-videos4.p.rapidapi.com
  • Endpoint: /convert
  • Authentication: API key via X-Rapidapi-Key header

​
Methods

​
get_media

Fetches media information from an Instagram URL. 
async def get_media(url: str) -> InstagramMediaInfo
​
url
str
required
The Instagram post URL (supports posts, reels, TV, and stories formats)
​
InstagramMediaInfo
InstagramMediaInfo
Contains the media items and metadata for the Instagram post
​
media
list[InstagramMediaItem]
List of media items in the post (single item for regular posts, multiple for carousels)
​
link
str
The original Instagram URL

​
Exceptions

The method raises the following exceptions:
  • InstagramNotFoundError - Post not found, deleted, or private (HTTP 404)
  • InstagramRateLimitError - API rate limit exceeded (HTTP 429)
  • InstagramNetworkError - Network errors or unexpected API responses

​
Example Usage

from instagram_api.client import InstagramClient

client = InstagramClient()

try:
    media_info = await client.get_media("https://www.instagram.com/p/ABC123/")
    
    if media_info.is_video:
        print(f"Video URL: {media_info.video_url}")
    elif media_info.is_carousel:
        print(f"Carousel with {len(media_info.media)} items")
    else:
        print(f"Image URLs: {media_info.image_urls}")
        
except InstagramNotFoundError:
    print("Post not found or is private")
except InstagramRateLimitError:
    print("Rate limit exceeded, try again later")
except InstagramNetworkError as e:
    print(f"Network error: {e}")

​
Configuration

The client requires a RapidAPI key to be configured: 
instagram:
  rapidapi_key: "your-api-key-here"
The API key is read from the application configuration at config["instagram"]["rapidapi_key"].

​
URL Format

The client accepts Instagram URLs matching the pattern: 
https?://(?:www\.)?instagram\.com/(?:p|reels?|reel|tv|stories)/[\w-]+
Supported URL types:
  • Posts: /p/...
  • Reels: /reel/, /reels/
  • TV: /tv/...
  • Stories: /stories/...