late-sdk 0.0.710 → 0.0.712

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d5fed9d8b79b72d8f5abb79e1baa01c17b3e7cd07abd67f9e3a7a5e7f96c792c
-  data.tar.gz: 0ed06e73bd95bd9d327f2ca06d34391fa81fba2c1b48f927957a8bdc02689928
+  metadata.gz: 2e2dede122bdc22380ddb34f95c88d683fb5293de67a7b1f103d172227d3d0a8
+  data.tar.gz: 5d62e5125f5b1e31caee6e2ba5d25eea8102e738ffa2e6a3acbd05f831435ac6
 SHA512:
-  metadata.gz: 96592ff244d21ab52dd7affece5da908d5dc43bf7d12f95f1010a2afd99444a0202a0bd012fc4db401e3c58af65d46964554cf4e1970e6361f8c296bf83b1c3e
-  data.tar.gz: 0c09ee0806644beda7672779a48a94064803080c0d9e90eded2c29a9450899309c62b2b5f8bfcf526c894e590fb528099e2572b457399af42b56ab17cfb5bb68
+  metadata.gz: 27298a74f36d392ccd5ea40600ab1ddff6d7e61f9fd1c033ae7486b4f0b0e015854fe5bff5972c66b7dbcba5a57f4a532b7068f260d3204dc4e8318c5d4e8388
+  data.tar.gz: 35950d25ac955a78cb99a5c4d9c8e6e84ac353043cc01b76740f74b2d73cd1ce86b3982bcc28ca0c4e92c745a4aaf1855a590d1dd880ae995821265321c5a089

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/AdDailyMetrics.md

@@ -18,16 +18,16 @@
 | **action_values** | **Hash<String, Float>** | Monetary mirror of `actions`, from Meta's Insights `action_values[]` array. Same keying — values are the revenue attributed to each action_type, in ad-account native currency (same unit as `spend`; see the campaign node's `currency` field). Use this to compute revenue-per-event (e.g. avg purchase value). Meta-only; other platforms return {}. | [optional] |
 | **purchase_value** | **Float** | Convenience sum of purchase-type action values — picked from `actionValues` via the same priority list as `conversions` so both fields describe the same events. In ad-account native currency. 0 when the campaign has no purchase event configured. Meta-only. | [optional] |
 | **roas** | **Float** | Return on ad spend — derived as `purchaseValue / spend`. 0 when `spend` is 0. Equivalent to Meta's `purchase_roas` under default attribution. At ad-set and campaign levels this is recomputed from summed purchaseValue + spend (NOT averaged across children) so it's mathematically correct at every rollup level. | [optional] |
