late-sdk 0.0.710 → 0.0.711

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d5fed9d8b79b72d8f5abb79e1baa01c17b3e7cd07abd67f9e3a7a5e7f96c792c
-  data.tar.gz: 0ed06e73bd95bd9d327f2ca06d34391fa81fba2c1b48f927957a8bdc02689928
+  metadata.gz: 56ae3bd8ba940b4cc2c13e628030af1c05219411a5442ad054ad162efd5df820
+  data.tar.gz: bb08eec50b5e4eeb46ac5167e7cf01690a417b8fde0d1f7fe7f166259455522d
 SHA512:
-  metadata.gz: 96592ff244d21ab52dd7affece5da908d5dc43bf7d12f95f1010a2afd99444a0202a0bd012fc4db401e3c58af65d46964554cf4e1970e6361f8c296bf83b1c3e
-  data.tar.gz: 0c09ee0806644beda7672779a48a94064803080c0d9e90eded2c29a9450899309c62b2b5f8bfcf526c894e590fb528099e2572b457399af42b56ab17cfb5bb68
+  metadata.gz: d35aa3c5868e43010e6a3442a6f69e0606c636d6268c22f28cb3ff3889dc4cfb451e8d5e34690b5212856ad18ed4a47c992058168aa0045e4cb1ad9505e7237a
+  data.tar.gz: a28aa965f5dee8dabd0a2160da7a88d04b4b887652da0eac4bf5da2a93b5ba54b685dd5095ef492d4343cfb6d85492f0ac2f30f41e37072b17b181956400ab09

data/README.md

