Search
Batch Processing

Process multiple search queries in batch

Processes an array of search queries where each query includes campaign/requirement information and search parameters. For each query:

  1. Generates keywords using campaign data and specified channels
  2. Extracts hard requirements (countries, view/follower ranges)
  3. Calls /api/search-new/dispatch-mode for each channel with generated keywords (do not wait for term search to complete)
  4. Returns consolidated results from all searches
post/api/search-new-batch

Request

  • Base URL: https://api.kolect.com
  • URL: https://api.kolect.com/api/search-new-batch
  • Auth: HTTP bearer

Request body

test_modeboolean

Enable test mode for debugging purposes

Response

Batch search completed successfully

successboolean required
total_queries_processedinteger required

Total number of queries processed

total_channels_processedinteger required

Total number of channels processed across all queries

total_keywords_generatedinteger required

Total number of keywords generated across all queries

total_kols_foundinteger required

Total number of KOLs found across all searches

Example response

{
  "success": true,
  "total_queries_processed": 2,
  "total_channels_processed": 3,
  "total_keywords_generated": 45,
  "total_kols_found": 128,
  "summary": {
    "successful_searches": 2,
    "failed_searches": 1,
    "processing_time_seconds": 4.235
  }
}

Changes

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