Skip to content

GridBank API

Access premium video content with powerful search, metadata retrieval, and download capabilities.

Quick Start

Choose your SDK and get started in minutes.

Python SDK

bash pip install gridbank-api

```python from gridbank_api import GridbankClient

client = GridbankClient(api_key="apik_...") results = client.search_videos(q="nature", per_page=5) print(f"Found {len(results.videos)} videos") ```

View Python Documentation

JavaScript SDK

bash npm install @gridbank/api-js

```javascript import { GridbankClient } from '@gridbank/api-js';

const client = new GridbankClient({ apiKey: 'apik_...' }); const results = await client.searchVideos({ q: 'nature', perPage: 5 }); console.log(Found ${results.videos.length} videos); ```

View JavaScript Documentation

Features

  • Full-text video search with relevance, popularity, and recency sorting
  • Video metadata including creator info, dimensions, and licensing tiers
  • Signed download URLs with configurable expiration (1–5 minutes)
  • Usage tracking to monitor subscription tier and download quota
  • Rate limiting based on your tier (starter, pro, enterprise)

API Endpoints

The GridBank API consists of 4 core endpoints:

Endpoint Method Purpose
/external/v1/videos/search GET Full-text video search with pagination
/external/v1/videos/{video_id} GET Fetch metadata for a single video
/external/v1/videos/{video_id}/download GET Generate signed download URL
/external/v1/usage/me GET Check subscription tier and usage

Authentication

All requests require a Bearer token in the Authorization header.

bash curl -H "Authorization: Bearer YOUR_API_TOKEN" https://api2.gridbank.io/external/v1/videos/search?q=nature

SDKs

We provide official SDKs for Python and JavaScript to make integration simple:

Support