SVG Vectors API

SVG Vector Engine & Management API

Complete RESTful API specifications for Pixahunt SVG Vectors, powering mobile apps, web applications, and internal admin automation.

1. Public App & Mobile Endpoints

GET /api/svgs

Search, filter, and paginate through active vectors.

Query Parameters:

  • q: Search string matching title, keyword tags, or slug
  • tag: Filter by specific keyword tag
  • sort: newest, popular/downloads, views, oldest
  • per_page: Number of items (default 24, max 100)
  • page: Page number

GET /api/svgs/trending

Returns top-downloaded and most popular vectors.

Query Parameters: limit (default 20, max 50)

GET /api/svgs/{id}

Retrieve detailed metadata, CDN URL, tags, and metrics for a specific vector.

2. Admin & Contributor Management Endpoints

POST /svg-images/upload

Direct SVG upload with automatic Gemini 2.5 Flash Vision metadata extraction and BunnyCDN upload.

Payload: multipart/form-data with svg (file up to 10MB)

Note: Admin uploads are published as Active. Contributor uploads are set to Pending for review.

POST /svg-images/update

Update vector metadata with automatic tag deduplication.

Payload (JSON): id, title, keyword (auto-deduplicated), icon_name, shortname, status (Admin only)

POST /svg-images/regenerate/{id}

Triggers Gemini AI to re-analyze the vector and regenerate title, tags, shortname, and icon name.

POST /svg-images/delete

Permanently removes the vector record from database and deletes the file from Bunny CDN storage.

POST /svg-images/bulk-status (Admin Only)

Bulk publish or unpublish vectors: ids: [1, 2, 3], status: 'Active'|'Pending'.

POST /svg-images/bulk-delete (Admin Only)

Bulk delete vectors from Bunny CDN storage and database: ids: [1, 2, 3].

3. Global CDN Delivery Structure

All display graphics and vector downloads use the official CDN:

https://cdn.pixahunt.com/svg/{filename}

Storage Zone path: svg/{filename} on BunnyCDN.