Search athletes (V2)

curl --request POST \
  --url http://localhost/mogl/mogl-backend/api/searchAthleteV2 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sortBy": "name",
  "filterByMultiParameter": "<string>",
  "filterByAthleteName": [
    "<string>"
  ],
  "filterByAthleteID": "<string>",
  "filterByName": "<string>",
  "filterBySchool": [
    123
  ],
  "filterByLocation": "<string>",
  "filterByPrice": "<string>",
  "filterByPlatform": false,
  "genderSelect": false,
  "eligibilitySelect": false,
  "gender": [
    "<string>"
  ],
  "is_current_athlete": "Y",
  "filterByTeam": "<string>",
  "filterskillsSearchKeywords": [
    "<string>"
  ],
  "filterBusinessCategorySearchKeywords": [
    123
  ],
  "filterSportsSearchKeywords": [
    123
  ],
  "filterPlatFormSearchKeywords": [],
  "filterByInstaMin": "<string>",
  "filterByInstaMax": "<string>",
  "filterByTwitterMin": "<string>",
  "filterByTwitterMax": "<string>",
  "filterByTiktokMin": "<string>",
  "filterByTiktokMax": "<string>",
  "filterByRating": 123,
  "filterByLatLong": [],
  "filterByDistanceInMiles": 123,
  "filterByDivisions": [
    "<string>"
  ],
  "filterByConference": [
    "<string>"
  ],
  "filterBySelectedLocation": "<string>",
  "view": "public",
  "sortiOsByLatLong": [
    123
  ],
  "audienceTarget": {
    "ageRanges": [
      "25_34"
    ],
    "gender": "male",
    "stateCodes": [
      "AL"
    ]
  },
  "sort": {
    "field": "estimated_target_audience",
    "direction": "desc"
  }
}
'

import requests

url = "http://localhost/mogl/mogl-backend/api/searchAthleteV2"

payload = {
    "sortBy": "name",
    "filterByMultiParameter": "<string>",
    "filterByAthleteName": ["<string>"],
    "filterByAthleteID": "<string>",
    "filterByName": "<string>",
    "filterBySchool": [123],
    "filterByLocation": "<string>",
    "filterByPrice": "<string>",
    "filterByPlatform": False,
    "genderSelect": False,
    "eligibilitySelect": False,
    "gender": ["<string>"],
    "is_current_athlete": "Y",
    "filterByTeam": "<string>",
    "filterskillsSearchKeywords": ["<string>"],
    "filterBusinessCategorySearchKeywords": [123],
    "filterSportsSearchKeywords": [123],
    "filterPlatFormSearchKeywords": [],
    "filterByInstaMin": "<string>",
    "filterByInstaMax": "<string>",
    "filterByTwitterMin": "<string>",
    "filterByTwitterMax": "<string>",
    "filterByTiktokMin": "<string>",
    "filterByTiktokMax": "<string>",
    "filterByRating": 123,
    "filterByLatLong": [],
    "filterByDistanceInMiles": 123,
    "filterByDivisions": ["<string>"],
    "filterByConference": ["<string>"],
    "filterBySelectedLocation": "<string>",
    "view": "public",
    "sortiOsByLatLong": [123],
    "audienceTarget": {
        "ageRanges": ["25_34"],
        "gender": "male",
        "stateCodes": ["AL"]
    },
    "sort": {
        "field": "estimated_target_audience",
        "direction": "desc"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    sortBy: 'name',
    filterByMultiParameter: '<string>',
    filterByAthleteName: ['<string>'],
    filterByAthleteID: '<string>',
    filterByName: '<string>',
    filterBySchool: [123],
    filterByLocation: '<string>',
    filterByPrice: '<string>',
    filterByPlatform: false,
    genderSelect: false,
    eligibilitySelect: false,
    gender: ['<string>'],
    is_current_athlete: 'Y',
    filterByTeam: '<string>',
    filterskillsSearchKeywords: ['<string>'],
    filterBusinessCategorySearchKeywords: [123],
    filterSportsSearchKeywords: [123],
    filterPlatFormSearchKeywords: [],
    filterByInstaMin: '<string>',
    filterByInstaMax: '<string>',
    filterByTwitterMin: '<string>',
    filterByTwitterMax: '<string>',
    filterByTiktokMin: '<string>',
    filterByTiktokMax: '<string>',
    filterByRating: 123,
    filterByLatLong: [],
    filterByDistanceInMiles: 123,
    filterByDivisions: ['<string>'],
    filterByConference: ['<string>'],
    filterBySelectedLocation: '<string>',
    view: 'public',
    sortiOsByLatLong: [123],
    audienceTarget: {ageRanges: ['25_34'], gender: 'male', stateCodes: ['AL']},
    sort: {field: 'estimated_target_audience', direction: 'desc'}
  })
};

