:doc:`CustomerProfiles <../../customer-profiles>` / Paginator / GetSimilarProfiles

******************
GetSimilarProfiles
******************



.. py:class:: CustomerProfiles.Paginator.GetSimilarProfiles

  ::

    
    paginator = client.get_paginator('get_similar_profiles')

  
  

  .. py:method:: paginate(**kwargs)

    Creates an iterator that will paginate through responses from :py:meth:`CustomerProfiles.Client.get_similar_profiles`.

    See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/customer-profiles-2020-08-15/GetSimilarProfiles>`_    


    **Request Syntax**
    ::

      response_iterator = paginator.paginate(
          DomainName='string',
          MatchType='RULE_BASED_MATCHING'|'ML_BASED_MATCHING',
          SearchKey='string',
          SearchValue='string',
          PaginationConfig={
              'MaxItems': 123,
              'PageSize': 123,
              'StartingToken': 'string'
          }
      )
      
    :type DomainName: string
    :param DomainName: **[REQUIRED]** 

      The unique name of the domain.

      

    
    :type MatchType: string
    :param MatchType: **[REQUIRED]** 

      Specify the type of matching to get similar profiles for.

      

    
    :type SearchKey: string
    :param SearchKey: **[REQUIRED]** 

      The string indicating the search key to be used.

      

    
    :type SearchValue: string
    :param SearchValue: **[REQUIRED]** 

      The string based on ``SearchKey`` to be searched for similar profiles.

      

    
    :type PaginationConfig: dict
    :param PaginationConfig: 

      A dictionary that provides parameters to control pagination.

      

    
      - **MaxItems** *(integer) --* 

        The total number of items to return. If the total number of items available is more than the value specified in max-items then a ``NextToken`` will be provided in the output that you can use to resume pagination.

        

      
      - **PageSize** *(integer) --* 

        The size of each page.

        

      
      - **StartingToken** *(string) --* 

        A token to specify where to start paginating. This is the ``NextToken`` from a previous response.

        

      
    
    
    :rtype: dict
    :returns: 
      
      **Response Syntax**

      
      ::

        {
            'ProfileIds': [
                'string',
            ],
            'MatchId': 'string',
            'MatchType': 'RULE_BASED_MATCHING'|'ML_BASED_MATCHING',
            'RuleLevel': 123,
            'ConfidenceScore': 123.0,
            
        }
        
      **Response Structure**

      

      - *(dict) --* 
        

        - **ProfileIds** *(list) --* 

          Set of ``profileId``s that belong to the same matching group.

          
          

          - *(string) --* 
      
        

        - **MatchId** *(string) --* 

          The string ``matchId`` that the similar profiles belong to.

          
        

        - **MatchType** *(string) --* 

          Specify the type of matching to get similar profiles for.

          
        

        - **RuleLevel** *(integer) --* 

          The integer rule level that the profiles matched on.

          
        

        - **ConfidenceScore** *(float) --* 

          It only has value when the ``MatchType`` is ``ML_BASED_MATCHING``.A number between 0 and 1, where a higher score means higher similarity. Examining match confidence scores lets you distinguish between groups of similar records in which the system is highly confident (which you may decide to merge), groups of similar records about which the system is uncertain (which you may decide to have reviewed by a human), and groups of similar records that the system deems to be unlikely (which you may decide to reject). Given confidence scores vary as per the data input, it should not be used as an absolute measure of matching quality.

          
    