feat: add GET endpoint for spam site referrers (#47566)

* feat: get spam site referrers endpoint

Add GET endpoint for retrieving list of spam site referrers to enable
listing and managing spam site referrers.

* changelog

* test: add referrers spam GET route to REST controller test coverage

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>

---------

Co-authored-by: Claude Sonnet 4.6 <[email protected]>

Author: dcalhoun

projects/packages/stats-admin/changelog/add-get-spam-referrers-endpoint

@@ -0,0 +1,4 @@
+Significance: minor
+Type: added
+
+Add GET endpoint for retrieving spam site referrers.

projects/packages/stats-admin/src/class-rest-controller.php

@@ -256,6 +256,17 @@ public function register_rest_routes() {
 			)
 		);
 
+		// Get referrer spam list.
+		register_rest_route(
+			static::$namespace,
+			sprintf( '/sites/%d/stats/referrers/spam', Jetpack_Options::get_option( 'id' ) ),
+			array(
+				'methods'             => WP_REST_Server::READABLE,
+				'callback'            => array( $this, 'get_referrer_spam_list' ),
+				'permission_callback' => array( $this, 'can_user_view_general_stats_callback' ),
+			)
+		);
+
 		// Mark referrer spam.
 		register_rest_route(
 			static::$namespace,
@@ -1022,6 +1033,25 @@ public function get_notice_status() {
 		return ( new Notices() )->get_notices_to_show();
 	}
 
+	/**
+	 * Get the list of spam referrers.
+	 *
+	 * @return array
+	 */
+	public function get_referrer_spam_list() {
+		return WPCOM_Client::request_as_blog(
+			sprintf(
+				'/sites/%d/stats/referrers/spam',
+				Jetpack_Options::get_option( 'id' )
+			),
+			'v1.1',
+			array(
+				'timeout' => 5,
+				'method'  => 'GET',
+			)
+		);
+	}
+
 	/**
 	 * Mark a referrer as spam.
 	 *

projects/packages/stats-admin/tests/php/REST_Controller_Test.php

@@ -21,6 +21,7 @@ class REST_Controller_Test extends Stats_TestCase {
 		'/jetpack/v4/stats-app/sites/999/stats/country-views',
 		'/jetpack/v4/stats-app/sites/999/stats/clicks',
 		'/jetpack/v4/stats-app/sites/999/stats/referrers',
+		'/jetpack/v4/stats-app/sites/999/stats/referrers/spam',
 		'/jetpack/v4/stats-app/sites/999/stats/top-authors',
 		'/jetpack/v4/stats-app/sites/999/stats/video-plays',
 		'/jetpack/v4/stats-app/sites/999/posts',