late-sdk 0.0.853 → 0.0.854

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 05ae9f355f4dd47957afe2f4f8e1403fba96297e7c02031236ebd830ace68a6a
-  data.tar.gz: 62f0a3861bdb2fe95f82faca7e164f2775ae71035fa3d2459dcac0b495c13cef
+  metadata.gz: c541aaaa8448460a57e09acf9fe79b03e95d7b887d43446b44610c7318bbefca
+  data.tar.gz: b03c4ea167008348ed01fc8cbdb664045dfff9f901ed6642f50d7f7a25c52370
 SHA512:
-  metadata.gz: 263e5a939465443af1b8400a47e78d1ff5afb62abeed6cc5356de1d417128aa3a7aa000a012f79c7ee6166d5accb970108033a0f6997928a3eff3ecf32c412e2
-  data.tar.gz: e09470ba96c3f930f1bc294fcb9eff5b0da1ef18b630f5bb51b79320910efa2054e529495235aa10df26bc1340da65132803e5400bc8f5b054b8ad95780e6f26
+  metadata.gz: 456cf510447ea7fada96c77e7c5fee370f3b716b33643d34fce10af7b72d2140f51b80c333e40d5a8206bff30430cc07a2edd25a8b545419718a11a0e6f43071
+  data.tar.gz: '0925de744e040767d2adb50be47404a637c64e87679499700eb9942cdc86a5a2653a07f0aecc90d3d3f59976359367b812889966a816e66327c32b655d6215cf'

data/README.md

