API Reference
AgentGIF provides a free REST API. No authentication required for read endpoints. API key required for uploads and management.
Base URL
https://agentgif.com/api/v1/Authentication
Authorization: Token YOUR_API_KEYGet your API key at Settings → API Key.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/gifs/{id}/ | GIF detail |
| POST | /api/v1/gifs/ | Upload (auth required) |
| GET | /api/v1/search/?q=query | Full-text search |
| GET | /api/v1/featured/ | Featured GIFs |
| GET | /api/v1/tags/ | All tags |
| GET | /api/v1/themes/ | Terminal themes |
| GET | /api/v1/users/{username}/ | User profile |