Developer API v1.0

GeniuzQuiz API
Reference

Build powerful integrations with our comprehensive RESTful API. Create quizzes, manage leads, process payments, and leverage AI - all through simple HTTPS requests.

Get API KeyQuick Start
150+
API Endpoints
99.9%
Uptime
<100ms
Avg Response
1000/hr
Rate Limit

Authentication

Secure your API requests with OAuth 2.0 or API tokens

API Token Authentication

Include your API token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Base URL

All API requests should be made to:

https://www.geniuzquiz.com/api

Example Request

curl -X GET "https://www.geniuzquiz.com/api/quizzes" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

API Endpoints

Explore all available endpoints organized by category

Authentication

Secure OAuth 2.0 and API token authentication

POST/api/auth/loginAuthenticate user with email and password
POST/api/auth/registerCreate new user account
POST/api/auth/logoutEnd user session
GET/api/auth/sessionGet current session information
POST/api/developer/tokensGenerate API access tokens

Quizzes & Funnels

Create, manage, and deploy interactive quizzes and sales funnels

GET/api/quizzesList all quizzes
POST/api/quizzesCreate new quiz
GET/api/quizzes/{id}Get quiz details
PUT/api/quizzes/{id}Update quiz
DELETE/api/quizzes/{id}Delete quiz
POST/api/quizzes/{id}/cloneDuplicate an existing quiz
GET/api/funnelsList all sales funnels
POST/api/funnelsCreate new funnel
GET/api/funnels/{id}Get funnel details
PUT/api/funnels/{id}Update funnel

Leads & CRM

Manage leads, contacts, and customer relationships

GET/api/leadsList all leads with filtering
POST/api/leadsCreate new lead
GET/api/leads/{id}Get lead details with responses
PUT/api/leads/{id}Update lead information
DELETE/api/leads/{id}Delete lead
POST/api/leads/{id}/notesAdd note to lead
GET/api/chat/conversationsGet chat conversations

AI & Content Generation

Leverage AI for quiz generation, content creation, and insights

POST/api/ai/generate-quizGenerate quiz using AI
POST/api/ai/suggestionsGet AI-powered content suggestions
POST/api/ai/translateTranslate content to multiple languages
POST/api/ai/generate-imageGenerate images with AI
POST/api/magic-write/generateGenerate marketing copy
POST/api/magic-write/improveImprove existing content
POST/api/magic-write/variationsCreate content variations

Analytics & Tracking

Track performance, conversions, and user behavior

GET/api/analytics/dashboardGet dashboard overview
GET/api/analytics/quiz/{id}Get quiz performance metrics
GET/api/analytics/cohortAnalyze user cohorts
POST/api/tracking/eventsTrack custom events
GET/api/marketing/roiCalculate marketing ROI
GET/api/analytics/conversionsGet conversion funnel data

Ads Platform

Manage Facebook and Google ad campaigns

GET/api/ads/campaignsList all ad campaigns
POST/api/ads/campaignsCreate new campaign
GET/api/ads/accountsList connected ad accounts
GET/api/ads/insightsGet campaign insights
POST/api/ads/ai/analyzeAI-powered campaign analysis
POST/api/ads/copy/generateGenerate ad copy with AI
GET/api/ads/oauth/facebookConnect Facebook Ads
GET/api/ads/oauth/googleConnect Google Ads

E-commerce & Payments

Process payments, manage products and orders

GET/api/productsList all products
POST/api/productsCreate new product
GET/api/ordersList all orders
POST/api/ordersCreate new order
GET/api/orders/{id}Get order details
GET/api/payment-gatewaysList payment gateways
POST/api/upsellsCreate upsell offers
GET/api/invoicesList invoices

Templates & Themes

Access pre-built templates and customize themes

GET/api/templatesList all templates
GET/api/templates/{id}Get template details
GET/api/funnel-templatesList funnel templates
GET/api/themesList available themes
POST/api/themesCreate custom theme

Media & Assets

Upload and manage media files and assets

GET/api/media-libraryList media files
POST/api/media-libraryUpload new file
DELETE/api/media-library/{id}Delete media file
GET/api/media-library/{id}Get file details

Security & Compliance

Security features, audit logs, and rate limiting

GET/api/security/audit-logsGet audit logs
POST/api/security/rate-limitCheck rate limit status
GET/api/security/sessionsList active sessions
POST/api/security/2fa/enableEnable two-factor auth

Settings & Configuration

Manage application settings and configurations

GET/api/settings/publicGet public settings
GET/api/admin/settings/api-keysManage API credentials
POST/api/admin/settings/api-keysSave API credentials
GET/api/domainsList custom domains
POST/api/domainsAdd custom domain

Response Format

Success Response

{
  "success": true,
  "data": {
    "id": 123,
    "title": "My Quiz",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

Error Response

{
  "success": false,
  "error": "Unauthorized",
  "message": "Invalid API token",
  "code": 401
}

Rate Limits

Fair usage policies to ensure optimal performance for all users

Free

100 req/hour

Per API key

Pro

1,000 req/hour

Per API key

Enterprise

10,000 req/hour

Per API key

Ready to Start Building?

Create your free account and get your API key in seconds

Get Started FreeContact Sales