---
title: "Get distinct countries and languages for KOLs by KOL IDs"
method: POST
path: "/api/v1/kols/countries-languages"
tags: ["KOL"]
---

# Get distinct countries and languages for KOLs by KOL IDs

`POST /api/v1/kols/countries-languages`

## Request

- Base URL: `https://api.kolect.com`
- URL: `https://api.kolect.com/api/v1/kols/countries-languages`
- Auth: HTTP bearer

Accepts a list of KOL IDs and returns all distinct countries and languages 
from the kols table for those specific KOLs.
This is useful for filtering and categorizing KOLs by geographic location and language.

## Request body

- object
  - `kol_ids` string[], required: List of KOL IDs to get countries and languages for.

## Response `200`

Successfully fetched distinct countries and languages.

- object
  - `success` boolean
  - `data` object
    - `countries` string[]: List of distinct countries (non-null, non-empty values)
    - `languages` string[]: List of distinct languages (non-null, non-empty values)
  - `metadata` object
    - `total_kol_ids_processed` integer: Number of unique KOL IDs processed
    - `total_kols_found` integer: Total number of KOLs found for the provided KOL IDs
    - `countries_count` integer: Number of distinct countries found
    - `languages_count` integer: Number of distinct languages found
  - `performance` object
    - `query_time_ms` number: Time spent executing the database query
    - `total_time_ms` number: Total time elapsed for the request

## Other responses

- `400`: Invalid request payload.
- `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)