Mavrck Global Users API

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 Users API
servers:
- url: http://app.splashscore.com/v1
- url: https://app.splashscore.com/v1
security:
- apiKey: []
tags:
- name: GlobalUsers
paths:
  /global-user/{globalUserId}/lists:
    get:
      tags:
      - GlobalUsers
      operationId: getListsForGlobalUser
      x-handler: global_user_lists/global_user_list_controller.js
      x-access:
      - administrator
      summary: Retrieve all lists associated with this global user.
      parameters:
      - name: globalUserId
        in: path
        required: true
        schema:
          type: integer
      - name: isArchived
        in: query
        required: false
        schema:
          type: boolean
      - $ref: '#/components/parameters/orderByParam'
      - $ref: '#/components/parameters/limitParam'
      - $ref: '#/components/parameters/offsetParam'
      responses:
        '200':
          description: A collection of 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'
        '404':
          description: Action not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /global-users/summary:
    get:
      tags:
      - GlobalUsers
      operationId: getGlobalUsersSummary
      x-handler: global_users_summary/global_users_summary_controller.js
      x-access:
      - administrator
      - root
      summary: Retrieve summary of global users.
      parameters:
      - $ref: '#/components/parameters/userFilter'
      - $ref: '#/components/parameters/q'
      - $ref: '#/components/parameters/searchKeywords'
      responses:
        '200':
          description: A summary of global users data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  avg_metrics:
                    type: object
                    properties:
                      members:
                        type: integer
                      totalReach:
                        type: number
                      averageFollowers:
                        type: number
                      averageEngagementRate:
                        type: number
                  top_influencers:
                    type: array
                    items:
                      $ref: '#/components/schemas/GlobalUserDeprecated'
                  topics:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  gender_age:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  country:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  audience_gender:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  fraud_levels:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  audience_country:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  audience_city:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  audience_age:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  reach:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  top_hashtags:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_Age_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_BrandInfluences_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_City_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_Country_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_EducationOrganization_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_EducationStatus_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_Employer_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_Favorite_MusicBands_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_Favorite_MusicGenre_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_Favorite_MusicSoloArtist_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_Gender_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_Industry_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_Language_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_LikesAndInterests_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_MaritalStatus_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_ParentalStatus_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_MediaInfluences_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_Occupation_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_PeopleInfluences_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_PersonalIncome_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_Race_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_SportTeamSupported_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_SportsFollowed_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
                  DemographicsPro_Audience_State_Max:
                    type: array
                    items:
                      type: object
                      properties:
                        display:
                          type: string
                        value:
                          type: number
        '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'
