Skip to main content
POST
Apple App Store Rankings API

Get Apple App Store Rankings

Fetch normalized rankings data from Apple App Store. Each successfully returned standard result costs 0.15 credits. List endpoints reserve by results_limit and settle against the actual result count.

Request Body

Use with MCP

A successful request returns a task_id. Poll it with socq_get_task, then read normalized records from results.items.

Result Fields

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
urls
string[]
required

Public profile or content URLs.

Minimum array length: 1
Minimum string length: 1
results_limit
integer
default:100
Required range: 1 <= x <= 2000

Response

Task accepted

code
integer
data
object