fetch('http://localhost/mogl/mogl-backend/api/searchAthleteV2', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/mogl/mogl-backend/api/searchAthleteV2",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'sortBy' => 'name',
    'filterByMultiParameter' => '<string>',
    'filterByAthleteName' => [
        '<string>'
    ],
    'filterByAthleteID' => '<string>',
    'filterByName' => '<string>',
    'filterBySchool' => [
        123
    ],
    'filterByLocation' => '<string>',
    'filterByPrice' => '<string>',
    'filterByPlatform' => false,
    'genderSelect' => false,
    'eligibilitySelect' => false,
    'gender' => [
        '<string>'
    ],
    'is_current_athlete' => 'Y',
    'filterByTeam' => '<string>',
    'filterskillsSearchKeywords' => [
        '<string>'
    ],
    'filterBusinessCategorySearchKeywords' => [
        123
    ],
    'filterSportsSearchKeywords' => [
        123
    ],
    'filterPlatFormSearchKeywords' => [
        
    ],
    'filterByInstaMin' => '<string>',
    'filterByInstaMax' => '<string>',
    'filterByTwitterMin' => '<string>',
    'filterByTwitterMax' => '<string>',
    'filterByTiktokMin' => '<string>',
    'filterByTiktokMax' => '<string>',
    'filterByRating' => 123,
    'filterByLatLong' => [
        
    ],
    'filterByDistanceInMiles' => 123,
    'filterByDivisions' => [
        '<string>'
    ],
    'filterByConference' => [
        '<string>'
    ],
    'filterBySelectedLocation' => '<string>',
    'view' => 'public',
    'sortiOsByLatLong' => [
        123
    ],
    'audienceTarget' => [
        'ageRanges' => [
                '25_34'
        ],
        'gender' => 'male',
        'stateCodes' => [
                'AL'
        ]
    ],
    'sort' => [
        'field' => 'estimated_target_audience',
        'direction' => 'desc'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost/mogl/mogl-backend/api/searchAthleteV2"

	payload := strings.NewReader("{\n  \"sortBy\": \"name\",\n  \"filterByMultiParameter\": \"<string>\",\n  \"filterByAthleteName\": [\n    \"<string>\"\n  ],\n  \"filterByAthleteID\": \"<string>\",\n  \"filterByName\": \"<string>\",\n  \"filterBySchool\": [\n    123\n  ],\n  \"filterByLocation\": \"<string>\",\n  \"filterByPrice\": \"<string>\",\n  \"filterByPlatform\": false,\n  \"genderSelect\": false,\n  \"eligibilitySelect\": false,\n  \"gender\": [\n    \"<string>\"\n  ],\n  \"is_current_athlete\": \"Y\",\n  \"filterByTeam\": \"<string>\",\n  \"filterskillsSearchKeywords\": [\n    \"<string>\"\n  ],\n  \"filterBusinessCategorySearchKeywords\": [\n    123\n  ],\n  \"filterSportsSearchKeywords\": [\n    123\n  ],\n  \"filterPlatFormSearchKeywords\": [],\n  \"filterByInstaMin\": \"<string>\",\n  \"filterByInstaMax\": \"<string>\",\n  \"filterByTwitterMin\": \"<string>\",\n  \"filterByTwitterMax\": \"<string>\",\n  \"filterByTiktokMin\": \"<string>\",\n  \"filterByTiktokMax\": \"<string>\",\n  \"filterByRating\": 123,\n  \"filterByLatLong\": [],\n  \"filterByDistanceInMiles\": 123,\n  \"filterByDivisions\": [\n    \"<string>\"\n  ],\n  \"filterByConference\": [\n    \"<string>\"\n  ],\n  \"filterBySelectedLocation\": \"<string>\",\n  \"view\": \"public\",\n  \"sortiOsByLatLong\": [\n    123\n  ],\n  \"audienceTarget\": {\n    \"ageRanges\": [\n      \"25_34\"\n    ],\n    \"gender\": \"male\",\n    \"stateCodes\": [\n      \"AL\"\n    ]\n  },\n  \"sort\": {\n    \"field\": \"estimated_target_audience\",\n    \"direction\": \"desc\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("http://localhost/mogl/mogl-backend/api/searchAthleteV2")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"sortBy\": \"name\",\n  \"filterByMultiParameter\": \"<string>\",\n  \"filterByAthleteName\": [\n    \"<string>\"\n  ],\n  \"filterByAthleteID\": \"<string>\",\n  \"filterByName\": \"<string>\",\n  \"filterBySchool\": [\n    123\n  ],\n  \"filterByLocation\": \"<string>\",\n  \"filterByPrice\": \"<string>\",\n  \"filterByPlatform\": false,\n  \"genderSelect\": false,\n  \"eligibilitySelect\": false,\n  \"gender\": [\n    \"<string>\"\n  ],\n  \"is_current_athlete\": \"Y\",\n  \"filterByTeam\": \"<string>\",\n  \"filterskillsSearchKeywords\": [\n    \"<string>\"\n  ],\n  \"filterBusinessCategorySearchKeywords\": [\n    123\n  ],\n  \"filterSportsSearchKeywords\": [\n    123\n  ],\n  \"filterPlatFormSearchKeywords\": [],\n  \"filterByInstaMin\": \"<string>\",\n  \"filterByInstaMax\": \"<string>\",\n  \"filterByTwitterMin\": \"<string>\",\n  \"filterByTwitterMax\": \"<string>\",\n  \"filterByTiktokMin\": \"<string>\",\n  \"filterByTiktokMax\": \"<string>\",\n  \"filterByRating\": 123,\n  \"filterByLatLong\": [],\n  \"filterByDistanceInMiles\": 123,\n  \"filterByDivisions\": [\n    \"<string>\"\n  ],\n  \"filterByConference\": [\n    \"<string>\"\n  ],\n  \"filterBySelectedLocation\": \"<string>\",\n  \"view\": \"public\",\n  \"sortiOsByLatLong\": [\n    123\n  ],\n  \"audienceTarget\": {\n    \"ageRanges\": [\n      \"25_34\"\n    ],\n    \"gender\": \"male\",\n    \"stateCodes\": [\n      \"AL\"\n    ]\n  },\n  \"sort\": {\n    \"field\": \"estimated_target_audience\",\n    \"direction\": \"desc\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://localhost/mogl/mogl-backend/api/searchAthleteV2")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"sortBy\": \"name\",\n  \"filterByMultiParameter\": \"<string>\",\n  \"filterByAthleteName\": [\n    \"<string>\"\n  ],\n  \"filterByAthleteID\": \"<string>\",\n  \"filterByName\": \"<string>\",\n  \"filterBySchool\": [\n    123\n  ],\n  \"filterByLocation\": \"<string>\",\n  \"filterByPrice\": \"<string>\",\n  \"filterByPlatform\": false,\n  \"genderSelect\": false,\n  \"eligibilitySelect\": false,\n  \"gender\": [\n    \"<string>\"\n  ],\n  \"is_current_athlete\": \"Y\",\n  \"filterByTeam\": \"<string>\",\n  \"filterskillsSearchKeywords\": [\n    \"<string>\"\n  ],\n  \"filterBusinessCategorySearchKeywords\": [\n    123\n  ],\n  \"filterSportsSearchKeywords\": [\n    123\n  ],\n  \"filterPlatFormSearchKeywords\": [],\n  \"filterByInstaMin\": \"<string>\",\n  \"filterByInstaMax\": \"<string>\",\n  \"filterByTwitterMin\": \"<string>\",\n  \"filterByTwitterMax\": \"<string>\",\n  \"filterByTiktokMin\": \"<string>\",\n  \"filterByTiktokMax\": \"<string>\",\n  \"filterByRating\": 123,\n  \"filterByLatLong\": [],\n  \"filterByDistanceInMiles\": 123,\n  \"filterByDivisions\": [\n    \"<string>\"\n  ],\n  \"filterByConference\": [\n    \"<string>\"\n  ],\n  \"filterBySelectedLocation\": \"<string>\",\n  \"view\": \"public\",\n  \"sortiOsByLatLong\": [\n    123\n  ],\n  \"audienceTarget\": {\n    \"ageRanges\": [\n      \"25_34\"\n    ],\n    \"gender\": \"male\",\n    \"stateCodes\": [\n      \"AL\"\n    ]\n  },\n  \"sort\": {\n    \"field\": \"estimated_target_audience\",\n    \"direction\": \"desc\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "estimatedMatchingFollowers": 6,
  "audienceMatchBreakdown": {
    "ageShare": 0.7,
    "genderShare": 0.73,
    "locationShare": 0.01
  },
  "audienceDataUpdatedAt": "2026-07-01T00:00:00+00:00",
  "calculationMethod": "marginal_independence_v1"
}

POST

searchAthleteV2

Search athletes (V2)

curl --request POST \
  --url http://localhost/mogl/mogl-backend/api/searchAthleteV2 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sortBy": "name",
  "filterByMultiParameter": "<string>",
  "filterByAthleteName": [
    "<string>"
  ],
  "filterByAthleteID": "<string>",
  "filterByName": "<string>",
  "filterBySchool": [
    123
  ],
  "filterByLocation": "<string>",
  "filterByPrice": "<string>",
  "filterByPlatform": false,
  "genderSelect": false,
  "eligibilitySelect": false,
  "gender": [
    "<string>"
  ],
  "is_current_athlete": "Y",
  "filterByTeam": "<string>",
  "filterskillsSearchKeywords": [
    "<string>"
  ],
  "filterBusinessCategorySearchKeywords": [
    123
  ],
  "filterSportsSearchKeywords": [
    123
  ],
  "filterPlatFormSearchKeywords": [],
  "filterByInstaMin": "<string>",
  "filterByInstaMax": "<string>",
  "filterByTwitterMin": "<string>",
  "filterByTwitterMax": "<string>",
  "filterByTiktokMin": "<string>",
  "filterByTiktokMax": "<string>",
  "filterByRating": 123,
  "filterByLatLong": [],
  "filterByDistanceInMiles": 123,
  "filterByDivisions": [
    "<string>"
  ],
  "filterByConference": [
    "<string>"
  ],
  "filterBySelectedLocation": "<string>",
  "view": "public",
  "sortiOsByLatLong": [
    123
  ],
  "audienceTarget": {
    "ageRanges": [
      "25_34"
    ],
    "gender": "male",
    "stateCodes": [
      "AL"
    ]
  },
  "sort": {
    "field": "estimated_target_audience",
    "direction": "desc"
  }
}
'

import requests

url = "http://localhost/mogl/mogl-backend/api/searchAthleteV2"

payload = {
    "sortBy": "name",
    "filterByMultiParameter": "<string>",
    "filterByAthleteName": ["<string>"],
    "filterByAthleteID": "<string>",
    "filterByName": "<string>",
    "filterBySchool": [123],
    "filterByLocation": "<string>",
    "filterByPrice": "<string>",
    "filterByPlatform": False,
    "genderSelect": False,
    "eligibilitySelect": False,
    "gender": ["<string>"],
    "is_current_athlete": "Y",
    "filterByTeam": "<string>",
    "filterskillsSearchKeywords": ["<string>"],
    "filterBusinessCategorySearchKeywords": [123],
    "filterSportsSearchKeywords": [123],
    "filterPlatFormSearchKeywords": [],
    "filterByInstaMin": "<string>",
    "filterByInstaMax": "<string>",
    "filterByTwitterMin": "<string>",
    "filterByTwitterMax": "<string>",
    "filterByTiktokMin": "<string>",
    "filterByTiktokMax": "<string>",
    "filterByRating": 123,
    "filterByLatLong": [],
    "filterByDistanceInMiles": 123,
    "filterByDivisions": ["<string>"],
    "filterByConference": ["<string>"],
    "filterBySelectedLocation": "<string>",
    "view": "public",
    "sortiOsByLatLong": [123],
    "audienceTarget": {
        "ageRanges": ["25_34"],
        "gender": "male",
        "stateCodes": ["AL"]
    },
    "sort": {
        "field": "estimated_target_audience",
        "direction": "desc"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    sortBy: 'name',
    filterByMultiParameter: '<string>',
    filterByAthleteName: ['<string>'],
    filterByAthleteID: '<string>',
    filterByName: '<string>',
    filterBySchool: [123],
    filterByLocation: '<string>',
    filterByPrice: '<string>',
    filterByPlatform: false,
    genderSelect: false,
    eligibilitySelect: false,
    gender: ['<string>'],
    is_current_athlete: 'Y',
    filterByTeam: '<string>',
    filterskillsSearchKeywords: ['<string>'],
    filterBusinessCategorySearchKeywords: [123],
    filterSportsSearchKeywords: [123],
    filterPlatFormSearchKeywords: [],
    filterByInstaMin: '<string>',
    filterByInstaMax: '<string>',
    filterByTwitterMin: '<string>',
    filterByTwitterMax: '<string>',
    filterByTiktokMin: '<string>',
    filterByTiktokMax: '<string>',
    filterByRating: 123,
    filterByLatLong: [],
    filterByDistanceInMiles: 123,
    filterByDivisions: ['<string>'],
    filterByConference: ['<string>'],
    filterBySelectedLocation: '<string>',
    view: 'public',
    sortiOsByLatLong: [123],
    audienceTarget: {ageRanges: ['25_34'], gender: 'male', stateCodes: ['AL']},
    sort: {field: 'estimated_target_audience', direction: 'desc'}
  })
};

