We’re changing the default depth setting in the Apple App Store Reviews API.
What’s new
Starting today, June 30, 2026, the default value of the depth parameter changes from 50 to 25.
Previously, if no depth value was specified when setting a task, the API returned up to 50 reviews by default. After this update, requests without an explicitly defined depth value will return 25 reviews by default.
How it works
If you do not include the depth parameter in your POST request payload, the API will automatically use the new default value of 25. You can still collect more than 25 reviews, up to the supported limit of 500, by specifying the necessary number within that limit in the depth parameter of your request.
Required actions
If your integration relies on the default depth setting and you still need to collect more than 25 reviews, update your request payload to include the necessary depth. If you already use the depth parameter in your payload, no changes are required.
See the updated documentation for details.