Sign In Join Hub

Content Requests API

Ethically acquire training data through our content request marketplace

Overview

The Content Requests API allows AI models to request specific content from creators with demographic and geographic targeting. Set your budget, define requirements, and review submissions. Payment is automatically processed with an 80/20 split (creator/platform).

Base URL

https://opttab.com/api/v1/ai

Create Content Request

POST /content-requests

Create a new content request targeting specific demographics, locations, and content types.

Required Parameters

Parameter Type Description
title string Request title (max 255 chars)
description string Detailed description of requirements
content_types array ["video", "image", "audio", "text"]
payment_per_submission decimal Amount to pay per accepted submission
total_budget decimal Total budget for all submissions

Optional Parameters

Parameter Type Description
categories array Content categories (nature, people, objects, etc.)
target_country string ISO country code (e.g., "US", "GB")
target_city string Specific city name
target_age_min integer Minimum age (e.g., 18)
target_age_max integer Maximum age (e.g., 45)
target_gender string "male", "female", "any"
max_submissions integer Maximum submissions to accept
format_specifications object Custom format requirements (resolution, duration, etc.)
expires_at datetime Expiration date (ISO 8601 format)

Example Request

curl -X POST "https://opttab.com/api/v1/ai/content-requests" \
  -H "X-API-Key: opttab_abc123..." \
  -H "X-API-Secret: your-secret-here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Sunset Videos at Beach Locations",
    "description": "Looking for high-quality sunset videos filmed at beaches",
    "content_types": ["video"],
    "categories": ["nature", "travel"],
    "target_country": "US",
    "target_age_min": 18,
    "target_age_max": 45,
    "payment_per_submission": 75.00,
    "total_budget": 5000.00,
    "max_submissions": 100,
    "format_specifications": {
      "resolution": "1080p minimum",
      "duration": "30-60 seconds",
      "format": "MP4 or MOV"
    },
    "expires_at": "2025-12-31T23:59:59Z"
  }'

Example Response

{
  "success": true,
  "data": {
    "id": 42,
    "title": "Sunset Videos at Beach Locations",
    "status": "active",
    "payment_per_submission": 75.00,
    "total_budget": 5000.00,
    "remaining_budget": 5000.00,
    "accepted_submissions": 0,
    "max_submissions": 100,
    "created_at": "2025-10-16T12:00:00Z",
    "expires_at": "2025-12-31T23:59:59Z"
  },
  "message": "Content request created successfully"
}

List Content Requests

GET /content-requests

Retrieve all your content requests with optional filtering.

Query Parameters

  • status - Filter by status: active, completed, closed
  • page - Page number for pagination
  • per_page - Items per page (max: 100)

Example Request

curl "https://opttab.com/api/v1/ai/content-requests?status=active&per_page=20" \
  -H "X-API-Key: opttab_abc123..." \
  -H "X-API-Secret: your-secret-here"

Review Submissions

POST /content-requests/{requestId}/submissions/{submissionId}/review

Accept or reject a content submission. Payment is automatically processed on acceptance.

Important: Payment is automatically deducted from your request's remaining budget when you accept a submission. The creator receives 80% and the platform retains 20%.

Parameters

  • action (required) - "accept" or "reject"
  • review_notes (optional) - Feedback for the creator

Example Request (Accept)

curl -X POST "https://opttab.com/api/v1/ai/content-requests/42/submissions/15/review" \
  -H "X-API-Key: opttab_abc123..." \
  -H "X-API-Secret: your-secret-here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "accept",
    "review_notes": "Perfect quality! Exactly what we needed."
  }'

Example Response

{
  "success": true,
  "data": {
    "submission_id": 15,
    "status": "accepted",
    "payment_processed": true,
    "creator_earnings": 60.00,
    "platform_fee": 15.00,
    "total_payment": 75.00,
    "remaining_budget": 4925.00
  },
  "message": "Submission accepted and payment processed"
}

Payment Model

All content submissions follow an automatic 80/20 revenue split:

80%
Content Creator
Paid directly to creator's balance
20%
Platform Fee
Opttab commission

Best Practices

Clear Requirements

Provide detailed descriptions and format specifications to get better quality submissions.

Fair Pricing

Set competitive payment_per_submission rates to attract quality creators (recommended: $25-$100).

Constructive Feedback

When rejecting, provide detailed review_notes to help creators improve future submissions.

Monitor Budget

Use GET /budget-status to track your spending and remaining budget across all requests.

Next: Submissions API Back to AI Model API