@@ -182,6 +182,7 @@ Class | Method | HTTP request | Description
 *Zernio::AdInsightsApi* | [**list_local_services_lead_conversations**](docs/AdInsightsApi.md#list_local_services_lead_conversations) | **GET** /v1/ads/local-services/leads/{leadId}/conversations | Conversations of a Local Services lead
 *Zernio::AdInsightsApi* | [**list_local_services_leads**](docs/AdInsightsApi.md#list_local_services_leads) | **GET** /v1/ads/local-services/leads | Google Local Services Ads leads
 *Zernio::AdInsightsApi* | [**query_ad_insights**](docs/AdInsightsApi.md#query_ad_insights) | **GET** /v1/ads/insights | Flexible live insights query
+*Zernio::AdLibraryApi* | [**search_ad_library**](docs/AdLibraryApi.md#search_ad_library) | **GET** /v1/ads/library | Search the public Ad Library
 *Zernio::AdTargetingApi* | [**estimate_ad_reach**](docs/AdTargetingApi.md#estimate_ad_reach) | **POST** /v1/ads/targeting/reach-estimate | Estimate audience reach
 *Zernio::AdTargetingApi* | [**get_linked_in_bid_pricing**](docs/AdTargetingApi.md#get_linked_in_bid_pricing) | **POST** /v1/ads/targeting/bid-pricing | Suggested bid and budget bounds
 *Zernio::AdTargetingApi* | [**get_linked_in_supply_forecast**](docs/AdTargetingApi.md#get_linked_in_supply_forecast) | **POST** /v1/ads/targeting/supply-forecast | Impressions, clicks and spend forecast
@@ -1904,6 +1905,8 @@ Class | Method | HTTP request | Description
  - [Zernio::ScheduleBroadcastRequest](docs/ScheduleBroadcastRequest.md)
  - [Zernio::SearchAdInterests200Response](docs/SearchAdInterests200Response.md)
  - [Zernio::SearchAdInterests200ResponseInterestsInner](docs/SearchAdInterests200ResponseInterestsInner.md)
+ - [Zernio::SearchAdLibrary200Response](docs/SearchAdLibrary200Response.md)
+ - [Zernio::SearchAdLibrary200ResponsePaging](docs/SearchAdLibrary200ResponsePaging.md)
  - [Zernio::SearchAdTargeting200Response](docs/SearchAdTargeting200Response.md)
  - [Zernio::SearchAdTargeting200ResponseResultsInner](docs/SearchAdTargeting200ResponseResultsInner.md)
  - [Zernio::SearchAvailablePhoneNumbers200Response](docs/SearchAvailablePhoneNumbers200Response.md)

data/docs/AdLibraryApi.md

@@ -0,0 +1,109 @@
+# Zernio::AdLibraryApi
+
+All URIs are relative to *https://zernio.com/api*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**search_ad_library**](AdLibraryApi.md#search_ad_library) | **GET** /v1/ads/library | Search the public Ad Library |
+
+
+## search_ad_library
+
+> <SearchAdLibrary200Response> search_ad_library(account_id, opts)
+
+Search the public Ad Library
+
+Competitor and market research over the platform's public ad archive, searched with the customer's own connected token (no extra scope): Meta's Ad Library (`GET /ads_archive`) for a `facebook` / `instagram` / `metaads` account, LinkedIn's Ad Library (`GET /rest/adLibrary`) for a `linkedin` / `linkedinads` account. Rows are returned in the platform's raw shape under `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).  **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is in the archive only if it was delivered to the EU or UK within the last year, so a US-only commercial advertiser is invisible. Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`. Meta serves the archive only to people who confirmed their identity and location at facebook.com/ID: until the Facebook user behind the connection has done so, the call fails with `meta_identity_confirmation_required` (403).  **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets. Pages are capped at 25 ads (`limit` > 25 is a 400); `after` is the next offset.  Which params apply: `q`, `countries`, `since`, `until`, `limit`, `after` on both; `pageIds`, `adType`, `status`, `platforms`, `mediaType`, `languages`, `searchType`, `fields` are Meta-only; `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400 naming the param.
+
+### Examples
+
+```ruby
+require 'time'
+require 'zernio-sdk'
+# setup authorization
+Zernio.configure do |config|
+  # Configure Bearer authorization (JWT): bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Zernio::AdLibraryApi.new
+account_id = 'account_id_example' # String | Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
+opts = {
+  q: 'q_example', # String | Keyword search. Meta does not translate it, so write it in the ads' language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given.
+  page_ids: 'page_ids_example', # String | Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
+  advertiser: 'advertiser_example', # String | LinkedIn only. Advertiser (Page) name to search.
+  countries: 'countries_example', # String | Comma-separated ISO 3166-1 alpha-2 codes the ads reached. Meta defaults to ALL (an explicit ALL is Meta-only); LinkedIn searches every market when omitted.
+  ad_type: 'ALL', # String | Meta only.
+  status: 'ACTIVE', # String | Meta only. ACTIVE = eligible for delivery right now.
+  platforms: 'platforms_example', # String | Meta only. Comma-separated publisher platforms: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, WHATSAPP, OCULUS, THREADS, STREAMING_SERVICES.
+  media_type: 'ALL', # String | Meta only.
+  languages: 'languages_example', # String | Meta only. Comma-separated ISO 639-1 codes of the ad text.
+  since: Date.parse('2013-10-20'), # Date | Earliest delivery date (YYYY-MM-DD).
+  _until: Date.parse('2013-10-20'), # Date | Latest delivery date (YYYY-MM-DD).
+  search_type: 'KEYWORD_UNORDERED', # String | Meta only. Whether q matches words in any order or as an exact phrase (comma-separate phrases to match all of them).
+  fields: 'fields_example', # String | Meta only. Raw Graph projection override, e.g. add spend,impressions,demographic_distribution for political ads.
+  limit: 56, # Integer | Rows per page. LinkedIn accepts at most 25.
+  after: 'after_example' # String | paging.after of the previous page.
+}
+
+begin
+  # Search the public Ad Library
+  result = api_instance.search_ad_library(account_id, opts)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling AdLibraryApi->search_ad_library: #{e}"
+end
+```
+
+#### Using the search_ad_library_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SearchAdLibrary200Response>, Integer, Hash)> search_ad_library_with_http_info(account_id, opts)
+
+```ruby
+begin
+  # Search the public Ad Library
+  data, status_code, headers = api_instance.search_ad_library_with_http_info(account_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SearchAdLibrary200Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling AdLibraryApi->search_ad_library_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches. |  |
+| **q** | **String** | Keyword search. Meta does not translate it, so write it in the ads&#39; language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given. | [optional] |
+| **page_ids** | **String** | Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list. | [optional] |
+| **advertiser** | **String** | LinkedIn only. Advertiser (Page) name to search. | [optional] |
+| **countries** | **String** | Comma-separated ISO 3166-1 alpha-2 codes the ads reached. Meta defaults to ALL (an explicit ALL is Meta-only); LinkedIn searches every market when omitted. | [optional] |
+| **ad_type** | **String** | Meta only. | [optional][default to &#39;ALL&#39;] |
+| **status** | **String** | Meta only. ACTIVE &#x3D; eligible for delivery right now. | [optional][default to &#39;ACTIVE&#39;] |
+| **platforms** | **String** | Meta only. Comma-separated publisher platforms: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, WHATSAPP, OCULUS, THREADS, STREAMING_SERVICES. | [optional] |
+| **media_type** | **String** | Meta only. | [optional] |
+| **languages** | **String** | Meta only. Comma-separated ISO 639-1 codes of the ad text. | [optional] |
+| **since** | **Date** | Earliest delivery date (YYYY-MM-DD). | [optional] |
+| **_until** | **Date** | Latest delivery date (YYYY-MM-DD). | [optional] |
+| **search_type** | **String** | Meta only. Whether q matches words in any order or as an exact phrase (comma-separate phrases to match all of them). | [optional][default to &#39;KEYWORD_UNORDERED&#39;] |
+| **fields** | **String** | Meta only. Raw Graph projection override, e.g. add spend,impressions,demographic_distribution for political ads. | [optional] |
+| **limit** | **Integer** | Rows per page. LinkedIn accepts at most 25. | [optional][default to 25] |
+| **after** | **String** | paging.after of the previous page. | [optional] |
+
+### Return type
+
+[**SearchAdLibrary200Response**](SearchAdLibrary200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+

data/docs/SearchAdLibrary200Response.md

@@ -0,0 +1,22 @@
+# Zernio::SearchAdLibrary200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **platform** | **String** |  |  |
+| **data** | **Array<Object>** |  |  |
+| **paging** | [**SearchAdLibrary200ResponsePaging**](SearchAdLibrary200ResponsePaging.md) |  |  |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::SearchAdLibrary200Response.new(
+  platform: null,
+  data: null,
+  paging: null
+)
+```
+

data/docs/SearchAdLibrary200ResponsePaging.md

@@ -0,0 +1,20 @@
+# Zernio::SearchAdLibrary200ResponsePaging
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **after** | **String** | Cursor for the next page; null when exhausted. | [optional] |
+| **total** | **Integer** | LinkedIn only. Total matching ads. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::SearchAdLibrary200ResponsePaging.new(
+  after: null,
+  total: null
+)
+```
+

data/lib/zernio-sdk/api/ad_library_api.rb

@@ -0,0 +1,163 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'cgi'
+
+module Zernio
+  class AdLibraryApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Search the public Ad Library
+    # Competitor and market research over the platform's public ad archive, searched with the customer's own connected token (no extra scope): Meta's Ad Library (`GET /ads_archive`) for a `facebook` / `instagram` / `metaads` account, LinkedIn's Ad Library (`GET /rest/adLibrary`) for a `linkedin` / `linkedinads` account. Rows are returned in the platform's raw shape under `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).  **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is in the archive only if it was delivered to the EU or UK within the last year, so a US-only commercial advertiser is invisible. Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`. Meta serves the archive only to people who confirmed their identity and location at facebook.com/ID: until the Facebook user behind the connection has done so, the call fails with `meta_identity_confirmation_required` (403).  **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets. Pages are capped at 25 ads (`limit` > 25 is a 400); `after` is the next offset.  Which params apply: `q`, `countries`, `since`, `until`, `limit`, `after` on both; `pageIds`, `adType`, `status`, `platforms`, `mediaType`, `languages`, `searchType`, `fields` are Meta-only; `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400 naming the param.
+    # @param account_id [String] Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :q Keyword search. Meta does not translate it, so write it in the ads' language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given.
+    # @option opts [String] :page_ids Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
+    # @option opts [String] :advertiser LinkedIn only. Advertiser (Page) name to search.
+    # @option opts [String] :countries Comma-separated ISO 3166-1 alpha-2 codes the ads reached. Meta defaults to ALL (an explicit ALL is Meta-only); LinkedIn searches every market when omitted.
+    # @option opts [String] :ad_type Meta only. (default to 'ALL')
+    # @option opts [String] :status Meta only. ACTIVE = eligible for delivery right now. (default to 'ACTIVE')
+    # @option opts [String] :platforms Meta only. Comma-separated publisher platforms: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, WHATSAPP, OCULUS, THREADS, STREAMING_SERVICES.
+    # @option opts [String] :media_type Meta only.
+    # @option opts [String] :languages Meta only. Comma-separated ISO 639-1 codes of the ad text.
+    # @option opts [Date] :since Earliest delivery date (YYYY-MM-DD).
+    # @option opts [Date] :_until Latest delivery date (YYYY-MM-DD).
+    # @option opts [String] :search_type Meta only. Whether q matches words in any order or as an exact phrase (comma-separate phrases to match all of them). (default to 'KEYWORD_UNORDERED')
+    # @option opts [String] :fields Meta only. Raw Graph projection override, e.g. add spend,impressions,demographic_distribution for political ads.
+    # @option opts [Integer] :limit Rows per page. LinkedIn accepts at most 25. (default to 25)
+    # @option opts [String] :after paging.after of the previous page.
+    # @return [SearchAdLibrary200Response]
+    def search_ad_library(account_id, opts = {})
+      data, _status_code, _headers = search_ad_library_with_http_info(account_id, opts)
+      data
+    end
+
+    # Search the public Ad Library
+    # Competitor and market research over the platform's public ad archive, searched with the customer's own connected token (no extra scope): Meta's Ad Library (`GET /ads_archive`) for a `facebook` / `instagram` / `metaads` account, LinkedIn's Ad Library (`GET /rest/adLibrary`) for a `linkedin` / `linkedinads` account. Rows are returned in the platform's raw shape under `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).  **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is in the archive only if it was delivered to the EU or UK within the last year, so a US-only commercial advertiser is invisible. Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`. Meta serves the archive only to people who confirmed their identity and location at facebook.com/ID: until the Facebook user behind the connection has done so, the call fails with `meta_identity_confirmation_required` (403).  **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets. Pages are capped at 25 ads (`limit` > 25 is a 400); `after` is the next offset.  Which params apply: `q`, `countries`, `since`, `until`, `limit`, `after` on both; `pageIds`, `adType`, `status`, `platforms`, `mediaType`, `languages`, `searchType`, `fields` are Meta-only; `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400 naming the param.
+    # @param account_id [String] Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :q Keyword search. Meta does not translate it, so write it in the ads' language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given.
+    # @option opts [String] :page_ids Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
+    # @option opts [String] :advertiser LinkedIn only. Advertiser (Page) name to search.
+    # @option opts [String] :countries Comma-separated ISO 3166-1 alpha-2 codes the ads reached. Meta defaults to ALL (an explicit ALL is Meta-only); LinkedIn searches every market when omitted.
+    # @option opts [String] :ad_type Meta only. (default to 'ALL')
+    # @option opts [String] :status Meta only. ACTIVE = eligible for delivery right now. (default to 'ACTIVE')
+    # @option opts [String] :platforms Meta only. Comma-separated publisher platforms: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, WHATSAPP, OCULUS, THREADS, STREAMING_SERVICES.
+    # @option opts [String] :media_type Meta only.
+    # @option opts [String] :languages Meta only. Comma-separated ISO 639-1 codes of the ad text.
+    # @option opts [Date] :since Earliest delivery date (YYYY-MM-DD).
+    # @option opts [Date] :_until Latest delivery date (YYYY-MM-DD).
+    # @option opts [String] :search_type Meta only. Whether q matches words in any order or as an exact phrase (comma-separate phrases to match all of them). (default to 'KEYWORD_UNORDERED')
+    # @option opts [String] :fields Meta only. Raw Graph projection override, e.g. add spend,impressions,demographic_distribution for political ads.
+    # @option opts [Integer] :limit Rows per page. LinkedIn accepts at most 25. (default to 25)
+    # @option opts [String] :after paging.after of the previous page.
+    # @return [Array<(SearchAdLibrary200Response, Integer, Hash)>] SearchAdLibrary200Response data, response status code and response headers
+    def search_ad_library_with_http_info(account_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdLibraryApi.search_ad_library ...'
+      end
+      # verify the required parameter 'account_id' is set
+      if @api_client.config.client_side_validation && account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'account_id' when calling AdLibraryApi.search_ad_library"
+      end
+      if @api_client.config.client_side_validation && !opts[:'q'].nil? && opts[:'q'].to_s.length > 100
+        fail ArgumentError, 'invalid value for "opts[:"q"]" when calling AdLibraryApi.search_ad_library, the character length must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'advertiser'].nil? && opts[:'advertiser'].to_s.length > 100
+        fail ArgumentError, 'invalid value for "opts[:"advertiser"]" when calling AdLibraryApi.search_ad_library, the character length must be smaller than or equal to 100.'
+      end
+
+      allowable_values = ["ALL", "POLITICAL_AND_ISSUE_ADS", "HOUSING_ADS", "EMPLOYMENT_ADS", "FINANCIAL_PRODUCTS_AND_SERVICES_ADS"]
+      if @api_client.config.client_side_validation && opts[:'ad_type'] && !allowable_values.include?(opts[:'ad_type'])
+        fail ArgumentError, "invalid value for \"ad_type\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["ACTIVE", "INACTIVE", "ALL"]
+      if @api_client.config.client_side_validation && opts[:'status'] && !allowable_values.include?(opts[:'status'])
+        fail ArgumentError, "invalid value for \"status\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["ALL", "IMAGE", "MEME", "VIDEO", "NONE"]
+      if @api_client.config.client_side_validation && opts[:'media_type'] && !allowable_values.include?(opts[:'media_type'])
+        fail ArgumentError, "invalid value for \"media_type\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["KEYWORD_UNORDERED", "KEYWORD_EXACT_PHRASE"]
+      if @api_client.config.client_side_validation && opts[:'search_type'] && !allowable_values.include?(opts[:'search_type'])
+        fail ArgumentError, "invalid value for \"search_type\", must be one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling AdLibraryApi.search_ad_library, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling AdLibraryApi.search_ad_library, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/v1/ads/library'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'accountId'] = account_id
+      query_params[:'q'] = opts[:'q'] if !opts[:'q'].nil?
+      query_params[:'pageIds'] = opts[:'page_ids'] if !opts[:'page_ids'].nil?
+      query_params[:'advertiser'] = opts[:'advertiser'] if !opts[:'advertiser'].nil?
+      query_params[:'countries'] = opts[:'countries'] if !opts[:'countries'].nil?
+      query_params[:'adType'] = opts[:'ad_type'] if !opts[:'ad_type'].nil?
+      query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
+      query_params[:'platforms'] = opts[:'platforms'] if !opts[:'platforms'].nil?
+      query_params[:'mediaType'] = opts[:'media_type'] if !opts[:'media_type'].nil?
+      query_params[:'languages'] = opts[:'languages'] if !opts[:'languages'].nil?
+      query_params[:'since'] = opts[:'since'] if !opts[:'since'].nil?
+      query_params[:'until'] = opts[:'_until'] if !opts[:'_until'].nil?
+      query_params[:'searchType'] = opts[:'search_type'] if !opts[:'search_type'].nil?
+      query_params[:'fields'] = opts[:'fields'] if !opts[:'fields'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'after'] = opts[:'after'] if !opts[:'after'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SearchAdLibrary200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"AdLibraryApi.search_ad_library",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdLibraryApi#search_ad_library\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/zernio-sdk/models/search_ad_library200_response.rb

@@ -0,0 +1,242 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Zernio
+  class SearchAdLibrary200Response < ApiModelBase
+    attr_accessor :platform
+
+    attr_accessor :data
+
+    attr_accessor :paging
+
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'platform' => :'platform',
+        :'data' => :'data',
+        :'paging' => :'paging'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'platform' => :'String',
+        :'data' => :'Array<Object>',
+        :'paging' => :'SearchAdLibrary200ResponsePaging'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::SearchAdLibrary200Response` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::SearchAdLibrary200Response`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'platform')
+        self.platform = attributes[:'platform']
+      else
+        self.platform = nil
+      end
+
+      if attributes.key?(:'data')
+        if (value = attributes[:'data']).is_a?(Array)
+          self.data = value
+        end
+      else
+        self.data = nil
+      end
+
+      if attributes.key?(:'paging')
+        self.paging = attributes[:'paging']
+      else
+        self.paging = nil
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @platform.nil?
+        invalid_properties.push('invalid value for "platform", platform cannot be nil.')
+      end
+
+      if @data.nil?
+        invalid_properties.push('invalid value for "data", data cannot be nil.')
+      end
+
+      if @paging.nil?
+        invalid_properties.push('invalid value for "paging", paging cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @platform.nil?
+      platform_validator = EnumAttributeValidator.new('String', ["meta", "linkedin"])
+      return false unless platform_validator.valid?(@platform)
+      return false if @data.nil?
+      return false if @paging.nil?
+      true
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] platform Object to be assigned
+    def platform=(platform)
+      validator = EnumAttributeValidator.new('String', ["meta", "linkedin"])
+      unless validator.valid?(platform)
+        fail ArgumentError, "invalid value for \"platform\", must be one of #{validator.allowable_values}."
+      end
+      @platform = platform
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] data Value to be assigned
+    def data=(data)
+      if data.nil?
+        fail ArgumentError, 'data cannot be nil'
+      end
+
+      @data = data
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] paging Value to be assigned
+    def paging=(paging)
+      if paging.nil?
+        fail ArgumentError, 'paging cannot be nil'
+      end
+
+      @paging = paging
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          platform == o.platform &&
+          data == o.data &&
+          paging == o.paging
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [platform, data, paging].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/zernio-sdk/models/search_ad_library200_response_paging.rb

@@ -0,0 +1,159 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Zernio
+  class SearchAdLibrary200ResponsePaging < ApiModelBase
+    # Cursor for the next page; null when exhausted.
+    attr_accessor :after
+
+    # LinkedIn only. Total matching ads.
+    attr_accessor :total
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'after' => :'after',
+        :'total' => :'total'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'after' => :'String',
+        :'total' => :'Integer'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+        :'after',
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::SearchAdLibrary200ResponsePaging` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::SearchAdLibrary200ResponsePaging`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'after')
+        self.after = attributes[:'after']
+      end
+
+      if attributes.key?(:'total')
+        self.total = attributes[:'total']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          after == o.after &&
+          total == o.total
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [after, total].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/zernio-sdk/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0
 =end
 
 module Zernio
-  VERSION = '0.0.853'
+  VERSION = '0.0.854'
 end

data/lib/zernio-sdk.rb

@@ -1242,6 +1242,8 @@ require 'zernio-sdk/models/schedule_broadcast200_response_broadcast'
 require 'zernio-sdk/models/schedule_broadcast_request'
 require 'zernio-sdk/models/search_ad_interests200_response'
 require 'zernio-sdk/models/search_ad_interests200_response_interests_inner'
+require 'zernio-sdk/models/search_ad_library200_response'
+require 'zernio-sdk/models/search_ad_library200_response_paging'
 require 'zernio-sdk/models/search_ad_targeting200_response'
 require 'zernio-sdk/models/search_ad_targeting200_response_results_inner'
 require 'zernio-sdk/models/search_available_phone_numbers200_response'
@@ -1805,6 +1807,7 @@ require 'zernio-sdk/api/ad_audiences_api'
 require 'zernio-sdk/api/ad_campaigns_api'
 require 'zernio-sdk/api/ad_creatives_api'
 require 'zernio-sdk/api/ad_insights_api'
+require 'zernio-sdk/api/ad_library_api'
 require 'zernio-sdk/api/ad_targeting_api'
 require 'zernio-sdk/api/analytics_api'
 require 'zernio-sdk/api/blogs_api'

data/openapi.yaml

@@ -389,6 +389,10 @@ tags:
       Targeting discovery: search interests/behaviors/geo/demographics, estimate reach, and (LinkedIn)
       bid pricing and supply forecasts. Feeds the targeting fields on create.
       Requires the Ads add-on.
+  - name: Ad Library
+    description: |
+      Competitor and market research over the public ad archives (Meta Ad Library, LinkedIn Ad Library),
+      searched with the customer's own connected token. Requires the Ads add-on.
   - name: Ad Insights
     description: |
       Measurement: cached aggregate analytics per ad/campaign, plus live Meta Graph insight queries
@@ -46652,6 +46656,117 @@ paths:
         '404':
           description: Account not found, or the platform does not support the requested dimension
 
+  /v1/ads/library:
+    get:
+      x-resource-group: "ads"
+      operationId: searchAdLibrary
+      tags: ["Ad Library"]
+      x-platforms: ["meta", "linkedin"]
+      summary: Search the public Ad Library
+      description: |-
+        Competitor and market research over the platform's public ad archive, searched with the
+        customer's own connected token (no extra scope): Meta's Ad Library (`GET /ads_archive`) for
+        a `facebook` / `instagram` / `metaads` account, LinkedIn's Ad Library (`GET /rest/adLibrary`)
+        for a `linkedin` / `linkedinads` account. Rows are returned in the platform's raw shape under
+        `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).
+
+        **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is
+        in the archive only if it was delivered to the EU or UK within the last year, so a US-only
+        commercial advertiser is invisible. Spend, impressions and demographics are political-only
+        fields and are left out of the default projection; request them via `fields`. Meta serves the
+        archive only to people who confirmed their identity and location at facebook.com/ID: until the
+        Facebook user behind the connection has done so, the call fails with
+        `meta_identity_confirmation_required` (403).
+
+        **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their
+        last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets.
+        Pages are capped at 25 ads (`limit` > 25 is a 400); `after` is the next offset.
+
+        Which params apply: `q`, `countries`, `since`, `until`, `limit`, `after` on both; `pageIds`,
+        `adType`, `status`, `platforms`, `mediaType`, `languages`, `searchType`, `fields` are Meta-only;
+        `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400
+        naming the param.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: accountId, in: query, required: true, schema: { type: string }, description: "Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches." }
+        - { name: q, in: query, schema: { type: string, maxLength: 100 }, description: "Keyword search. Meta does not translate it, so write it in the ads' language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given." }
+        - { name: pageIds, in: query, schema: { type: string }, description: "Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list." }
+        - { name: advertiser, in: query, schema: { type: string, maxLength: 100 }, description: "LinkedIn only. Advertiser (Page) name to search." }
+        - { name: countries, in: query, schema: { type: string }, description: "Comma-separated ISO 3166-1 alpha-2 codes the ads reached. Meta defaults to ALL (an explicit ALL is Meta-only); LinkedIn searches every market when omitted." }
+        - { name: adType, in: query, schema: { type: string, enum: [ALL, POLITICAL_AND_ISSUE_ADS, HOUSING_ADS, EMPLOYMENT_ADS, FINANCIAL_PRODUCTS_AND_SERVICES_ADS], default: ALL }, description: "Meta only." }
+        - { name: status, in: query, schema: { type: string, enum: [ACTIVE, INACTIVE, ALL], default: ACTIVE }, description: "Meta only. ACTIVE = eligible for delivery right now." }
+        - { name: platforms, in: query, schema: { type: string }, description: "Meta only. Comma-separated publisher platforms: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, WHATSAPP, OCULUS, THREADS, STREAMING_SERVICES." }
+        - { name: mediaType, in: query, schema: { type: string, enum: [ALL, IMAGE, MEME, VIDEO, NONE] }, description: "Meta only." }
+        - { name: languages, in: query, schema: { type: string }, description: "Meta only. Comma-separated ISO 639-1 codes of the ad text." }
+        - { name: since, in: query, schema: { type: string, format: date }, description: "Earliest delivery date (YYYY-MM-DD)." }
+        - { name: until, in: query, schema: { type: string, format: date }, description: "Latest delivery date (YYYY-MM-DD)." }
+        - { name: searchType, in: query, schema: { type: string, enum: [KEYWORD_UNORDERED, KEYWORD_EXACT_PHRASE], default: KEYWORD_UNORDERED }, description: "Meta only. Whether q matches words in any order or as an exact phrase (comma-separate phrases to match all of them)." }
+        - { name: fields, in: query, schema: { type: string }, description: "Meta only. Raw Graph projection override, e.g. add spend,impressions,demographic_distribution for political ads." }
+        - { name: limit, in: query, schema: { type: integer, minimum: 1, maximum: 100, default: 25 }, description: "Rows per page. LinkedIn accepts at most 25." }
+        - { name: after, in: query, schema: { type: string }, description: "paging.after of the previous page." }
+      responses:
+        '200':
+          description: Archived ads (raw platform shape)
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [platform, data, paging]
+                properties:
+                  platform: { type: string, enum: [meta, linkedin] }
+                  data:
+                    type: array
+                    items:
+                      type: object
+                      description: "Meta: an ArchivedAd (id, page_id, page_name, ad_creation_time, ad_delivery_start_time, ad_delivery_stop_time, ad_creative_bodies[], ad_creative_link_titles[], ad_creative_link_descriptions[], ad_creative_link_captions[], ad_snapshot_url, publisher_platforms[], languages[], plus eu_total_reach, beneficiary_payers, target_ages, target_gender, target_locations, age_country_gender_reach_breakdown, total_reach_by_location on EU/UK ads). LinkedIn: { adUrl, isRestricted, details: { type, advertiser: { advertiserName, advertiserUrl, adPayer }, adStatistics: { firstImpressionAt, latestImpressionAt, totalImpressions: { from, to }, impressionsDistributionByCountry[] }, adTargeting: [{ facetName, includedSegments[], excludedSegments[] }] } } (adStatistics and adTargeting only on EU-delivered ads)."
+                  paging:
+                    type: object
+                    properties:
+                      after: { type: [string, "null"], description: "Cursor for the next page; null when exhausted." }
+                      total: { type: integer, description: "LinkedIn only. Total matching ads." }
+              examples:
+                meta:
+                  summary: Meta, an EU-delivered ad
+                  value:
+                    platform: meta
+                    data:
+                      - id: "1234567890"
+                        page_id: "811889972008357"
+                        page_name: "Zernio"
+                        ad_creation_time: "2026-08-02"
+                        ad_delivery_start_time: "2026-08-03"
+                        ad_creative_bodies: ["Schedule posts and run ads from one API."]
+                        ad_creative_link_titles: ["Zernio for developers"]
+                        ad_snapshot_url: "https://www.facebook.com/ads/archive/render_ad/?id=1234567890&access_token=..."
+                        publisher_platforms: ["facebook", "instagram"]
+                        languages: ["en"]
+                        eu_total_reach: 18400
+                        target_ages: ["25", "54"]
+                        target_gender: "All"
+                    paging: { after: "QVFIUm..." }
+                linkedin:
+                  summary: LinkedIn, an EU-delivered ad
+                  value:
+                    platform: linkedin
+                    data:
+                      - isRestricted: false
+                        adUrl: "https://www.linkedin.com/ad-library/detail/1521996423"
+                        details:
+                          type: SPONSORED_STATUS_UPDATE
+                          advertiser: { advertiserName: "CEE Microsoft Dynamics Partners", advertiserUrl: "https://www.linkedin.com/company/71491884", adPayer: "UAB Companial" }
+                          adStatistics: { firstImpressionAt: 1788623666998, latestImpressionAt: 1788780782520, totalImpressions: { from: 5000, to: 10000 }, impressionsDistributionByCountry: [] }
+                          adTargeting:
+                            - { facetName: Language, includedSegments: [polski], excludedSegments: [] }
+                            - { facetName: Location, includedSegments: [Polska], excludedSegments: [] }
+                    paging: { after: "25", total: 27147 }
+        '400': { $ref: '#/components/responses/BadRequest' }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: "Ads access required (legacy plans need the Ads add-on), or, on Meta, `meta_identity_confirmation_required`: the Facebook user behind the connection has not confirmed identity and location at facebook.com/ID."
+        '404': { description: Account not found }
+        '501': { description: Only supported on Meta and LinkedIn accounts }
+
   /v1/ads/targeting/reach-estimate:
     post:
       x-resource-group: "ads"

data/spec/api/ad_library_api_spec.rb

@@ -0,0 +1,62 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for Zernio::AdLibraryApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'AdLibraryApi' do
+  before do
+    # run before each test
+    @api_instance = Zernio::AdLibraryApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of AdLibraryApi' do
+    it 'should create an instance of AdLibraryApi' do
+      expect(@api_instance).to be_instance_of(Zernio::AdLibraryApi)
+    end
+  end
+
+  # unit tests for search_ad_library
+  # Search the public Ad Library
+  # Competitor and market research over the platform's public ad archive, searched with the customer's own connected token (no extra scope): Meta's Ad Library (`GET /ads_archive`) for a `facebook` / `instagram` / `metaads` account, LinkedIn's Ad Library (`GET /rest/adLibrary`) for a `linkedin` / `linkedinads` account. Rows are returned in the platform's raw shape under `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).  **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is in the archive only if it was delivered to the EU or UK within the last year, so a US-only commercial advertiser is invisible. Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`. Meta serves the archive only to people who confirmed their identity and location at facebook.com/ID: until the Facebook user behind the connection has done so, the call fails with `meta_identity_confirmation_required` (403).  **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets. Pages are capped at 25 ads (`limit` > 25 is a 400); `after` is the next offset.  Which params apply: `q`, `countries`, `since`, `until`, `limit`, `after` on both; `pageIds`, `adType`, `status`, `platforms`, `mediaType`, `languages`, `searchType`, `fields` are Meta-only; `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400 naming the param.
+  # @param account_id Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :q Keyword search. Meta does not translate it, so write it in the ads' language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given.
+  # @option opts [String] :page_ids Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
+  # @option opts [String] :advertiser LinkedIn only. Advertiser (Page) name to search.
+  # @option opts [String] :countries Comma-separated ISO 3166-1 alpha-2 codes the ads reached. Meta defaults to ALL (an explicit ALL is Meta-only); LinkedIn searches every market when omitted.
+  # @option opts [String] :ad_type Meta only.
+  # @option opts [String] :status Meta only. ACTIVE = eligible for delivery right now.
+  # @option opts [String] :platforms Meta only. Comma-separated publisher platforms: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, WHATSAPP, OCULUS, THREADS, STREAMING_SERVICES.
+  # @option opts [String] :media_type Meta only.
+  # @option opts [String] :languages Meta only. Comma-separated ISO 639-1 codes of the ad text.
+  # @option opts [Date] :since Earliest delivery date (YYYY-MM-DD).
+  # @option opts [Date] :_until Latest delivery date (YYYY-MM-DD).
+  # @option opts [String] :search_type Meta only. Whether q matches words in any order or as an exact phrase (comma-separate phrases to match all of them).
+  # @option opts [String] :fields Meta only. Raw Graph projection override, e.g. add spend,impressions,demographic_distribution for political ads.
+  # @option opts [Integer] :limit Rows per page. LinkedIn accepts at most 25.
+  # @option opts [String] :after paging.after of the previous page.
+  # @return [SearchAdLibrary200Response]
+  describe 'search_ad_library test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/models/search_ad_library200_response_paging_spec.rb

@@ -0,0 +1,42 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for Zernio::SearchAdLibrary200ResponsePaging
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe Zernio::SearchAdLibrary200ResponsePaging do
+  #let(:instance) { Zernio::SearchAdLibrary200ResponsePaging.new }
+
+  describe 'test an instance of SearchAdLibrary200ResponsePaging' do
+    it 'should create an instance of SearchAdLibrary200ResponsePaging' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(Zernio::SearchAdLibrary200ResponsePaging)
+    end
+  end
+
+  describe 'test attribute "after"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "total"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/models/search_ad_library200_response_spec.rb

@@ -0,0 +1,52 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for Zernio::SearchAdLibrary200Response
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe Zernio::SearchAdLibrary200Response do
+  #let(:instance) { Zernio::SearchAdLibrary200Response.new }
+
+  describe 'test an instance of SearchAdLibrary200Response' do
+    it 'should create an instance of SearchAdLibrary200Response' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(Zernio::SearchAdLibrary200Response)
+    end
+  end
+
+  describe 'test attribute "platform"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+      # validator = Petstore::EnumTest::EnumAttributeValidator.new('String', ["meta", "linkedin"])
+      # validator.allowable_values.each do |value|
+      #   expect { instance.platform = value }.not_to raise_error
+      # end
+    end
+  end
+
+  describe 'test attribute "data"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "paging"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: late-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.853
+  version: 0.0.854
 platform: ruby
 authors:
 - OpenAPI-Generator
@@ -94,6 +94,7 @@ files:
 - docs/AdEngagementCounts.md
 - docs/AdFunnelCounts.md
 - docs/AdInsightsApi.md
+- docs/AdLibraryApi.md
 - docs/AdMetrics.md
 - docs/AdPromotedObject.md
 - docs/AdReviewStatus.md
@@ -1340,6 +1341,8 @@ files:
 - docs/ScheduleBroadcastRequest.md
 - docs/SearchAdInterests200Response.md
 - docs/SearchAdInterests200ResponseInterestsInner.md
+- docs/SearchAdLibrary200Response.md
+- docs/SearchAdLibrary200ResponsePaging.md
 - docs/SearchAdTargeting200Response.md
 - docs/SearchAdTargeting200ResponseResultsInner.md
 - docs/SearchAvailablePhoneNumbers200Response.md
@@ -1922,6 +1925,7 @@ files:
 - lib/zernio-sdk/api/ad_campaigns_api.rb
 - lib/zernio-sdk/api/ad_creatives_api.rb
 - lib/zernio-sdk/api/ad_insights_api.rb
+- lib/zernio-sdk/api/ad_library_api.rb
 - lib/zernio-sdk/api/ad_targeting_api.rb
 - lib/zernio-sdk/api/analytics_api.rb
 - lib/zernio-sdk/api/api_keys_api.rb
@@ -3208,6 +3212,8 @@ files:
 - lib/zernio-sdk/models/schedule_broadcast_request.rb
 - lib/zernio-sdk/models/search_ad_interests200_response.rb
 - lib/zernio-sdk/models/search_ad_interests200_response_interests_inner.rb
+- lib/zernio-sdk/models/search_ad_library200_response.rb
+- lib/zernio-sdk/models/search_ad_library200_response_paging.rb
 - lib/zernio-sdk/models/search_ad_targeting200_response.rb
 - lib/zernio-sdk/models/search_ad_targeting200_response_results_inner.rb
 - lib/zernio-sdk/models/search_available_phone_numbers200_response.rb
@@ -3771,6 +3777,7 @@ files:
 - spec/api/ad_campaigns_api_spec.rb
 - spec/api/ad_creatives_api_spec.rb
 - spec/api/ad_insights_api_spec.rb
+- spec/api/ad_library_api_spec.rb
 - spec/api/ad_targeting_api_spec.rb
 - spec/api/analytics_api_spec.rb
 - spec/api/api_keys_api_spec.rb
@@ -5052,6 +5059,8 @@ files:
 - spec/models/schedule_broadcast_request_spec.rb
 - spec/models/search_ad_interests200_response_interests_inner_spec.rb
 - spec/models/search_ad_interests200_response_spec.rb
+- spec/models/search_ad_library200_response_paging_spec.rb
+- spec/models/search_ad_library200_response_spec.rb
 - spec/models/search_ad_targeting200_response_results_inner_spec.rb
 - spec/models/search_ad_targeting200_response_spec.rb
 - spec/models/search_available_phone_numbers200_response_numbers_inner_spec.rb
@@ -5605,7 +5614,7 @@ files:
 - spec/models/you_tube_video_retention_response_retention_curve_inner_spec.rb
 - spec/models/you_tube_video_retention_response_spec.rb
 - spec/spec_helper.rb
-- zernio-sdk-0.0.853.gem
+- zernio-sdk-0.0.854.gem
 - zernio-sdk.gemspec
 homepage: https://openapi-generator.tech
 licenses:
@@ -5637,6 +5646,7 @@ test_files:
 - spec/api/phone_numbers_api_spec.rb
 - spec/api/ad_accounts_api_spec.rb
 - spec/api/media_api_spec.rb
+- spec/api/ad_library_api_spec.rb
 - spec/api/lead_gen_api_spec.rb
 - spec/api/twitter_engagement_api_spec.rb
 - spec/api/account_settings_api_spec.rb
@@ -5937,6 +5947,7 @@ test_files:
 - spec/models/delete_google_business_media200_response_spec.rb
 - spec/models/get_inbox_post_comments200_response_meta_ad_comments_spec.rb
 - spec/models/webhook_payload_post_platform_spec.rb
+- spec/models/search_ad_library200_response_spec.rb
 - spec/models/on_whats_app_number_verification_required_request_spec.rb
 - spec/models/webhook_payload_message_message_sender_spec.rb
 - spec/models/purchase_phone_number200_response_one_of1_phone_number_spec.rb
@@ -6694,6 +6705,7 @@ test_files:
 - spec/models/create_rf_prediction_request_spec.rb
 - spec/models/get_tik_tok_creator_info200_response_posting_limits_interaction_settings_allow_duet_spec.rb
 - spec/models/create_sip_trunk201_response_termination_spec.rb
+- spec/models/search_ad_library200_response_paging_spec.rb
 - spec/models/create_discord_scheduled_event200_response_spec.rb
 - spec/models/instagram_account_insights_response_metrics_value_spec.rb
 - spec/models/adjust_conversions200_response_failures_inner_spec.rb