Mavrck Global User Lists API
The GlobalUserLists API from Mavrck — 8 operation(s) for globaluserlists.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/mavrck-globaluserlists-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
version: 1.0.0
description: Identify your most influential customers and activate them to drive more conversions on social.
title: MAVRCK.IO Global User Lists API
servers:
- url: http://app.splashscore.com/v1
- url: https://app.splashscore.com/v1
security:
- apiKey: []
tags:
- name: GlobalUserLists
paths:
/action-groups/{id}/candidates/global-user-lists/{globalUserListId}/members:
post:
tags:
- GlobalUserLists
operationId: createGlobalUserListMemberFromCandidates
x-handler: global_user_lists/global_user_list_member_controller.js
x-access:
- administrator
summary: Add candidates of an action group to a global user list.
parameters:
- name: id
in: path
required: true
description: Unique identifier of the action group that influencers are candidates of.
schema:
type: string
- name: globalUserListId
in: path
required: true
schema:
type: integer
responses:
'200':
description: Members added successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/EmptyObject'
'400':
description: Missing or invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Access forbidden.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Global user list not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
application/json:
schema:
type: object
properties:
globalUserIds:
type: array
items:
type: integer
queryFilter:
$ref: '#/components/schemas/ActionGroupCandidateQueryFilter'
required: true
put:
tags:
- GlobalUserLists
operationId: moveGlobalUserListMemberFromCandidates
x-handler: global_user_lists/global_user_list_member_controller.js
x-access:
- administrator
summary: Move candidates of an action group from one global user list to another.
parameters:
- name: id
in: path
required: true
description: Unique identifier of the action group that influencers are candidates of.
schema:
type: string
- name: globalUserListId
in: path
required: true
schema:
type: integer
responses:
'200':
description: Members moved successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/EmptyObject'
'400':
description: Missing or invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Access forbidden.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Global user list not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
application/json:
schema:
type: object
required:
- fromGlobalUserListIds
properties:
fromGlobalUserListIds:
type: array
items:
type: integer
globalUserIds:
type: array
items:
type: integer
queryFilter:
$ref: '#/components/schemas/ActionGroupCandidateQueryFilter'
required: true
/action-groups/{id}/candidates/global-user-lists/members/remove:
post:
tags:
- GlobalUserLists
operationId: deleteGlobalUserListMemberFromCandidates
x-handler: global_user_lists/global_user_list_member_remove_controller.js
x-access:
- administrator
summary: Remove candidates of an action group from global user lists.
parameters:
- name: id
in: path
required: true
description: Unique identifier of the action group that influencers are candidates of.
schema:
type: string
responses:
'200':
description: Members removed successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/EmptyObject'
'400':
description: Missing or invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Access forbidden.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Global user list not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
application/json:
schema:
type: object
required:
- globalUserListId
properties:
globalUserListId:
type: array
items:
type: integer
globalUserIds:
type: array
items:
type: integer
queryFilter:
$ref: '#/components/schemas/ActionGroupCandidateQueryFilter'
required: true
/global-user-lists:
get:
tags:
- GlobalUserLists
operationId: getGlobalUserLists
x-handler: global_user_lists/global_user_list_controller.js
x-access:
- administrator
summary: Retrieve global user lists.
parameters:
- $ref: '#/components/parameters/orderByParam'
- $ref: '#/components/parameters/limitParam'
- $ref: '#/components/parameters/offsetParam'
- $ref: '#/components/parameters/labelParam'
- name: isArchived
in: query
required: false
schema:
type: boolean
responses:
'200':
description: Collection of global user lists.
content:
application/json:
schema:
type: object
properties:
meta:
$ref: '#/components/schemas/ResponseMetadata'
data:
type: array
items:
$ref: '#/components/schemas/GlobalUserList'
'400':
description: Missing or invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Access forbidden.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
post:
tags:
- GlobalUserLists
operationId: createGlobalUserList
x-handler: global_user_lists/global_user_list_controller.js
x-access:
- administrator
summary: Create a global user list.
responses:
'200':
description: GlobalUserList URI.
content:
application/json:
schema:
type: object
properties:
id:
type: integer
'400':
description: Missing or invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Access forbidden.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
application/json:
schema:
type: object
required:
- label
properties:
label:
type: string
minLength: 1
maxLength: 50
required: true
/global-user-lists/{id}:
get:
tags:
- GlobalUserLists
operationId: getGlobalUserListById
x-handler: global_user_lists/global_user_list_controller.js
x-access:
- administrator
summary: Retrieve a single global user list.
parameters:
- name: id
in: path
required: true
schema:
type: integer
responses:
'200':
description: A single global user list.
content:
application/json:
schema:
$ref: '#/components/schemas/GlobalUserList'
'400':
description: Missing or invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Access forbidden.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Global user list not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
put:
tags:
- GlobalUserLists
operationId: updateGlobalUserList
x-handler: global_user_lists/global_user_list_controller.js
x-access:
- administrator
summary: Update a global user list.
parameters:
- name: id
in: path
required: true
schema:
type: integer
responses:
'200':
description: Update successful.
content:
application/json:
schema:
$ref: '#/components/schemas/EmptyObject'
'400':
description: Missing or invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Access forbidden.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Global user list not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GlobalUserList'
required: true
delete:
tags:
- GlobalUserLists
operationId: destroyGlobalUserList
x-handler: global_user_lists/global_user_list_controller.js
x-access:
- administrator
summary: Delete a global user list.
parameters:
- name: id
in: path
required: true
schema:
type: integer
responses:
'200':
description: Delete successful.
content:
application/json:
schema:
$ref: '#/components/schemas/EmptyObject'
'400':
description: Missing or invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Access forbidden.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Global user list not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/global-user-lists/{id}/archive:
post:
tags:
- GlobalUserLists
operationId: archiveGlobalUserList
x-handler: global_user_lists/global_user_list_definition_archive_controller.js
x-access:
- administrator
summary: Archive a global user list.
parameters:
- name: id
in: path
required: true
schema:
type: integer
responses:
'200':
description: Archive successful.
content:
application/json:
schema:
$ref: '#/components/schemas/EmptyObject'
'400':
description: Missing or invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Access forbidden.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/global-user-lists/{id}/unarchive:
post:
tags:
- GlobalUserLists
operationId: unarchiveGlobalUserList
x-handler: global_user_lists/global_user_list_definition_unarchive_controller.js
x-access:
- administrator
summary: Unarchive a global user list.
parameters:
- name: id
in: path
required: true
schema:
type: integer
responses:
'200':
description: Unarchive successful.
content:
application/json:
schema:
$ref: '#/components/schemas/EmptyObject'
'400':
description: Missing or invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Access forbidden.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/global-user-lists/{globalUserListId}/members:
post:
tags:
- GlobalUserLists
operationId: createGlobalUserListMember
x-handler: global_user_lists/global_user_list_member_controller.js
x-access:
- administrator
summary: Add members to a global user list.
parameters:
- name: globalUserListId
in: path
required: true
schema:
type: integer
responses:
'200':
description: Members added successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/EmptyObject'
'400':
description: Missing or invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Access forbidden.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Global user list not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
application/json:
schema:
type: object
properties:
globalUserIds:
type: array
items:
type: integer
searchState:
type: object
description: Capture Search State for analytics
queryFilter:
$ref: '#/components/schemas/UserQueryFilter'
required: true
put:
tags:
- GlobalUserLists
operationId: moveGlobalUserListMember
x-handler: global_user_lists/global_user_list_member_controller.js
x-access:
- administrator
summary: Move members from one global user list to another.
parameters:
- name: globalUserListId
in: path
required: true
schema:
type: integer
responses:
'200':
description: Members moved successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/EmptyObject'
'400':
description: Missing or invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Access forbidden.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Global user list not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
application/json:
schema:
type: object
required:
- fromGlobalUserListIds
properties:
fromGlobalUserListIds:
type: array
items:
type: integer
globalUserIds:
type: array
items:
type: integer
queryFilter:
$ref: '#/components/schemas/UserQueryFilter'
required: true
/global-user-lists/members-remove:
post:
tags:
- GlobalUserLists
operationId: deleteGlobalUserListMember
x-handler: global_user_lists/global_user_list_member_remove_controller.js
x-access:
- administrator
summary: Remove members from global user lists.
responses:
'200':
description: Members removed successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/EmptyObject'
'400':
description: Missing or invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Access forbidden.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Global user list not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
application/json:
schema:
type: object
required:
- globalUserListId
properties:
globalUserListId:
type: array
items:
type: integer
globalUserIds:
type: array
items:
type: integer
queryFilter:
$ref: '#/components/schemas/UserQueryFilter'
required: true
components:
schemas:
UserSearch:
type: object
additionalProperties: false
properties:
DemographicsPro_Audience_Data_Analysis:
type: object
additionalProperties: false
properties:
DemographicsPro_Audience_Gender_Max:
type: array
x-filter-type: term
items:
type: string
DemographicsPro_Audience_MaritalStatus_Max:
type: array
x-filter-type: term
items:
type: string
DemographicsPro_Audience_ParentalStatus_Max:
type: array
x-filter-type: term
items:
type: string
DemographicsPro_Audience_Age_Max:
type: array
x-filter-type: term
items:
type: string
DemographicsPro_Audience_Race_Max:
type: array
x-filter-type: term
items:
type: string
DemographicsPro_Audience_Language_Max:
type: array
x-filter-type: term
items:
type: string
DemographicsPro_Audience_Country_Max:
type: array
x-filter-type: term
items:
type: string
DemographicsPro_Audience_State_Max:
type: array
x-filter-type: term
items:
type: string
DemographicsPro_Audience_City_Max:
type: array
x-filter-type: term
items:
type: string
DemographicsPro_Audience_EducationStatus_Max:
type: array
x-filter-type: term
items:
type: string
DemographicsPro_Audience_PersonalIncome_Max:
type: array
x-filter-type: term
items:
type: string
DemographicsPro_Audience_Occupation_Max:
type: object
additionalProperties: false
x-filter-type: multiTerm
properties:
quantifier:
type: string
enum:
- any
- all
ids:
type: array
items:
type:
- integer
- string
DemographicsPro_Audience_Industry_Max:
type: object
additionalProperties: false
x-filter-type: multiTerm
properties:
quantifier:
type: string
enum:
- any
- all
ids:
type: array
items:
type:
- integer
- string
DemographicsPro_Audience_Employer_Max:
type: object
additionalProperties: false
x-filter-type: multiTerm
properties:
quantifier:
type: string
enum:
- any
- all
ids:
type: array
items:
type:
- integer
- string
DemographicsPro_Audience_EducationOrganization_Max:
type: object
additionalProperties: false
x-filter-type: multiTerm
properties:
quantifier:
type: string
enum:
- any
- all
ids:
type: array
items:
type:
- integer
- string
DemographicsPro_Audience_LikesAndInterests_Max:
type: object
additionalProperties: false
x-filter-type: multiTerm
properties:
quantifier:
type: string
enum:
- any
- all
ids:
type: array
items:
type:
- integer
- string
DemographicsPro_Audience_PeopleInfluences_Max:
type: object
additionalProperties: false
x-filter-type: multiTerm
properties:
quantifier:
type: string
enum:
- any
- all
ids:
type: array
items:
type:
- integer
- string
DemographicsPro_Audience_MediaInfluences_Max:
type: object
additionalProperties: false
x-filter-type: multiTerm
properties:
quantifier:
type: string
enum:
- any
- all
ids:
type: array
items:
type:
- integer
- string
DemographicsPro_Audience_BrandInfluences_Max:
type: object
additionalProperties: false
x-filter-type: multiTerm
properties:
quantifier:
type: string
enum:
- any
- all
ids:
type: array
items:
type:
- integer
- string
DemographicsPro_Audience_Favorite_MusicGenre_Max:
type: object
additionalProperties: false
x-filter-type: multiTerm
properties:
quantifier:
type: string
enum:
- any
- all
ids:
type: array
items:
type:
- integer
- string
DemographicsPro_Audience_Favorite_MusicSoloArtist_Max:
type: object
additionalProperties: false
x-filter-type: multiTerm
properties:
quantifier:
type: string
enum:
- any
- all
ids:
type: array
items:
type:
- integer
- string
DemographicsPro_Audience_Favorite_MusicBands_Max:
type: object
additionalProperties: false
x-filter-type: multiTerm
properties:
quantifier:
type: string
enum:
- any
- all
ids:
type: array
items:
type:
- integer
- string
DemographicsPro_Audience_SportsFollowed_Max:
type: object
additionalProperties: false
x-filter-type: multiTerm
properties:
quantifier:
type: string
enum:
- any
- all
ids:
type: array
items:
type:
- integer
- string
DemographicsPro_Audience_SportTeamSupported_Max:
type: object
additionalProperties: false
x-filter-type: multiTerm
properties:
quantifier:
type: string
enum:
- any
- all
ids:
type: array
items:
type:
- integer
- string
DemographicsPro_Audience_BrandInfluences_All:
type: object
additionalProperties: false
x-filter-type: multiTerm
properties:
ids:
type: array
items:
type:
- integer
- string
range:
type: object
additionalProperties: false
properties:
$gte:
type: number
$lte:
type: number
DemographicsPro_Audience_Country_All:
type: object
additionalProper
# --- truncated at 32 KB (93 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mavrck/refs/heads/main/openapi/mavrck-globaluserlists-api-openapi.yml