@@ -348,9 +348,11 @@ Class | Method | HTTP request | Description
 *Zernio::InboxAnalyticsApi* | [**get_inbox_top_accounts**](docs/InboxAnalyticsApi.md#get_inbox_top_accounts) | **GET** /v1/analytics/inbox/top-accounts | Get top accounts by inbox volume
 *Zernio::InboxAnalyticsApi* | [**get_inbox_volume**](docs/InboxAnalyticsApi.md#get_inbox_volume) | **GET** /v1/analytics/inbox/volume | Get inbox messaging volume
 *Zernio::InboxAnalyticsApi* | [**list_inbox_conversation_analytics**](docs/InboxAnalyticsApi.md#list_inbox_conversation_analytics) | **GET** /v1/analytics/inbox/conversations | List conversation analytics
+*Zernio::InstagramApi* | [**get_instagram_audio**](docs/InstagramApi.md#get_instagram_audio) | **GET** /v1/accounts/{accountId}/instagram/audio/{audioId} | Get Instagram audio metadata
 *Zernio::InstagramApi* | [**get_instagram_publishing_limit**](docs/InstagramApi.md#get_instagram_publishing_limit) | **GET** /v1/accounts/{accountId}/instagram/publishing-limit | Get Instagram publishing limit
 *Zernio::InstagramApi* | [**get_instagram_story_insights**](docs/InstagramApi.md#get_instagram_story_insights) | **GET** /v1/accounts/{accountId}/instagram/stories/{storyId}/insights | Get Instagram story insights
 *Zernio::InstagramApi* | [**list_instagram_stories**](docs/InstagramApi.md#list_instagram_stories) | **GET** /v1/accounts/{accountId}/instagram/stories | List active Instagram stories
+*Zernio::InstagramApi* | [**search_instagram_audio**](docs/InstagramApi.md#search_instagram_audio) | **GET** /v1/accounts/{accountId}/instagram/audio | Search Instagram audio
 *Zernio::InvitesApi* | [**create_invite_token**](docs/InvitesApi.md#create_invite_token) | **POST** /v1/invite/tokens | Create invite token
 *Zernio::LeadGenApi* | [**archive_lead_form**](docs/LeadGenApi.md#archive_lead_form) | **DELETE** /v1/ads/lead-forms/{formId} | Archive a lead form
 *Zernio::LeadGenApi* | [**create_lead_form**](docs/LeadGenApi.md#create_lead_form) | **POST** /v1/ads/lead-forms | Create a lead form
@@ -1209,6 +1211,7 @@ Class | Method | HTTP request | Description
  - [Zernio::GetInboxVolume200ResponseTimeseriesInner](docs/GetInboxVolume200ResponseTimeseriesInner.md)
  - [Zernio::GetInboxVolume400Response](docs/GetInboxVolume400Response.md)
  - [Zernio::GetInstagramAccountInsights404Response](docs/GetInstagramAccountInsights404Response.md)
+ - [Zernio::GetInstagramAudio200Response](docs/GetInstagramAudio200Response.md)
  - [Zernio::GetInstagramFollowStatus200Response](docs/GetInstagramFollowStatus200Response.md)
  - [Zernio::GetInstagramPublishingLimit200Response](docs/GetInstagramPublishingLimit200Response.md)
  - [Zernio::GetInstagramStoryInsights200Response](docs/GetInstagramStoryInsights200Response.md)
@@ -1399,9 +1402,11 @@ Class | Method | HTTP request | Description
  - [Zernio::InstagramAccountInsightsResponseMetricsValueBreakdownsInner](docs/InstagramAccountInsightsResponseMetricsValueBreakdownsInner.md)
  - [Zernio::InstagramAccountInsightsResponseMetricsValueValuesInner](docs/InstagramAccountInsightsResponseMetricsValueValuesInner.md)
  - [Zernio::InstagramAccountInsightsResponseUnavailableMetricsInner](docs/InstagramAccountInsightsResponseUnavailableMetricsInner.md)
+ - [Zernio::InstagramAudioAsset](docs/InstagramAudioAsset.md)
  - [Zernio::InstagramDemographicsResponse](docs/InstagramDemographicsResponse.md)
  - [Zernio::InstagramDemographicsResponseDemographicsValueInner](docs/InstagramDemographicsResponseDemographicsValueInner.md)
  - [Zernio::InstagramPlatformData](docs/InstagramPlatformData.md)
+ - [Zernio::InstagramPlatformDataAudioConfiguration](docs/InstagramPlatformDataAudioConfiguration.md)
  - [Zernio::InstagramPlatformDataTrialParams](docs/InstagramPlatformDataTrialParams.md)
  - [Zernio::InstagramPlatformDataUserTagsInner](docs/InstagramPlatformDataUserTagsInner.md)
  - [Zernio::LikeInboxComment200Response](docs/LikeInboxComment200Response.md)
@@ -1756,6 +1761,7 @@ Class | Method | HTTP request | Description
  - [Zernio::SearchInboxConversations200ResponseMeta](docs/SearchInboxConversations200ResponseMeta.md)
  - [Zernio::SearchInboxConversations200ResponseMetaAccountsSkippedInner](docs/SearchInboxConversations200ResponseMetaAccountsSkippedInner.md)
  - [Zernio::SearchInboxConversations200ResponseMetaFailedAccountsInner](docs/SearchInboxConversations200ResponseMetaFailedAccountsInner.md)
+ - [Zernio::SearchInstagramAudio200Response](docs/SearchInstagramAudio200Response.md)
  - [Zernio::SearchReddit200Response](docs/SearchReddit200Response.md)
  - [Zernio::SearchTweets200Response](docs/SearchTweets200Response.md)
  - [Zernio::SearchTweets200ResponseMeta](docs/SearchTweets200ResponseMeta.md)

data/docs/GetInstagramAudio200Response.md

@@ -0,0 +1,18 @@
+# Zernio::GetInstagramAudio200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **audio** | [**InstagramAudioAsset**](InstagramAudioAsset.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetInstagramAudio200Response.new(
+  audio: null
+)
+```
+

data/docs/InstagramApi.md

@@ -4,9 +4,82 @@ All URIs are relative to *https://zernio.com/api*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
+| [**get_instagram_audio**](InstagramApi.md#get_instagram_audio) | **GET** /v1/accounts/{accountId}/instagram/audio/{audioId} | Get Instagram audio metadata |
 | [**get_instagram_publishing_limit**](InstagramApi.md#get_instagram_publishing_limit) | **GET** /v1/accounts/{accountId}/instagram/publishing-limit | Get Instagram publishing limit |
 | [**get_instagram_story_insights**](InstagramApi.md#get_instagram_story_insights) | **GET** /v1/accounts/{accountId}/instagram/stories/{storyId}/insights | Get Instagram story insights |
 | [**list_instagram_stories**](InstagramApi.md#list_instagram_stories) | **GET** /v1/accounts/{accountId}/instagram/stories | List active Instagram stories |
+| [**search_instagram_audio**](InstagramApi.md#search_instagram_audio) | **GET** /v1/accounts/{accountId}/instagram/audio | Search Instagram audio |
+
+
+## get_instagram_audio
+
+> <GetInstagramAudio200Response> get_instagram_audio(account_id, audio_id)
+
+Get Instagram audio metadata
+
+Fetch one audio asset's metadata by ID. Use it to re-validate a stored `audioId` before a scheduled Reel publishes, or to refresh the preview `downloadUrl` (Meta expires preview URLs after roughly 1.5 days).  Same connection requirement as the search endpoint: Facebook-Login Instagram accounts only. 
+
+### 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::InstagramApi.new
+account_id = 'account_id_example' # String | The ID of the Instagram account
+audio_id = 'audio_id_example' # String | Instagram audio asset ID
+
+begin
+  # Get Instagram audio metadata
+  result = api_instance.get_instagram_audio(account_id, audio_id)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling InstagramApi->get_instagram_audio: #{e}"
+end
+```
+
+#### Using the get_instagram_audio_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetInstagramAudio200Response>, Integer, Hash)> get_instagram_audio_with_http_info(account_id, audio_id)
+
+```ruby
+begin
+  # Get Instagram audio metadata
+  data, status_code, headers = api_instance.get_instagram_audio_with_http_info(account_id, audio_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetInstagramAudio200Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling InstagramApi->get_instagram_audio_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | The ID of the Instagram account |  |
+| **audio_id** | **String** | Instagram audio asset ID |  |
+
+### Return type
+
+[**GetInstagramAudio200Response**](GetInstagramAudio200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
 
 
 ## get_instagram_publishing_limit
@@ -217,3 +290,78 @@ end
 - **Content-Type**: Not defined
 - **Accept**: application/json
 
+
+## search_instagram_audio
+
+> <SearchInstagramAudio200Response> search_instagram_audio(account_id, audio_type, opts)
+
+Search Instagram audio
+
+Search Instagram's audio catalog (licensed music or original sounds), or list what is currently trending by omitting `q`. Returns up to ~30 assets; Meta exposes no pagination on this edge.  Pass the returned `audioId` as `platformSpecificData.audioConfiguration.audioId` when creating a Reel to publish it with that track.  Requires an Instagram account connected via **Facebook Login**. Meta hosts this catalog on graph.facebook.com only, so accounts connected with classic Instagram Login receive a 400 (`instagram_audio_requires_facebook_login`) and must be reconnected choosing the Facebook option. 
+
+### 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::InstagramApi.new
+account_id = 'account_id_example' # String | The ID of the Instagram account
+audio_type = 'music' # String | Catalog to search: licensed music or original sounds from Reels.
+opts = {
+  q: 'q_example' # String | Search keywords. Omit to get the current trending list.
+}
+
+begin
+  # Search Instagram audio
+  result = api_instance.search_instagram_audio(account_id, audio_type, opts)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling InstagramApi->search_instagram_audio: #{e}"
+end
+```
+
+#### Using the search_instagram_audio_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SearchInstagramAudio200Response>, Integer, Hash)> search_instagram_audio_with_http_info(account_id, audio_type, opts)
+
+```ruby
+begin
+  # Search Instagram audio
+  data, status_code, headers = api_instance.search_instagram_audio_with_http_info(account_id, audio_type, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SearchInstagramAudio200Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling InstagramApi->search_instagram_audio_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | The ID of the Instagram account |  |
+| **audio_type** | **String** | Catalog to search: licensed music or original sounds from Reels. |  |
+| **q** | **String** | Search keywords. Omit to get the current trending list. | [optional] |
+
+### Return type
+
+[**SearchInstagramAudio200Response**](SearchInstagramAudio200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+

data/docs/InstagramAudioAsset.md

@@ -0,0 +1,38 @@
+# Zernio::InstagramAudioAsset
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **audio_id** | **String** | Audio asset ID. Pass it as platformSpecificData.audioConfiguration.audioId when creating a Reel. | [optional] |
+| **title** | **String** | Track or sound title. | [optional] |
+| **audio_type** | **String** | Catalog type of the asset. | [optional] |
+| **duration_in_ms** | **Integer** | Asset duration in milliseconds. | [optional] |
+| **display_artist** | **String** | Artist name (licensed music only). | [optional] |
+| **cover_artwork_thumbnail_url** | **String** | Cover artwork thumbnail (licensed music only). | [optional] |
+| **download_url** | **String** | Temporary preview URL. Meta expires it after roughly 1.5 days; re-fetch the asset to refresh it. | [optional] |
+| **ig_username** | **String** | Creator username (original sounds only). | [optional] |
+| **profile_picture_url** | **String** | Creator profile picture (original sounds only). | [optional] |
+| **is_ads_eligible** | **Boolean** | Whether the asset is eligible for ads use. | [optional] |
+| **on_platform_audio_preview_link** | **String** | Instagram web link to preview the audio. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::InstagramAudioAsset.new(
+  audio_id: 482851939985510,
+  title: null,
+  audio_type: null,
+  duration_in_ms: null,
+  display_artist: null,
+  cover_artwork_thumbnail_url: null,
+  download_url: null,
+  ig_username: null,
+  profile_picture_url: null,
+  is_ads_eligible: null,
+  on_platform_audio_preview_link: null
+)
+```
+

data/docs/InstagramPlatformData.md

@@ -10,7 +10,8 @@
 | **first_comment** | **String** | Optional first comment to add after the post is created (not applied to Stories) | [optional] |
 | **trial_params** | [**InstagramPlatformDataTrialParams**](InstagramPlatformDataTrialParams.md) |  | [optional] |
 | **user_tags** | [**Array<InstagramPlatformDataUserTagsInner>**](InstagramPlatformDataUserTagsInner.md) | Tag Instagram users by username. The tag shape depends on the media: photos require x/y coordinates, Reels and videos take username only (coordinates are ignored), stories accept optional coordinates. For carousels, use mediaIndex to target specific slides (defaults to 0); video slides take username-only tags. Photo tags without valid coordinates are skipped. | [optional] |
-| **audio_name** | **String** | Custom name for original audio in Reels. Replaces the default \"Original Audio\" label. Can only be set once. | [optional] |
+| **audio_name** | **String** | Custom name for original audio in Reels. Replaces the default \"Original Audio\" label. Can only be set once. Unrelated to audioConfiguration, which attaches a catalog track. | [optional] |
+| **audio_configuration** | [**InstagramPlatformDataAudioConfiguration**](InstagramPlatformDataAudioConfiguration.md) |  | [optional] |
 | **thumb_offset** | **Integer** | Millisecond offset from video start for the Reel cover frame. Ignored when instagramThumbnail or reelCover is provided. Defaults to 0. | [optional] |
 | **instagram_thumbnail** | **String** | Custom cover image URL for Instagram Reels (JPG or PNG, publicly accessible). Overrides thumbOffset when provided. Also accepted as reelCover (alias). | [optional] |
 | **reel_cover** | **String** | Alias for instagramThumbnail. If both are provided, instagramThumbnail takes priority. | [optional] |
@@ -29,6 +30,7 @@ instance = Zernio::InstagramPlatformData.new(
   trial_params: null,
   user_tags: null,
   audio_name: My Podcast Intro,
+  audio_configuration: null,
   thumb_offset: 5000,
   instagram_thumbnail: null,
   reel_cover: null,

data/docs/InstagramPlatformDataAudioConfiguration.md

@@ -0,0 +1,22 @@
+# Zernio::InstagramPlatformDataAudioConfiguration
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **audio_id** | **String** | Audio asset ID from the audio search endpoint. |  |
+| **audio_volume** | **Integer** | Volume of the attached audio track, 0-100. Defaults to 100. | [optional] |
+| **video_volume** | **Integer** | Volume of the video's own sound, 0-100. Defaults to 100. Set 0 to mute the original video audio. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::InstagramPlatformDataAudioConfiguration.new(
+  audio_id: 482851939985510,
+  audio_volume: 80,
+  video_volume: 100
+)
+```
+

data/docs/SearchInstagramAudio200Response.md

@@ -0,0 +1,18 @@
+# Zernio::SearchInstagramAudio200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **audio** | [**Array<InstagramAudioAsset>**](InstagramAudioAsset.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::SearchInstagramAudio200Response.new(
+  audio: null
+)
+```
+

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

@@ -19,6 +19,80 @@ module Zernio
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
+    # Get Instagram audio metadata
+    # Fetch one audio asset's metadata by ID. Use it to re-validate a stored `audioId` before a scheduled Reel publishes, or to refresh the preview `downloadUrl` (Meta expires preview URLs after roughly 1.5 days).  Same connection requirement as the search endpoint: Facebook-Login Instagram accounts only. 
+    # @param account_id [String] The ID of the Instagram account
+    # @param audio_id [String] Instagram audio asset ID
+    # @param [Hash] opts the optional parameters
+    # @return [GetInstagramAudio200Response]
+    def get_instagram_audio(account_id, audio_id, opts = {})
+      data, _status_code, _headers = get_instagram_audio_with_http_info(account_id, audio_id, opts)
+      data
+    end
+
+    # Get Instagram audio metadata
+    # Fetch one audio asset's metadata by ID. Use it to re-validate a stored `audioId` before a scheduled Reel publishes, or to refresh the preview `downloadUrl` (Meta expires preview URLs after roughly 1.5 days).  Same connection requirement as the search endpoint: Facebook-Login Instagram accounts only. 
+    # @param account_id [String] The ID of the Instagram account
+    # @param audio_id [String] Instagram audio asset ID
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetInstagramAudio200Response, Integer, Hash)>] GetInstagramAudio200Response data, response status code and response headers
+    def get_instagram_audio_with_http_info(account_id, audio_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: InstagramApi.get_instagram_audio ...'
+      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 InstagramApi.get_instagram_audio"
+      end
+      # verify the required parameter 'audio_id' is set
+      if @api_client.config.client_side_validation && audio_id.nil?
+        fail ArgumentError, "Missing the required parameter 'audio_id' when calling InstagramApi.get_instagram_audio"
+      end
+      pattern = Regexp.new(/^\d{1,30}$/)
+      if @api_client.config.client_side_validation && audio_id !~ pattern
+        fail ArgumentError, "invalid value for 'audio_id' when calling InstagramApi.get_instagram_audio, must conform to the pattern #{pattern}."
+      end
+
+      # resource path
+      local_var_path = '/v1/accounts/{accountId}/instagram/audio/{audioId}'.sub('{' + 'accountId' + '}', CGI.escape(account_id.to_s)).sub('{' + 'audioId' + '}', CGI.escape(audio_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # 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] || 'GetInstagramAudio200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"InstagramApi.get_instagram_audio",
+        :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: InstagramApi#get_instagram_audio\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get Instagram publishing limit
     # Returns the account's remaining content-publishing quota for Instagram's rolling 24-hour window, so you can pace publishing and warn before the cap is reached.  `quotaUsage` counts containers published since the start of the window. Always compare against the returned `quotaTotal` rather than hardcoding a number: Meta's prose documentation and the live API disagree on the value, and the live value is authoritative. 
     # @param account_id [String] The ID of the Instagram account
@@ -213,5 +287,91 @@ module Zernio
       end
       return data, status_code, headers
     end
+
+    # Search Instagram audio
+    # Search Instagram's audio catalog (licensed music or original sounds), or list what is currently trending by omitting `q`. Returns up to ~30 assets; Meta exposes no pagination on this edge.  Pass the returned `audioId` as `platformSpecificData.audioConfiguration.audioId` when creating a Reel to publish it with that track.  Requires an Instagram account connected via **Facebook Login**. Meta hosts this catalog on graph.facebook.com only, so accounts connected with classic Instagram Login receive a 400 (`instagram_audio_requires_facebook_login`) and must be reconnected choosing the Facebook option. 
+    # @param account_id [String] The ID of the Instagram account
+    # @param audio_type [String] Catalog to search: licensed music or original sounds from Reels.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :q Search keywords. Omit to get the current trending list.
+    # @return [SearchInstagramAudio200Response]
+    def search_instagram_audio(account_id, audio_type, opts = {})
+      data, _status_code, _headers = search_instagram_audio_with_http_info(account_id, audio_type, opts)
+      data
+    end
+
+    # Search Instagram audio
+    # Search Instagram&#39;s audio catalog (licensed music or original sounds), or list what is currently trending by omitting &#x60;q&#x60;. Returns up to ~30 assets; Meta exposes no pagination on this edge.  Pass the returned &#x60;audioId&#x60; as &#x60;platformSpecificData.audioConfiguration.audioId&#x60; when creating a Reel to publish it with that track.  Requires an Instagram account connected via **Facebook Login**. Meta hosts this catalog on graph.facebook.com only, so accounts connected with classic Instagram Login receive a 400 (&#x60;instagram_audio_requires_facebook_login&#x60;) and must be reconnected choosing the Facebook option. 
+    # @param account_id [String] The ID of the Instagram account
+    # @param audio_type [String] Catalog to search: licensed music or original sounds from Reels.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :q Search keywords. Omit to get the current trending list.
+    # @return [Array<(SearchInstagramAudio200Response, Integer, Hash)>] SearchInstagramAudio200Response data, response status code and response headers
+    def search_instagram_audio_with_http_info(account_id, audio_type, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: InstagramApi.search_instagram_audio ...'
+      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 InstagramApi.search_instagram_audio"
+      end
+      # verify the required parameter 'audio_type' is set
+      if @api_client.config.client_side_validation && audio_type.nil?
+        fail ArgumentError, "Missing the required parameter 'audio_type' when calling InstagramApi.search_instagram_audio"
+      end
+      # verify enum value
+      allowable_values = ["music", "original_sound"]
+      if @api_client.config.client_side_validation && !allowable_values.include?(audio_type)
+        fail ArgumentError, "invalid value for \"audio_type\", must be one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'q'].nil? && opts[:'q'].to_s.length > 200
+        fail ArgumentError, 'invalid value for "opts[:"q"]" when calling InstagramApi.search_instagram_audio, the character length must be smaller than or equal to 200.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'q'].nil? && opts[:'q'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"q"]" when calling InstagramApi.search_instagram_audio, the character length must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/v1/accounts/{accountId}/instagram/audio'.sub('{' + 'accountId' + '}', CGI.escape(account_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'audioType'] = audio_type
+      query_params[:'q'] = opts[:'q'] if !opts[:'q'].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] || 'SearchInstagramAudio200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"InstagramApi.search_instagram_audio",
+        :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: InstagramApi#search_instagram_audio\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
   end
 end

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

@@ -0,0 +1,147 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api 
+
+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 GetInstagramAudio200Response < ApiModelBase
+    attr_accessor :audio
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'audio' => :'audio'
+      }
+    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
+      {
+        :'audio' => :'InstagramAudioAsset'
+      }
+    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::GetInstagramAudio200Response` 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::GetInstagramAudio200Response`. 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?(:'audio')
+        self.audio = attributes[:'audio']
+      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 &&
+          audio == o.audio
+    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
+      [audio].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