---
title: "Process multiple search queries in batch"
method: POST
path: "/api/search-new-batch"
tags: ["Search", "Batch Processing"]
---

# Process multiple search queries in batch

`POST /api/search-new-batch`

## Request

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

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

## Request body

- object
  - `queries` object[], required: Array of search queries to process
    - `campaign_id` string, uuid: Campaign ID (either this or campaign_requirement_id required)
    - `campaign_requirement_id` string, uuid: Campaign requirement ID (either this or campaign_id required)
    - `search_influencer_query` object, required
      - `query` string, required: Search query string
      - `count` integer, required: Number of results to return per channel
      - `countries` string[], required: List of country codes to filter by
      - `median_views_low` integer, required: Minimum median views requirement
      - `median_views_high` integer, required: Maximum median views requirement
      - `followers_low` integer, required: Minimum follower count requirement
      - `followers_high` integer, required: Maximum follower count requirement
      - `channel` string[], required: List of social media channels to search
      - `keywords_human_input` string[]: 人工输入的关键词（可选）
      - `embedding_type` 'subject_analysis' | 'scene_analysis': Type of embedding to search for - 'subject_analysis' for subject-based content or 'scene_analysis' for scene-based content
  - `test_mode` boolean: Enable test mode for debugging purposes

## Response `200`

Batch search completed successfully

- object
  - `success` boolean, required
  - `total_queries_processed` integer, required: Total number of queries processed
  - `total_channels_processed` integer, required: Total number of channels processed across all queries
  - `total_keywords_generated` integer, required: Total number of keywords generated across all queries
  - `total_kols_found` integer, required: Total number of KOLs found across all searches
  - `results` object[], required: Individual search results for each query/channel combination
    - `query_id` string, required: The campaign_id or campaign_requirement_id
    - `query_type` 'campaign' | 'campaign_requirement', required: Type of query processed
    - `channel` 'tiktok' | 'instagram' | 'youtube', required: Social media channel searched
    - `success` boolean, required: Whether this specific search was successful
    - `data` object: Search results from /api/search-new (only present if success=true)
    - `error` string: Error message (only present if success=false)
    - `keywords_generated` integer: Number of keywords generated for this query/channel
    - `term_ids` string[]: Generated term IDs used in the search
    - `kols_found` integer: Number of KOLs found in this specific search
  - `summary` object, required
    - `successful_searches` integer, required: Number of successful individual searches
    - `failed_searches` integer, required: Number of failed individual searches
    - `processing_time_seconds` number, float, required: Total processing time in seconds

## Other responses

- `400`: Invalid request data
- `500`: Internal server error

---

[API](https://skmtc.dev/kolect/apis/kolect-api.md) · [All operations](https://skmtc.dev/kolect/apis/kolect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolect/apis/kolect-api/revisions/fe54528e8f54?raw)