-| **video_play_actions** | **Integer** | Meta video ads only (0 for non-video ads and other platforms), like all video* fields below. Number of times the video started playing (Meta `video_play_actions`), summed over the date range and across children at ad-set/campaign level. | [optional] |
-| **video30_sec_watched_actions** | **Integer** | Views of at least 30 seconds (or to the end, for shorter videos). Meta `video_30_sec_watched_actions`. | [optional] |
-| **video_thruplay_watched_actions** | **Integer** | ThruPlays (watched to completion, or at least 15 seconds). Meta `video_thruplay_watched_actions`. | [optional] |
-| **video_p25_watched_actions** | **Integer** | Views reaching 25% of the video's length. With the other percentile fields, powers hook/hold/drop-off analysis (e.g. hook rate = videoP25WatchedActions / videoPlayActions). Meta `video_p25_watched_actions`. | [optional] |
-| **video_p50_watched_actions** | **Integer** | Views reaching 50% of the video's length. Meta `video_p50_watched_actions`. | [optional] |
-| **video_p75_watched_actions** | **Integer** | Views reaching 75% of the video's length. Meta `video_p75_watched_actions`. | [optional] |
-| **video_p95_watched_actions** | **Integer** | Views reaching 95% of the video's length. Meta `video_p95_watched_actions`. | [optional] |
-| **video_p100_watched_actions** | **Integer** | Views reaching 100% of the video's length. Meta `video_p100_watched_actions`. | [optional] |
-| **video_avg_time_watched_actions** | **Float** | Average seconds watched per play (Meta `video_avg_time_watched_actions`). Aggregated over date ranges and across children as a play-weighted average (total watch time / total plays), never a plain average of averages. | [optional] |
-| **cost_per_thruplay** | **Float** | Derived `spend / videoThruplayWatchedActions`, in ad-account native currency. Rounded to 4 decimals rather than the usual 2 because a ThruPlay routinely costs well under a cent. 0 when the ad has no ThruPlays. | [optional] |
+| **video_play_actions** | **Integer** | Number of times the video started playing, summed over the date range and across children at ad-set/campaign level. 0 for non-video ads. Sources: Meta `video_play_actions`, TikTok `video_play_actions`. | [optional] |
+| **video30_sec_watched_actions** | **Integer** | Views of at least 30 seconds (or to the end, for shorter videos). Sources: Meta `video_30_sec_watched_actions` (Meta only). | [optional] |
+| **video_thruplay_watched_actions** | **Integer** | ThruPlays (watched to completion, or at least 15 seconds). Sources: Meta `video_thruplay_watched_actions` (Meta only). | [optional] |
+| **video_p25_watched_actions** | **Integer** | Views reaching 25% of the video's length. With the other percentile fields, powers hook/hold/drop-off analysis (e.g. hook rate = videoP25WatchedActions / videoPlayActions). Sources: Meta `video_p25_watched_actions`, TikTok `video_views_p25`. | [optional] |
+| **video_p50_watched_actions** | **Integer** | Views reaching 50% of the video's length. Sources: Meta `video_p50_watched_actions`, TikTok `video_views_p50`. | [optional] |
+| **video_p75_watched_actions** | **Integer** | Views reaching 75% of the video's length. Sources: Meta `video_p75_watched_actions`, TikTok `video_views_p75`. | [optional] |
+| **video_p95_watched_actions** | **Integer** | Views reaching 95% of the video's length. Sources: Meta `video_p95_watched_actions` (Meta only). | [optional] |
+| **video_p100_watched_actions** | **Integer** | Views reaching 100% of the video's length. Sources: Meta `video_p100_watched_actions`, TikTok `video_views_p100`. | [optional] |
+| **video_avg_time_watched_actions** | **Float** | Average seconds watched per play. Aggregated over date ranges and across children as a play-weighted average (total watch time / total plays), never a plain average of averages. Sources: Meta `video_avg_time_watched_actions`, TikTok `average_video_play`. | [optional] |
+| **cost_per_thruplay** | **Float** | Derived `spend / videoThruplayWatchedActions`, in ad-account native currency. Rounded to 4 decimals rather than the usual 2 because a ThruPlay routinely costs well under a cent. 0 when the ad has no ThruPlays (ThruPlay is Meta-only). | [optional] |
 | **funnel** | [**AdFunnelCounts**](AdFunnelCounts.md) |  | [optional] |
 | **engagement_breakdown** | [**AdEngagementCounts**](AdEngagementCounts.md) |  | [optional] |
 | **last_synced_at** | **Time** | Present on individual ads only, not on campaign aggregations | [optional] |

data/docs/AdMetrics.md

@@ -18,16 +18,16 @@
 | **action_values** | **Hash<String, Float>** | Monetary mirror of `actions`, from Meta's Insights `action_values[]` array. Same keying — values are the revenue attributed to each action_type, in ad-account native currency (same unit as `spend`; see the campaign node's `currency` field). Use this to compute revenue-per-event (e.g. avg purchase value). Meta-only; other platforms return {}. | [optional] |
 | **purchase_value** | **Float** | Convenience sum of purchase-type action values — picked from `actionValues` via the same priority list as `conversions` so both fields describe the same events. In ad-account native currency. 0 when the campaign has no purchase event configured. Meta-only. | [optional] |
 | **roas** | **Float** | Return on ad spend — derived as `purchaseValue / spend`. 0 when `spend` is 0. Equivalent to Meta's `purchase_roas` under default attribution. At ad-set and campaign levels this is recomputed from summed purchaseValue + spend (NOT averaged across children) so it's mathematically correct at every rollup level. | [optional] |