fetch('http://localhost/mogl/mogl-backend/api/searchAthleteV2', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/mogl/mogl-backend/api/searchAthleteV2",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'sortBy' => 'name',
    'filterByMultiParameter' => '<string>',
    'filterByAthleteName' => [
        '<string>'
    ],
    'filterByAthleteID' => '<string>',
    'filterByName' => '<string>',
    'filterBySchool' => [
        123
    ],
    'filterByLocation' => '<string>',
    'filterByPrice' => '<string>',
    'filterByPlatform' => false,
    'genderSelect' => false,
    'eligibilitySelect' => false,
    'gender' => [
        '<string>'
    ],
    'is_current_athlete' => 'Y',
    'filterByTeam' => '<string>',
    'filterskillsSearchKeywords' => [
        '<string>'
    ],
    'filterBusinessCategorySearchKeywords' => [
        123
    ],
    'filterSportsSearchKeywords' => [
        123
    ],
    'filterPlatFormSearchKeywords' => [
        
    ],
    'filterByInstaMin' => '<string>',
    'filterByInstaMax' => '<string>',
    'filterByTwitterMin' => '<string>',
    'filterByTwitterMax' => '<string>',
    'filterByTiktokMin' => '<string>',
    'filterByTiktokMax' => '<string>',
    'filterByRating' => 123,
    'filterByLatLong' => [
        
    ],
    'filterByDistanceInMiles' => 123,
    'filterByDivisions' => [
        '<string>'
    ],
    'filterByConference' => [
        '<string>'
    ],
    'filterBySelectedLocation' => '<string>',
    'view' => 'public',
    'sortiOsByLatLong' => [
        123
    ],
    'audienceTarget' => [
        'ageRanges' => [
                '25_34'
        ],
        'gender' => 'male',
        'stateCodes' => [
                'AL'
        ]
    ],
    'sort' => [
        'field' => 'estimated_target_audience',
        'direction' => 'desc'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost/mogl/mogl-backend/api/searchAthleteV2"

	payload := strings.NewReader("{\n  \"sortBy\": \"name\",\n  \"filterByMultiParameter\": \"<string>\",\n  \"filterByAthleteName\": [\n    \"<string>\"\n  ],\n  \"filterByAthleteID\": \"<string>\",\n  \"filterByName\": \"<string>\",\n  \"filterBySchool\": [\n    123\n  ],\n  \"filterByLocation\": \"<string>\",\n  \"filterByPrice\": \"<string>\",\n  \"filterByPlatform\": false,\n  \"genderSelect\": false,\n  \"eligibilitySelect\": false,\n  \"gender\": [\n    \"<string>\"\n  ],\n  \"is_current_athlete\": \"Y\",\n  \"filterByTeam\": \"<string>\",\n  \"filterskillsSearchKeywords\": [\n    \"<string>\"\n  ],\n  \"filterBusinessCategorySearchKeywords\": [\n    123\n  ],\n  \"filterSportsSearchKeywords\": [\n    123\n  ],\n  \"filterPlatFormSearchKeywords\": [],\n  \"filterByInstaMin\": \"<string>\",\n  \"filterByInstaMax\": \"<string>\",\n  \"filterByTwitterMin\": \"<string>\",\n  \"filterByTwitterMax\": \"<string>\",\n  \"filterByTiktokMin\": \"<string>\",\n  \"filterByTiktokMax\": \"<string>\",\n  \"filterByRating\": 123,\n  \"filterByLatLong\": [],\n  \"filterByDistanceInMiles\": 123,\n  \"filterByDivisions\": [\n    \"<string>\"\n  ],\n  \"filterByConference\": [\n    \"<string>\"\n  ],\n  \"filterBySelectedLocation\": \"<string>\",\n  \"view\": \"public\",\n  \"sortiOsByLatLong\": [\n    123\n  ],\n  \"audienceTarget\": {\n    \"ageRanges\": [\n      \"25_34\"\n    ],\n    \"gender\": \"male\",\n    \"stateCodes\": [\n      \"AL\"\n    ]\n  },\n  \"sort\": {\n    \"field\": \"estimated_target_audience\",\n    \"direction\": \"desc\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("http://localhost/mogl/mogl-backend/api/searchAthleteV2")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"sortBy\": \"name\",\n  \"filterByMultiParameter\": \"<string>\",\n  \"filterByAthleteName\": [\n    \"<string>\"\n  ],\n  \"filterByAthleteID\": \"<string>\",\n  \"filterByName\": \"<string>\",\n  \"filterBySchool\": [\n    123\n  ],\n  \"filterByLocation\": \"<string>\",\n  \"filterByPrice\": \"<string>\",\n  \"filterByPlatform\": false,\n  \"genderSelect\": false,\n  \"eligibilitySelect\": false,\n  \"gender\": [\n    \"<string>\"\n  ],\n  \"is_current_athlete\": \"Y\",\n  \"filterByTeam\": \"<string>\",\n  \"filterskillsSearchKeywords\": [\n    \"<string>\"\n  ],\n  \"filterBusinessCategorySearchKeywords\": [\n    123\n  ],\n  \"filterSportsSearchKeywords\": [\n    123\n  ],\n  \"filterPlatFormSearchKeywords\": [],\n  \"filterByInstaMin\": \"<string>\",\n  \"filterByInstaMax\": \"<string>\",\n  \"filterByTwitterMin\": \"<string>\",\n  \"filterByTwitterMax\": \"<string>\",\n  \"filterByTiktokMin\": \"<string>\",\n  \"filterByTiktokMax\": \"<string>\",\n  \"filterByRating\": 123,\n  \"filterByLatLong\": [],\n  \"filterByDistanceInMiles\": 123,\n  \"filterByDivisions\": [\n    \"<string>\"\n  ],\n  \"filterByConference\": [\n    \"<string>\"\n  ],\n  \"filterBySelectedLocation\": \"<string>\",\n  \"view\": \"public\",\n  \"sortiOsByLatLong\": [\n    123\n  ],\n  \"audienceTarget\": {\n    \"ageRanges\": [\n      \"25_34\"\n    ],\n    \"gender\": \"male\",\n    \"stateCodes\": [\n      \"AL\"\n    ]\n  },\n  \"sort\": {\n    \"field\": \"estimated_target_audience\",\n    \"direction\": \"desc\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://localhost/mogl/mogl-backend/api/searchAthleteV2")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"sortBy\": \"name\",\n  \"filterByMultiParameter\": \"<string>\",\n  \"filterByAthleteName\": [\n    \"<string>\"\n  ],\n  \"filterByAthleteID\": \"<string>\",\n  \"filterByName\": \"<string>\",\n  \"filterBySchool\": [\n    123\n  ],\n  \"filterByLocation\": \"<string>\",\n  \"filterByPrice\": \"<string>\",\n  \"filterByPlatform\": false,\n  \"genderSelect\": false,\n  \"eligibilitySelect\": false,\n  \"gender\": [\n    \"<string>\"\n  ],\n  \"is_current_athlete\": \"Y\",\n  \"filterByTeam\": \"<string>\",\n  \"filterskillsSearchKeywords\": [\n    \"<string>\"\n  ],\n  \"filterBusinessCategorySearchKeywords\": [\n    123\n  ],\n  \"filterSportsSearchKeywords\": [\n    123\n  ],\n  \"filterPlatFormSearchKeywords\": [],\n  \"filterByInstaMin\": \"<string>\",\n  \"filterByInstaMax\": \"<string>\",\n  \"filterByTwitterMin\": \"<string>\",\n  \"filterByTwitterMax\": \"<string>\",\n  \"filterByTiktokMin\": \"<string>\",\n  \"filterByTiktokMax\": \"<string>\",\n  \"filterByRating\": 123,\n  \"filterByLatLong\": [],\n  \"filterByDistanceInMiles\": 123,\n  \"filterByDivisions\": [\n    \"<string>\"\n  ],\n  \"filterByConference\": [\n    \"<string>\"\n  ],\n  \"filterBySelectedLocation\": \"<string>\",\n  \"view\": \"public\",\n  \"sortiOsByLatLong\": [\n    123\n  ],\n  \"audienceTarget\": {\n    \"ageRanges\": [\n      \"25_34\"\n    ],\n    \"gender\": \"male\",\n    \"stateCodes\": [\n      \"AL\"\n    ]\n  },\n  \"sort\": {\n    \"field\": \"estimated_target_audience\",\n    \"direction\": \"desc\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "estimatedMatchingFollowers": 6,
  "audienceMatchBreakdown": {
    "ageShare": 0.7,
    "genderShare": 0.73,
    "locationShare": 0.01
  },
  "audienceDataUpdatedAt": "2026-07-01T00:00:00+00:00",
  "calculationMethod": "marginal_independence_v1"
}

Authorizations

Authorization

string

header

required

JWT Bearer token authentication. Use the /api/login endpoint to obtain a token.

Query Parameters

page

integer

Page number

Example:

1

page_limit

integer

Items per page (default 10)

Example:

10

Body

application/json

sortBy

string | null

Sort field (e.g. name)

Example:

"name"

filterByMultiParameter

string | null

General search keyword (name or school)

filterByAthleteName

string[] | null

Filter by athlete name(s)

filterByAthleteID

string | null

Filter by athlete ID(s), comma-separated

filterByName

string | null

Filter by name

filterBySchool

integer[] | null

Filter by school/university ID(s)

filterByLocation

string | null

Filter by location keyword

filterByPrice

string | null

Filter by price

filterByPlatform

boolean | null

Platform filter flag

Example:

false

genderSelect

boolean | null

Gender filter enabled

Example:

false

eligibilitySelect

boolean | null

Eligibility filter enabled

Example:

false

gender

string[] | null

Filter by gender(s)

is_current_athlete

enum<string> | null

Y = current athletes, N = former, empty = all

Available options:

Y,

N,

Example:

"Y"

filterByTeam

string | null

Filter by team

filterskillsSearchKeywords

string[] | null

Filter by skills

filterBusinessCategorySearchKeywords

integer[] | null

Filter by business category IDs

filterSportsSearchKeywords

integer[] | null

Filter by sport category IDs

filterPlatFormSearchKeywords

enum<string>[] | null

Filter by social platforms

Available options:

facebook,

instagram,

twitter,

google,

youtube,

tiktok

filterByInstaMin

string | null

Min Instagram followers

filterByInstaMax

string | null

Max Instagram followers

filterByTwitterMin

string | null

Min Twitter followers

filterByTwitterMax

string | null

Max Twitter followers

filterByTiktokMin

string | null

Min TikTok followers

filterByTiktokMax

string | null

Max TikTok followers

sortOrderInsta

enum<string> | null

Sort by Instagram followers

Available options:

asc,

desc

sortOrderTwitter

enum<string> | null

Sort by Twitter followers

Available options:

asc,

desc

sortOrderTiktok

enum<string> | null

Sort by TikTok followers

Available options:

asc,

desc

sortOrderDistance

enum<string> | null

Sort by distance

Available options:

asc,

desc

filterByRating

number | null

Min star rating (e.g. 3.5)

filterByLatLong

number[] | null

[longitude, latitude] for distance filter

Example:

[]

filterByDistanceInMiles

number | null

Max distance in miles (requires filterByLatLong)

filterByDivisions

string[] | null

Filter by divisions (e.g. NCAA-I-FBS)

filterByConference

string[] | null

Filter by conference names

filterBySelectedLocation

string | null

Selected location label

view

enum<string> | null

View type — 'public' includes non-MOGL athletes

Available options:

public

default_sort_ios

enum<string> | null

iOS default sort mode

Available options:

name_asc,

name_desc,

location,

social_media

sortiOsByLatLong

number[] | null

[longitude, latitude] for iOS distance sort

audienceTarget

object | null

Audience Targeting 2.0. Optional — omit for legacy behavior. Age and location selections are combined and the selected dimensions are multiplied to estimate the matching audience. Athletes missing location data are NOT removed; the available audience data is still used.

Show child attributes

sort

object | null

Audience Match sorting. If a legacy sort (sortOrderInsta / sortOrderTwitter / sortOrderTiktok / sortOrderDistance) is also selected, the legacy sort takes priority and overrides this.

Show child attributes

Response

Paginated athlete list. When audienceTarget is provided, each athlete object additionally includes the audience match fields shown below. estimatedMatchingFollowers may be null when required data (followers or audience data) is unavailable. Requests without audienceTarget are unchanged.

estimatedMatchingFollowers

integer | null

Per-athlete: estimated matching Instagram audience (nullable)

Example:

6

audienceMatchBreakdown

object | null

Per-athlete: share of the audience matched per dimension

Show child attributes

audienceDataUpdatedAt

string<date-time> | null

Example:

"2026-07-01T00:00:00+00:00"

calculationMethod

string

Example:

"marginal_independence_v1"

Core API

University API

Notifications API

Search athletes (V2)

Authorizations

Query Parameters

Body

Response