Ads

Operations

• Search ad libraries

  POST/v1/ads/search

  Meta: 1 credit per Ad delivered, the same when served from a recent advertiser observation, plus 20 credits per Ad analysed with analyze, computed or already stored; the estimate quotes limit Ads, all analysed up to the cap with analyze. TikTok: 3 credits per page.

• Get a Meta Ad

  GET/v1/ads/meta/{library_id}

  3 credits, read live or from our stored copy (observed under 6 h ago, or removed from the library). With analyze=true, plus 20 credits, whether the analysis is computed or already stored.

• Get a Meta Ad's analysis

  GET/v1/ads/meta/{library_id}/intelligence

  Free.

• List a Meta Ad's snapshots

  GET/v1/ads/meta/{library_id}/snapshots

  Free.

• Get a Meta advertiser

  GET/v1/advertisers/{page_id}

  15 credits, the same when served within 6 hours of a complete observation.