-| **video_play_actions** | **Integer** | Meta video ads only (0 for non-video ads and other platforms), like all video* fields below. Number of times the video started playing (Meta `video_play_actions`), summed over the date range and across children at ad-set/campaign level. | [optional] |
-| **video30_sec_watched_actions** | **Integer** | Views of at least 30 seconds (or to the end, for shorter videos). Meta `video_30_sec_watched_actions`. | [optional] |
-| **video_thruplay_watched_actions** | **Integer** | ThruPlays (watched to completion, or at least 15 seconds). Meta `video_thruplay_watched_actions`. | [optional] |
-| **video_p25_watched_actions** | **Integer** | Views reaching 25% of the video's length. With the other percentile fields, powers hook/hold/drop-off analysis (e.g. hook rate = videoP25WatchedActions / videoPlayActions). Meta `video_p25_watched_actions`. | [optional] |
-| **video_p50_watched_actions** | **Integer** | Views reaching 50% of the video's length. Meta `video_p50_watched_actions`. | [optional] |
-| **video_p75_watched_actions** | **Integer** | Views reaching 75% of the video's length. Meta `video_p75_watched_actions`. | [optional] |
-| **video_p95_watched_actions** | **Integer** | Views reaching 95% of the video's length. Meta `video_p95_watched_actions`. | [optional] |
-| **video_p100_watched_actions** | **Integer** | Views reaching 100% of the video's length. Meta `video_p100_watched_actions`. | [optional] |
-| **video_avg_time_watched_actions** | **Float** | Average seconds watched per play (Meta `video_avg_time_watched_actions`). Aggregated over date ranges and across children as a play-weighted average (total watch time / total plays), never a plain average of averages. | [optional] |
-| **cost_per_thruplay** | **Float** | Derived `spend / videoThruplayWatchedActions`, in ad-account native currency. Rounded to 4 decimals rather than the usual 2 because a ThruPlay routinely costs well under a cent. 0 when the ad has no ThruPlays. | [optional] |
+| **video_play_actions** | **Integer** | Number of times the video started playing, summed over the date range and across children at ad-set/campaign level. 0 for non-video ads. Sources: Meta `video_play_actions`, TikTok `video_play_actions`. | [optional] |
+| **video30_sec_watched_actions** | **Integer** | Views of at least 30 seconds (or to the end, for shorter videos). Sources: Meta `video_30_sec_watched_actions` (Meta only). | [optional] |
+| **video_thruplay_watched_actions** | **Integer** | ThruPlays (watched to completion, or at least 15 seconds). Sources: Meta `video_thruplay_watched_actions` (Meta only). | [optional] |
+| **video_p25_watched_actions** | **Integer** | Views reaching 25% of the video's length. With the other percentile fields, powers hook/hold/drop-off analysis (e.g. hook rate = videoP25WatchedActions / videoPlayActions). Sources: Meta `video_p25_watched_actions`, TikTok `video_views_p25`. | [optional] |
+| **video_p50_watched_actions** | **Integer** | Views reaching 50% of the video's length. Sources: Meta `video_p50_watched_actions`, TikTok `video_views_p50`. | [optional] |
+| **video_p75_watched_actions** | **Integer** | Views reaching 75% of the video's length. Sources: Meta `video_p75_watched_actions`, TikTok `video_views_p75`. | [optional] |
+| **video_p95_watched_actions** | **Integer** | Views reaching 95% of the video's length. Sources: Meta `video_p95_watched_actions` (Meta only). | [optional] |
+| **video_p100_watched_actions** | **Integer** | Views reaching 100% of the video's length. Sources: Meta `video_p100_watched_actions`, TikTok `video_views_p100`. | [optional] |
+| **video_avg_time_watched_actions** | **Float** | Average seconds watched per play. Aggregated over date ranges and across children as a play-weighted average (total watch time / total plays), never a plain average of averages. Sources: Meta `video_avg_time_watched_actions`, TikTok `average_video_play`. | [optional] |
+| **cost_per_thruplay** | **Float** | Derived `spend / videoThruplayWatchedActions`, in ad-account native currency. Rounded to 4 decimals rather than the usual 2 because a ThruPlay routinely costs well under a cent. 0 when the ad has no ThruPlays (ThruPlay is Meta-only). | [optional] |
 | **funnel** | [**AdFunnelCounts**](AdFunnelCounts.md) |  | [optional] |
 | **engagement_breakdown** | [**AdEngagementCounts**](AdEngagementCounts.md) |  | [optional] |
 | **last_synced_at** | **Time** | Present on individual ads only, not on campaign aggregations | [optional] |

data/docs/GetCampaignAnalytics200ResponseAnalyticsDailyInner.md

@@ -18,16 +18,16 @@
 | **action_values** | **Hash<String, Float>** | Monetary mirror of `actions`, from Meta's Insights `action_values[]` array. Same keying — values are the revenue attributed to each action_type, in ad-account native currency (same unit as `spend`; see the campaign node's `currency` field). Use this to compute revenue-per-event (e.g. avg purchase value). Meta-only; other platforms return {}. | [optional] |
 | **purchase_value** | **Float** | Convenience sum of purchase-type action values — picked from `actionValues` via the same priority list as `conversions` so both fields describe the same events. In ad-account native currency. 0 when the campaign has no purchase event configured. Meta-only. | [optional] |
 | **roas** | **Float** | Return on ad spend — derived as `purchaseValue / spend`. 0 when `spend` is 0. Equivalent to Meta's `purchase_roas` under default attribution. At ad-set and campaign levels this is recomputed from summed purchaseValue + spend (NOT averaged across children) so it's mathematically correct at every rollup level. | [optional] |
