Get an app developer

Request

Pass Apple's numeric developer id in the path. Take it from the developerId on a catalogue listing, or from an App Store developer link: apps.apple.com/developer/example-labs/id1000000000 has developerId 1000000000. A developer is identified by this id, never matched by name. There is no query or body.

Parameters

Response

name is the seller name the App Store shows, or null until a storefront lookup has named the developer. apps come ordered by estimated revenue, then estimated downloads, then ratings. Each app has its store facts; storeStatus is listed, not_found when every observed storefront reported it missing, or unchecked before any lookup. monthlyInstalls and monthlyRevenue are the current worldwide monthly range (or below_floor under 5,000 a month) with the night it was scored, and previous is the estimate that held a month earlier. paidAds holds the stored paid-ad counts {liveAds, totalAds, builtAt}. An estimate or paidAds is null when PeekPanda holds none for the app: unknown, not zero. categories lists the served apps’ categories, most apps first, and topRevenueStoreId and topInstallsStoreId name the leading apps. history holds the developer’s daily totals for up to the last 90 scored days, oldest first and ending on the newest scored night. Each point applies the totals rule to the estimates in effect that day and carries the same counts, so when rangedApps rises from one day to the next, more apps were scored, which is not growth; a range is null on a day no app had one, and the list is empty until any app has been scored. A developer with no catalogued app answers 404 not_found.

Response fields

Authentication

Requires Bearer API credential or OAuth access token. Scope context:read. MCP calls search_apps with action developer.

Errors

MCP request

Call search_apps with action developer. Path fields go in params, filters in query, and a write body in body.

{
  "name": "search_apps",
  "arguments": {
    "request": {
      "action": "developer",
      "params": {
        "platform": "<platform>",
        "developerId": "<developerId>"
      }
    }
  }
}

Source

Dated public App Store listing observations from the PeekPanda catalogue, with PeekPanda estimates refreshed nightly and stored paid-ad counts. An app belongs to the developer its storefront listing names, so an app transferred to another developer moves with it.

Refresh

This read returns stored observations and estimates and does not start collection.

App limit

One read serves at most 400 apps. A developer with more catalogued apps serves its 400 most-rated apps, appCount says how many apps the catalogue holds for it, and appsTruncated is true. There is no cursor.

Totals

totals are computed over the served apps. monthlyInstalls.range and monthlyRevenue.range add up the ranges of the apps with a ranged estimate (rangedApps) and are null when none has one. Apps under the floor (belowFloorApps) and apps with no estimate (unknownApps) are counted apart, never folded into the sum, so a total covers only the scored apps it names. belowFloorCeiling is the level the below-floor apps sit under (5,000 a month today) and is null when belowFloorApps is 0. liveAds adds up the apps’ stored live-ad counts and appsWithPaidAds counts the apps with stored counts, even when none of their ads is live; an app without stored counts is unknown, not zero.

Revenue scope

Estimates are App Store revenue only: worldwide monthly App Store figures in USD. Revenue earned outside the App Store, such as web checkout, is not included.

Rate limits

This read uses the standard read budget; honor Retry-After on a 429 rate_limited response. Every call also counts toward your plan's daily API and MCP allowance: 30 calls a day on Peek and 1,000 on Panda, shared by every key and MCP connection on the plan and reset at 00:00 UTC. Past it, calls answer 429 daily_call_limit until the reset.