Add story_viewers endpoint

Author: ping

CHANGELOG.md

@@ -5,6 +5,7 @@
     * Refactored error detection. New ``ClientCheckpointRequiredError``, ``ClientChallengeRequiredError``, ``ClientSentryBlockError``
     * New highlight endpoints
     * New ``comment_inline_replies()`` endpoint
+    * New ``story_viewers()`` endpoint
     * Updates for user feed and comments endpoints
 
 ## 1.4.0

instagram_private_api/endpoints/media.py

@@ -564,3 +564,16 @@ def media_undo_only_me(self, media_id, media_type):
         :param media_type: One of :attr:`MediaTypes.PHOTO`, :attr:`MediaTypes.VIDEO`, or :attr:`MediaTypes.CAROUSEL`
         """
         return self.media_only_me(media_id, media_type, undo=True)
+
+    def story_viewers(self, story_pk, **kwargs):
+        """
+        Get list of story viewers
+
+        :param story_pk: Story media's PK identifier, e.g. "1700000123"
+        :param kwargs:
+            **max_id**: For pagination
+        :return:
+        """
+        endpoint = 'media/{story_pk!s}/list_reel_media_viewer/'.format(
+            story_pk=story_pk)
+        return self._call_api(endpoint, query=kwargs)

tests/private/client.py

@@ -256,7 +256,6 @@ def test_client_requests(self, open_mock):
                     }).encode('ascii'))),
             MockResponse(body=json.dumps({'message': 'login_required'})),
             MockResponse(body=json.dumps({'status': 'error'})),
-
         ]
 
         with self.assertRaises(ClientLoginRequiredError) as ce:

tests/private/media.py

@@ -170,6 +170,14 @@ def init_all(api):
                 'name': 'test_comment_inline_replies',
                 'test': MediaTests('test_comment_inline_replies', api)
             },
+            {
+                'name': 'test_story_viewers_mock',
+                'test': MediaTests('test_story_viewers_mock', api)
+            },
+            {
+                'name': 'test_story_viewers',
+                'test': MediaTests('test_story_viewers', api)
+            },
         ]
 
     def test_media_info(self):
@@ -559,3 +567,20 @@ def test_media_only_me_mock(self, call_api):
         call_api.assert_called_with(
             'media/{media_id!s}/undo_only_me/'.format(**{'media_id': media_id}),
             params=params, query={'media_type': 2})
+
+    @compat_mock.patch('instagram_private_api.Client._call_api')
+    def test_story_viewers_mock(self, call_api):
+        call_api.return_value = {'status': 'ok'}
+        story_pk = '170000000'
+        self.api.story_viewers(story_pk)
+        call_api.assert_called_with(
+            'media/{story_pk!s}/list_reel_media_viewer/'.format(story_pk=story_pk),
+            query={})
+
+    @unittest.skip('Requires valid story PK.')
+    def test_story_viewers(self):
+        results = self.api.story_viewers('170000000123')
+        self.assertEqual(results.get('status'), 'ok')
+        self.assertIn('users', results)
+        self.assertIn('total_viewer_count', results)
+        self.assertIn('user_count', results)