AppKittie Ads

Search mobile app ads across Meta and Google ad libraries, or fetch one complete ad record with creative details and advertised-app context.

This Actor is useful for creative research, competitor monitoring, ad inspiration, market validation, and finding which apps are actively buying distribution.

What Can This Actor Do?

• Search ads by keyword, app, developer, category, country, surface, status, ad source, media type, date range, app downloads, and app revenue.
• Fetch one ad by adId for a more complete creative record.
• Return ad copy, media URLs, landing links, activity dates, placement metadata, and advertised-app metrics.
• Use compact view for lighter automation-friendly search results.

Common Use Cases

• Find active ads for high-revenue apps in a category.
• Study hooks, CTAs, headlines, captions, and creative formats from competitors.
• Discover apps scaling through Meta or Google ads.
• Build inspiration feeds for new ad concepts.
• Monitor whether an app is still running a specific creative.

Input

Choose an operation:

• search - Calls GET /api/v1/ads and returns up to 10 matching ads.
• details - Calls GET /api/v1/ads/{adId} and returns one complete ad record.

Use view: "compact" when you only need identity, status, copy, and app metrics. Use view: "full" when you also need media URLs and richer creative fields.

Example: Search Ads

{
  "operation": "search",
  "search": "meal plan",
  "adSource": "meta",
  "mediaType": "video",
  "status": "active",
  "categories": ["Health & Fitness"],
  "minAppRevenue": 10000,
  "sortBy": "start_date",
  "sortOrder": "desc",
  "limit": 10
}

Example: Get Ad Details

{
  "operation": "details",
  "adId": "meta_1234567890"
}

Output

The Actor writes one typed JSON record to the default key-value store under OUTPUT. It does not write dataset rows.

Search output:

{
  "data": [
    {
      "ad_doc_id": "meta_1234567890",
      "ad_source": "meta",
      "type": "video",
      "is_active": true,
      "title": "Start your meal plan today",
      "cta_text": "Install Now",
      "start_date": 1735689600,
      "app_slug": "app-example-id123456789",
      "app_title": "Example App",
      "category": "Health & Fitness",
      "developer": "Example Studio",
      "app_downloads": 85000,
      "app_revenue": 42000
    }
  ],
  "pagination": {
    "nextCursor": 10,
    "totalCount": 152
  }
}

Detail output includes the ad plus an app summary:

{
  "data": {
    "ad_doc_id": "meta_1234567890",
    "ad_source": "meta",
    "type": "video",
    "src": "https://...",
    "poster": "https://...",
    "body": "Track meals in seconds.",
    "link_url": "https://...",
    "app": {
      "app_slug": "app-example-id123456789",
      "title": "Example App",
      "source": "apple_mobile",
      "downloads": 85000,
      "revenue": 42000
    }
  }
}

Limits and Pagination

Search runs are capped at 10 returned ads. Use pagination.nextCursor as the next run's cursor to continue paging through results.

Detail operations return one ad per run.

Notes

• No proxy configuration is required.
• No AppKittie API key is required in Actor input. The Actor uses AppKittie's managed API connection internally.
• Source ad-library identifiers that should not be exposed are redacted from the response.