-| **video_play_actions** | **Integer** | Meta video ads only (0 for non-video ads and other platforms), like all video* fields below. Number of times the video started playing (Meta `video_play_actions`), summed over the date range and across children at ad-set/campaign level. | [optional] |
-| **video30_sec_watched_actions** | **Integer** | Views of at least 30 seconds (or to the end, for shorter videos). Meta `video_30_sec_watched_actions`. | [optional] |
-| **video_thruplay_watched_actions** | **Integer** | ThruPlays (watched to completion, or at least 15 seconds). Meta `video_thruplay_watched_actions`. | [optional] |
-| **video_p25_watched_actions** | **Integer** | Views reaching 25% of the video's length. With the other percentile fields, powers hook/hold/drop-off analysis (e.g. hook rate = videoP25WatchedActions / videoPlayActions). Meta `video_p25_watched_actions`. | [optional] |
-| **video_p50_watched_actions** | **Integer** | Views reaching 50% of the video's length. Meta `video_p50_watched_actions`. | [optional] |
-| **video_p75_watched_actions** | **Integer** | Views reaching 75% of the video's length. Meta `video_p75_watched_actions`. | [optional] |
-| **video_p95_watched_actions** | **Integer** | Views reaching 95% of the video's length. Meta `video_p95_watched_actions`. | [optional] |
-| **video_p100_watched_actions** | **Integer** | Views reaching 100% of the video's length. Meta `video_p100_watched_actions`. | [optional] |
-| **video_avg_time_watched_actions** | **Float** | Average seconds watched per play (Meta `video_avg_time_watched_actions`). Aggregated over date ranges and across children as a play-weighted average (total watch time / total plays), never a plain average of averages. | [optional] |
-| **cost_per_thruplay** | **Float** | Derived `spend / videoThruplayWatchedActions`, in ad-account native currency. Rounded to 4 decimals rather than the usual 2 because a ThruPlay routinely costs well under a cent. 0 when the ad has no ThruPlays. | [optional] |
+| **video_play_actions** | **Integer** | Number of times the video started playing, summed over the date range and across children at ad-set/campaign level. 0 for non-video ads. Sources: Meta `video_play_actions`, TikTok `video_play_actions`. | [optional] |
+| **video30_sec_watched_actions** | **Integer** | Views of at least 30 seconds (or to the end, for shorter videos). Sources: Meta `video_30_sec_watched_actions` (Meta only). | [optional] |
+| **video_thruplay_watched_actions** | **Integer** | ThruPlays (watched to completion, or at least 15 seconds). Sources: Meta `video_thruplay_watched_actions` (Meta only). | [optional] |
+| **video_p25_watched_actions** | **Integer** | Views reaching 25% of the video's length. With the other percentile fields, powers hook/hold/drop-off analysis (e.g. hook rate = videoP25WatchedActions / videoPlayActions). Sources: Meta `video_p25_watched_actions`, TikTok `video_views_p25`. | [optional] |
+| **video_p50_watched_actions** | **Integer** | Views reaching 50% of the video's length. Sources: Meta `video_p50_watched_actions`, TikTok `video_views_p50`. | [optional] |
+| **video_p75_watched_actions** | **Integer** | Views reaching 75% of the video's length. Sources: Meta `video_p75_watched_actions`, TikTok `video_views_p75`. | [optional] |
+| **video_p95_watched_actions** | **Integer** | Views reaching 95% of the video's length. Sources: Meta `video_p95_watched_actions` (Meta only). | [optional] |
+| **video_p100_watched_actions** | **Integer** | Views reaching 100% of the video's length. Sources: Meta `video_p100_watched_actions`, TikTok `video_views_p100`. | [optional] |
+| **video_avg_time_watched_actions** | **Float** | Average seconds watched per play. Aggregated over date ranges and across children as a play-weighted average (total watch time / total plays), never a plain average of averages. Sources: Meta `video_avg_time_watched_actions`, TikTok `average_video_play`. | [optional] |
+| **cost_per_thruplay** | **Float** | Derived `spend / videoThruplayWatchedActions`, in ad-account native currency. Rounded to 4 decimals rather than the usual 2 because a ThruPlay routinely costs well under a cent. 0 when the ad has no ThruPlays (ThruPlay is Meta-only). | [optional] |
 | **funnel** | [**AdFunnelCounts**](AdFunnelCounts.md) |  | [optional] |
 | **engagement_breakdown** | [**AdEngagementCounts**](AdEngagementCounts.md) |  | [optional] |
 | **last_synced_at** | **Time** | Present on individual ads only, not on campaign aggregations | [optional] |

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