---
title: "Populate iOS Search Ads (ASA)"
method: POST
path: "/data/ads/searchads/populate"
tags: ["Ads"]
---

# Populate iOS Search Ads (ASA)

`POST /data/ads/searchads/populate`

## Request

- Base URL: `https://data.applyzer.com` (the document declares no server; this is the origin it was published from)
- URL: `https://data.applyzer.com/data/ads/searchads/populate`
- Auth: API key in header `Authorization`

This endpoint always returns Search Ads data per keyword.<br/>    If cached data exists within `lookbackHours`, it is returned immediately; otherwise the worker runs synchronously and the returned data is included in the response.<br/>

Credit Cost: 10

Credits per extra keyword: 10

## Request body

- object
  - `keywords` string[], required: List of keywords to populate.
  - `language` string, required: The code for English (United States) 'en-US'. The prefix, 'en', is a language code following the ISO 639-1 standard. The suffix, 'US', is a country code following the ISO 3166-1 Alpha-2 standard.
  - `device` string: iphone / ipad / mac (default is iphone)
  - `limitads` integer: Number of Search Ads results to fetch (default is 5, max is 5)
  - `storeData` boolean: If true, store worker output in task storage (default is true)
  - `lookbackHours` integer: Cache lookback window (hours). If cached data exists within this window it will be returned; otherwise the worker runs and data is returned (default is 24)
  - `forceWorker` boolean: If true, bypasses cache and forces a fresh synchronous worker run (default is false)

## Response `200`

Successful operation

- object
  - `message` string: The response message
  - `response` object[]: Array of per-keyword results.
    - `keyword` string
    - `ads` object[]: Apps currently returned as Search Ads.
      - `id` string
      - `title` string
      - `icon` string

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `500`: Error

---

[API](https://skmtc.dev/applyzer/apis/applyzer-data-api.md) - [All operations](https://skmtc.dev/applyzer/apis/applyzer-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/applyzer/apis/applyzer-data-api/revisions/ffe6cc179bf5?raw)