Importly

Quick Start

Choose your preferred development environment to get started with Importly in minutes.

Next.js

Server-side rendering with webhook-driven imports for optimal performance.

✅ Webhook support  •  ✅ SSR  •  ✅ API routes

Node.js

Server-side processing with Express and comprehensive webhook handling.

✅ Express integration  •  ✅ Webhooks  •  ✅ Background jobs

Python

Flask, Django, and async support for data processing and ML pipelines.

✅ Flask/Django  •  ✅ Async support  •  ✅ ML integration

cURL & HTTP

Raw HTTP requests for testing, automation, or any language integration.

✅ Language agnostic  •  ✅ Testing  •  ✅ Automation

Common Steps for All Integrations

Regardless of your chosen framework, you'll need to:

1. Get Your API Key

  1. Create an Account at Importly.io
  2. Find your API Key via the api key page
  3. Keep it secure—treat it like a password!

2. Basic Import Flow

All integrations follow this basic pattern:

  1. Import Media - Send a URL to Importly for processing
  2. Handle Response - Get an import ID and track status
  3. Receive Results - Download processed media via webhook or polling

3. Choose Your Approach

Webhooks (Recommended)

  • Real-time notifications when imports complete
  • More efficient than polling
  • Perfect for server-side applications
  • Ideal for production environments

Polling

  • Check import status periodically
  • Simpler to implement initially
  • Works well for client-side applications
  • Good for development and testing

Integration Recommendations

| Use Case | Recommended Approach | Why | | ----------------------- | ----------------------------------- | ---------------------------------- | | Production web app | Next.js | Webhooks + SSR for reliability | | API/Backend service | Node.js | Express + webhooks for scalability | | Data processing | Python | ML/AI integration capabilities | | Testing/Automation | cURL | Language-agnostic HTTP requests |

What Makes Each Approach Special?

Next.js: Webhook-Driven Excellence

  • Server-side security - API keys never exposed to clients
  • Instant notifications - Real-time updates via webhooks
  • SEO friendly - Server-side rendering for better performance
  • Production ready - Built-in error handling and retries

Node.js: Scalable Backend

  • Background processing - Handle imports independently
  • Database integration - Store and query import history
  • Webhook reliability - Always available to receive notifications
  • Enterprise ready - Queue management and monitoring

Python: Data & AI Focused

  • ML pipeline integration - Process imported media with AI
  • Data analysis - Extract insights from media metadata
  • Flexible frameworks - Works with Flask, Django, FastAPI
  • Scientific computing - Perfect for research and analysis

cURL: Universal & Simple

  • Any language - Integrate with any programming language
  • Quick testing - Test API endpoints instantly
  • Automation - Create scripts and cron jobs
  • Documentation - Easy to share and understand

Ready to start? Click on your preferred integration above!

IntroductionNext.js