API Documentation

Integrate Instagram downloading into your apps

API Status: Internal Use Only
Our API is currently for internal use only. Public API access is planned for future release.

Note: Direct API access is not yet available to the public. Please use our web interface at igx.onetools.app for downloading Instagram content.

Backend API Endpoints
For internal reference only
POST/api/v1/post

Download Instagram posts and carousels

POST/api/v1/reel

Download Instagram Reels

POST/api/v1/profile-picture

Download profile pictures in high resolution

POST/api/v1/stories

Download Instagram Stories (public only)

POST/api/v1/highlights

Download Instagram Highlights

Example Request Format
Internal reference for developers

Request Body:

{
  "url": "https://www.instagram.com/p/ABC123/"
}

Response Format:

{
  "success": true,
  "shortcode": "ABC123",
  "content_type": "GraphSidecar",
  "is_video": false,
  "media_items": [
    {
      "type": "image",
      "url": "https://...",
      "thumbnail_url": null
    }
  ],
  "caption": "...",
  "owner_username": "example",
  "likes": 1234,
  "comments": 56
}
Rate Limiting
To prevent abuse and ensure fair usage
  • •10 requests per minute per IP address
  • •5-minute cache for repeat requests
  • •Temporary blocks for excessive requests
  • •Exponential backoff recommended for retries
Interested in Public API Access?
Let us know your use case

We're considering offering public API access in the future. If you're interested, please contact us with:

  • Your use case and expected volume
  • Type of content you need to download
  • Whether you need commercial licensing
Contact Us About API Access
Frontend Integration
How our frontend works

Architecture: Next.js 16 with TypeScript, Server Components (90%), shadcn/ui

State Management: React Context API for client-side state

Caching: 5-minute in-memory cache + 1-hour ISR revalidation

Error Handling: Abort controller, request deduplication, sanitized error messages

Performance: Lazy loading, compression, optimized fonts, Server Components

Open Source: Frontend code available at GitHub