components:
  schemas:
    ResponseMetadata:
      properties:
        limit:
          type: number
          format: double
        offset:
          type: number
          format: double
        status:
          type: string
          enum:
          - failure
          - success
        totalCount:
          type: number
          format: double
      type: object
      additionalProperties: false
    BrandDeprecated:
      type: object
      properties:
        id:
          type: integer
          description: Unique identifier for a brand.
        name:
          type: string
          description: Name of the brand.
        logo:
          type: string
        accentColor:
          type: string
        buttonColor:
          type: string
        associatedWithCampaign:
          type: boolean
          description: A flag indicating whether this brand has been associated with a campaign. If this is true, then this brand cannot be deleted.
    ConversationTemplateDeprecated:
      type: object
      properties:
        id:
          type: integer
        category:
          type: string
        title:
          type: string
        subject:
          type: string
        html:
          type: string
        createdBy:
          $ref: '#/components/schemas/AdministratorDeprecated'
        lastModifiedBy:
          $ref: '#/components/schemas/AdministratorDeprecated'
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
        deliveryMethod:
          type: string
        sendOnEvent:
          type: string
        sendOnDays:
          type: integer
        sendOnTimeframe:
          type: string
        sendOnStatusId:
          type:
          - integer
          - 'null'
        sendOnDate:
          type: string
        slug:
          type: string
        isArchived:
          type: boolean
    BazaarVoiceAppProductDeprecated:
      type: object
      properties:
        reviewProductId:
          type: integer
          description: Product id assigned by Mavrck
        externalBazaarProductId:
          type: string
          description: Product id assigned by BazaarVoice
    IncentiveTermsAndConditionsDeprecated:
      type: object
      properties:
        template:
          x-access:
          - administrator
          - root
          type: string
        preview:
          type: string
        params:
          x-access:
          - administrator
          - root
          type: object
    GlobalUserList:
      type: object
      required:
      - label
      properties:
        id:
          type: integer
        label:
          type: string
          minLength: 1
          maxLength: 50
        createdAt:
          type: string
          format: date-time
    Blog:
      properties:
        globalUserId:
          type:
          - number
          - 'null'
          format: double
        language:
          type:
          - string
          - 'null'
        name:
          type:
          - string
          - 'null'
        platform:
          type:
          - string
          - 'null'
        url:
          type:
          - string
          - 'null'
      type: object
      additionalProperties: false
    NetworkName:
      type: string
      enum:
      - Blog
      - Facebook
      - Facebook Group
      - Facebook Live
      - Facebook Reel
      - Image
      - Instagram
      - Instagram Reel
      - Instagram Story
      - LinkedIn
      - Pinterest
      - Snapchat Story
      - TikTok
      - Twitch Stream
      - Twitter
      - Video
      - YouTube Video
      - YouTube Shorts
    VisualSafeSearchDeprecated:
      type: object
      properties:
        adult:
          type: string
        racy:
          type: string
        medical:
          type: string
        spoof:
          type: string
        violence:
          type: string
    PreviewPostDeprecated:
      type: object
      properties:
        id:
          type: integer
        postId:
          type: string
        network:
          type: string
        likes:
          type: integer
        comments:
          type: integer
        views:
          type: integer
        shares:
          type: integer
        caption:
          type: string
        imageUrl:
          type: string
        link:
          type: string
        isSponsored:
          type: boolean
        mentions:
          type: array
          items:
            type: string
        activation:
          $ref: '#/components/schemas/ActivationDeprecated'
        postedTime:
          type: string
          format: date-time
        visualSafeSearch:
          $ref: '#/components/schemas/VisualSafeSearchDeprecated'
        textSafeSearch:
          $ref: '#/components/schemas/TextSafeSearchDeprecated'
    TextSafeSearchDeprecated:
      type: object
      properties:
        profanityWordCount:
          type: integer
    ReviewFormResponseDeprecated:
      type: object
      properties:
        globalUserId:
          type: integer
        membershipId:
          type: integer
          description: Unique Identifier for the membership
        rating:
          type: integer
          description: Review rating
        reviewCharacterCount:
          type: integer
          description: Sum of the character count in the review
        fullName:
          type: string
          description: Name of the influencer
        profilePic:
          type: string
          description: Profile picture of the influencer
        questionResponses:
          type: array
          items:
            $ref: '#/components/schemas/QuestionResponseDeprecated'
        createdAt:
          type: string
          format: date-time
        reviewForm:
          $ref: '#/components/schemas/ReviewFormDeprecated'
        product:
          $ref: '#/components/schemas/ProductDeprecated'
    ReviewFormDeprecated:
      type: object
      required:
      - questions
      properties:
        id:
          type: integer
          description: id of form
        reviewProductId:
          type: integer
        action:
          $ref: '#/components/schemas/ActionDeprecated'
        product:
          $ref: '#/components/schemas/ProductDeprecated'
        questions:
          type: array
          description: Array of form questions
          items:
            $ref: '#/components/schemas/QuestionDeprecated'
        title:
          type: string
        description:
          type: string
        url:
          type: string
        incentivized:
          x-access:
          - administrator
          - root
          type: boolean
          description: whether the form is incentivized
        responses:
          type: array
          x-access:
          - administrator
          - root
          items:
            type: object
            properties:
              membership:
                $ref: '#/components/schemas/MembershipDeprecated'
              questionResponses:
                type: array
                items:
                  type: object
    MetaInformationDeprecated:
      type: object
      description: This information is pulled when an external network parses the link for meta tags.
      properties:
        title:
          type: string
        description:
          type: string
        image:
          type: string
        ftcHashtag:
          type: string
    ListDeliverable:
      properties:
        contentType:
          $ref: '#/components/schemas/NetworkSlug'
        contentTypeName:
          $ref: '#/components/schemas/NetworkName'
        count:
          type: number
          format: double
        id:
          type: number
          format: double
        listId:
          type: number
          format: double
        updatedBy:
          type: number
          format: double
      required:
      - contentType
      - contentTypeName
      - count
      - id
      - listId
      type: object
      additionalProperties: false
    IncentiveClaimDeprecated:
      type: object
      properties:
        id:
          type: integer
          description: Unique identifier for the incentive claim.
        membershipId:
          type: integer
          x-access:
          - administrator
          - root
        globalUserId:
          type: integer
          x-access:
          - administrator
          - root
        promocode:
          type: string
          description: The issuance of a promo code. This is derived either from a static promo code configured as a property of the incentive resource or dynamically from a uploaded list of codes.
        createdAt:
          format: date-time
          type: string
        profilePictureLink:
          type: string
          x-access:
          - administrator
          - root
        firstName:
          type: string
          x-access:
          - administrator
          - root
        lastName:
          type: string
          x-access:
          - administrator
          - root
        email:
          type: string
          x-access:
          - administrator
          - root
        address:
          type: string
          x-access:
          - administrator
          - root
        age:
          type: integer
          x-access:
          - administrator
          - root
        gender:
          type: string
          x-access:
          - administrator
          - root
        facebookFriendCount:
          type: integer
          x-access:
          - administrator
          - root
        mostRecentRewardFulfilledAt:
          type: string
          format: date-time
          x-access:
          - administrator
          - root
        engagementCount:
          type: integer
        clickCount:
          type: integer
        conversionCount:
          type: integer
    InstagramProfileDeprecated:
      type: object
      properties:
        accessGrant:
          type: object
          properties:
            isExpired:
              type: boolean
            type:
              type: string
              enum:
              - basic
              - business
        averageComments:
          type: integer
        averageEngagements:
          type: integer
        averageLikes:
          type: integer
        audienceFakeCommentersLevel:
          type: string
        audienceFakeCommentersPercentage:
          type: number
        audienceFakeEngagersLevel:
          type: string
        audienceFakeFollowersLevel:
          type: string
        audienceFakeFollowersPercentage:
          type: number
        audienceFakeLikersLevel:
          type: string
        audienceFakeLikersPercentage:
          type: number
        audienceFraudLevel:
          type: string
        audiencePercentageFemale:
          type: number
        audiencePercentage_13_17:
          type: number
        audiencePercentage_18_24:
          type: number
        audiencePercentage_25_34:
          type: number
        audiencePercentage_35_44:
          type: number
        audiencePercentage_45_54:
          type: number
        audiencePercentage_55_64:
          type: number
        audiencePercentage_65_plus:
          type: number
        audiencePredominantAgeRange:
          type: string
        audiencePredominantCity:
          type: string
        audiencePredominantCountry:
          type: string
        bio:
          type: string
        boughtFollowers:
          type: boolean
        engagementRate:
          type: number
        id:
          type: integer
        isBusiness:
          type: boolean
        isPrivate:
          type: boolean
        followersCount:
          type: integer
        followingCount:
          type: integer
        fullName:
          type: string
        handle:
          type: string
        mediaCount:
          type: integer
        nudityLevel:
          type: string
        profanityLevel:
          type: string
        profilePicture:
          type: string
        profileType:
          type: string
          enum:
          - business
          - platform
        sponsoredPostRate:
          type: number
        website:
          type: string
    GlobalUserDeprecated:
      type: object
      properties:
        id:
          type:
          - integer
          - string
        fullName:
          type: string
        firstName:
          type: string
        lastName:
          type: string
        profilePicture:
          type: string
        unverified:
          type: string
          enum:
          - hidden
          - emails
          - excludes
        country:
          type: string
          enum:
          - Afghanistan
          - Albania
          - Algeria
          - American Samoa
          - Andorra
          - Angola
          - Anguilla
          - Antarctica
          - Antigua and Barbuda
          - Argentina
          - Armenia
          - Aruba
          - Australia
          - Austria
          - Azerbaijan
          - Bahrain
          - Bangladesh
          - Barbados
          - Belarus
          - Belgium
          - Belize
          - Benin
          - Bermuda
          - Bhutan
          - Bolivia
          - Bosnia and Herzegovina
          - Botswana
          - Bouvet Island
          - Brazil
          - British Indian Ocean Territory
          - British Virgin Islands
          - Brunei
          - Bulgaria
          - Burkina Faso
          - Burundi
          - Cambodia
          - Cameroon
          - Canada
          - Cape Verde
          - Caribbean Netherlands
          - Cayman Islands
          - Central African Republic
          - Chad
          - Chile
          - China
          - Christmas Island
          - Cocos (Keeling) Islands
          - Collectivity of Saint Martin
          - Colombia
          - Comoros
          - Cook Islands
          - Costa Rica
          - Côte d'Ivoire
          - Croatia
          - Cuba
          - Curaçao
          - Cyprus
          - Czechia
          - Democratic Republic of the Congo
          - Denmark
          - Djibouti
          - Dominica
          - Dominican Republic
          - Ecuador
          - Egypt
          - El Salvador
          - Equatorial Guinea
          - Eritrea
          - Estonia
          - Ethiopia
          - Falkland Islands (Malvinas)
          - Faroe Islands
          - Federated States of Micronesia
          - Fiji
          - Finland
          - France
          - French Guiana
          - French Polynesia
          - French Southern Territories
          - Gabon
          - Georgia
          - Germany
          - Ghana
          - Gibraltar
          - Greece
          - Greenland
          - Grenada
          - Guadeloupe
          - Guam
          - Guatemala
          - Guernsey
          - Guinea
          - Guinea-Bissau
          - Guyana
          - Haiti
          - Heard Island and McDonald Islands
          - Holy See (Vatican City)
          - Honduras
          - Hong Kong
          - Hungary
          - Iceland
          - India
          - Indonesia
          - Iran
          - Iraq
          - Ireland
          - Isle of Man
          - Israel
          - Jamaica
          - Japan
          - Italy
          - Jersey
          - Jordan
          - Kazakhstan
          - Kenya
          - Kiribati
          - Kuwait
          - Kyrgyzstan
          - Laos
          - Latvia
          - Lebanon
          - Lesotho
          - Liberia
          - Libya
          - Liechtenstein
          - Lithuania
          - Luxembourg
          - Macau
          - Macedonia (FYROM)
          - Madagascar
          - Malawi
          - Malaysia
          - Maldives
          - Mali
          - Malta
          - Marshall Islands
          - Martinique
          - Mauritania
          - Mauritius
          - Mayotte
          - Mexico
          - Moldova
          - Monaco
          - Mongolia
          - Montenegro
          - Montserrat
          - Morocco
          - Mozambique
          - Myanmar (Burma)
          - Namibia
          - Nauru
          - Nepal
          - Netherlands
          - New Caledonia
          - New Zealand
          - Nicaragua
          - Niger
          - Nigeria
          - Niue
          - Norfolk Island
          - North Korea
          - Northern Mariana Islands
          - Norway
          - Oman
          - Pakistan
          - Palau
          - Palestine
          - Panama
          - Papua New Guinea
          - Paraguay
          - Peru
          - Philippines
          - Pitcairn
          - Poland
          - Portugal
          - Puerto Rico
          - Qatar
          - Republic of the Congo
          - Reunion
          - Romania
          - Russia
          - Rwanda
          - Saint Helena, Ascension and Tristan da Cunha
          - Saint Kitts and Nevis
          - Saint Lucia
          - Saint Pierre and Miquelon
          - Saint Vincent and the Grenadines
          - Saint-Barthélemy
          - Samoa
          - San Marino
          - Sao Tome and Principe
          - Saudi Arabia
          - Senegal
          - Serbia
          - Seychelles
          - Sierra Leone
          - Singapore
          - Sint Maarten (Dutch part)
          - Slovakia
          - Slovenia
          - Solomon Islands
          - Somalia
          - South Africa
          - South Georgia and the South Sandwich Islands
          - South Korea
          - South Sudan
      

# --- truncated at 32 KB (116 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mavrck/refs/heads/main/openapi/mavrck-globalusers-api-openapi.yml