Watchlist

List watchlist items with their latest scan

Returns watchlist items plus their single most-recent scan. Requires scope watchlist:read. NOTE: response envelope is { watchlist: [...] }, not the standard { data }.

get/api/v1/watchlist

Request

  • Base URL: https://getscaleforge.com
  • URL: https://getscaleforge.com/api/v1/watchlist
  • Auth: HTTP bearer

Response

Success

Example response

{
  "watchlist": [
    {
      "id": 17,
      "page_url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&view_all_page_id=100012345",
      "page_name": "Competitor Page",
      "page_id": "100012345",
      "scan_frequency": "daily",
      "active": true,
      "total_ads": 42,
      "active_ads": 42,
      "watchlist_scans": [
        {
          "id": 991,
          "total_ads": 42,
          "new_ads": 3,
          "removed_ads": 1
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.