Outbound Search

Create outbound search task with keywords and requirements

Creates a new outbound search task by storing keywords and hard requirements in the unified outbound_keywords table.

  • Supports both campaign-linked and standalone keyword tasks
  • Processes keywords for TikTok, Instagram, and YouTube platforms
  • Validates hard requirements including view counts, follower counts, and geographic filters
  • Stores keywords with priority and notes for search execution
  • Returns created keyword entries with their IDs for tracking
post/api/v1/search/outbound/create-task

Request

  • Base URL: https://api.kolect.com
  • URL: https://api.kolect.com/api/v1/search/outbound/create-task
  • Auth: HTTP bearer

Request body

campaign_idstring uuid

Campaign ID to link keywords to (optional for standalone tasks)

max_videos_per_keywordinteger

Maximum number of videos to process per keyword

priorityinteger

Task priority level (0 = lowest, 10 = highest)

notesstring

Additional notes or context for the search task

Example request

{
  "campaign_id": "123e4567-e89b-12d3-a456-426614174000",
  "keywords": {
    "tiktok": [
      "fitness",
      "workout",
      "gym"
    ],
    "instagram": [
      "fashion",
      "style",
      "ootd"
    ],
    "youtube": [
      "tech review",
      "gadgets",
      "unboxing"
    ]
  },
  "hard_requirements": {
    "median_views_low": 10000,
    "median_views_high": 1000000,
    "followers_low": 5000,
    "followers_high": 500000,
    "countries": [
      "US",
      "CA",
      "UK"
    ]
  },
  "max_videos_per_keyword": 1500,
  "priority": 5,
  "notes": "Focus on micro-influencers in fitness niche"
}

Response

Search task created successfully

successboolean
messagestring

Example response

{
  "success": true,
  "message": "Outbound search task created successfully"
}

Changes

No recorded changes to this operation across all 1 revision of this API.