:doc:`Rekognition <../../rekognition>` / Client / get_celebrity_info

******************
get_celebrity_info
******************



.. py:method:: Rekognition.Client.get_celebrity_info(**kwargs)

  

  Gets the name and additional information about a celebrity based on their Amazon Rekognition ID. The additional information is returned as an array of URLs. If there is no additional information about the celebrity, this list is empty.

   

  For more information, see Getting information about a celebrity in the Amazon Rekognition Developer Guide.

   

  This operation requires permissions to perform the ``rekognition:GetCelebrityInfo`` action.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/rekognition-2016-06-27/GetCelebrityInfo>`_  


  **Request Syntax**
  ::

    response = client.get_celebrity_info(
        Id='string'
    )
    
  :type Id: string
  :param Id: **[REQUIRED]** 

    The ID for the celebrity. You get the celebrity ID from a call to the  RecognizeCelebrities operation, which recognizes celebrities in an image.

    

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

    
    ::

      {
          'Urls': [
              'string',
          ],
          'Name': 'string',
          'KnownGender': {
              'Type': 'Male'|'Female'|'Nonbinary'|'Unlisted'
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Urls** *(list) --* 

        An array of URLs pointing to additional celebrity information.

        
        

        - *(string) --* 
    
      

      - **Name** *(string) --* 

        The name of the celebrity.

        
      

      - **KnownGender** *(dict) --* 

        Retrieves the known gender for the celebrity.

        
        

        - **Type** *(string) --* 

          A string value of the KnownGender info about the Celebrity.

          
    
  
  **Exceptions**
  
  *   :py:class:`Rekognition.Client.exceptions.InvalidParameterException`

  
  *   :py:class:`Rekognition.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`Rekognition.Client.exceptions.InternalServerError`

  
  *   :py:class:`Rekognition.Client.exceptions.ThrottlingException`

  
  *   :py:class:`Rekognition.Client.exceptions.ProvisionedThroughputExceededException`

  
  *   :py:class:`Rekognition.Client.exceptions.ResourceNotFoundException`

  