Skip to main content
GET /v1/keywords/ad-pressure
Reports how many Apple Search Ads slots appear on the SERP for one keyword today, plus the rolling-window average for trend context. Useful for budgeting paid campaigns and for prioritising organic ASO work — a SERP with three persistent ad slots gives organic position 1 the click-through of an organic position 4.

​
Query Parameters

NameTypeRequiredDefaultDescription
keywordstringYes—The keyword to analyse
countrystringNousISO 3166-1 alpha-2 storefront
devicestringNoiphoneiphone or ipad
daysnumberNo14Window length for the average, 3–90

​
Response

{
  "ok": true,
  "data": {
    "keyword": "puzzle",
    "country": "us",
    "device": "iphone",
    "windowDays": 14,
    "asOf": "2026-04-21",
    "current": {
      "adSlots": 2,
      "organicSlots": 23,
      "firstAdRank": 1,
      "lastAdRank": 6,
      "organicTop10Pushed": 2
    },
    "avgAdSlots": 1.4,
    "pressure": "moderate",
    "hasObservedAds": true
  }
}
pressure values: none · light · moderate · heavy. Bucket boundaries blend the latest day (70%) with the rolling average (30%), so a one-off spike doesn’t flip the verdict. hasObservedAds is false for keywords where no ads have ever been observed on the storefront — useful as a “purely organic” filter for ASO planning.

​
Credit Cost

2 credits per request.

​
Use Cases

  • Discount the click-through value of organic positions when ads are crowding the top.
  • Identify keywords where shifting budget from ads to organic ASO is highest-ROI.
  • Build a “Paid pressure heatmap” view across a portfolio of tracked keywords.