Adsmom REST API

{"openapi":"3.0.0","paths":{"/api/v1/usage":{"get":{"operationId":"getUsage","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Usage"}}}}},"summary":"Current credits, rate limit, plan, and tracked-advertiser count","tags":["Account"]}},"/api/v1/explore/meta/ads":{"get":{"operationId":"listMetaAds","parameters":[{"name":"advertiser_id","required":false,"in":"query","description":"Filter to one advertiser (id token).","schema":{"type":"string"}},{"name":"query","required":false,"in":"query","description":"Free-text search across creative text.","schema":{"type":"string"}},{"name":"active","required":false,"in":"query","description":"true | false — active vs ended.","schema":{"type":"string"}},{"name":"started_after","required":false,"in":"query","description":"Created on/after (ISO 8601).","schema":{"type":"string"}},{"name":"updated_after","required":false,"in":"query","description":"Ingested on/after (ISO 8601).","schema":{"type":"string"}},{"name":"format","required":false,"in":"query","schema":{"type":"string","enum":["video","image"]}},{"name":"sort","required":false,"in":"query","schema":{"type":"string","enum":["newest","oldest","reach_desc"]}},{"name":"cursor","required":false,"in":"query","description":"Opaque pagination cursor.","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":25,"default":25,"type":"number"}},{"name":"ids","required":false,"in":"query","description":"Batch-hydrate ad id tokens (comma-separated, max 25). When set, filters/pagination are ignored.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MetaAdSummary"}}}}}},"security":[{"oauth":[]}],"summary":"List (or batch-hydrate) Meta ads from your tracked advertisers","tags":["Explore · Meta Ads"]}},"/api/v1/explore/meta/ads/reach":{"get":{"operationId":"batchMetaAdReach","parameters":[{"name":"from","required":false,"in":"query","description":"Start date (ISO 8601).","schema":{"type":"string"}},{"name":"to","required":false,"in":"query","description":"End date (ISO 8601).","schema":{"type":"string"}},{"name":"ids","required":false,"in":"query","description":"Ad id tokens (comma-separated, max 25).","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MetaReachTimeline"}}}}}},"security":[{"oauth":[]}],"summary":"Reach timeseries for multiple Meta ads (sync path)","tags":["Explore · Meta Ads"]}},"/api/v1/explore/meta/ads/{id_token}":{"get":{"operationId":"getMetaAd","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}},{"name":"include","required":false,"in":"query","description":"Comma-separated heavy includes: full_targeting.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaAd"}}}}},"security":[{"oauth":[]}],"summary":"Get one Meta ad","tags":["Explore · Meta Ads"]}},"/api/v1/explore/meta/ads/{id_token}/reach":{"get":{"operationId":"getMetaAdReach","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}},{"name":"from","required":false,"in":"query","description":"Start date (ISO 8601).","schema":{"type":"string"}},{"name":"to","required":false,"in":"query","description":"End date (ISO 8601).","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaReachTimeline"}}}}},"security":[{"oauth":[]}],"summary":"Daily reach timeseries for one Meta ad","tags":["Explore · Meta Ads"]}},"/api/v1/explore/tiktok/ads":{"get":{"operationId":"listTiktokAds","parameters":[{"name":"advertiser_id","required":false,"in":"query","description":"Filter to one advertiser (id token).","schema":{"type":"string"}},{"name":"query","required":false,"in":"query","description":"Free-text search across creative text.","schema":{"type":"string"}},{"name":"active","required":false,"in":"query","description":"true | false — active vs ended.","schema":{"type":"string"}},{"name":"started_after","required":false,"in":"query","description":"First shown on/after (ISO 8601).","schema":{"type":"string"}},{"name":"format","required":false,"in":"query","schema":{"type":"string","enum":["video","image"]}},{"name":"sort","required":false,"in":"query","schema":{"type":"string","enum":["newest","oldest","reach_desc"]}},{"name":"cursor","required":false,"in":"query","description":"Opaque pagination cursor.","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":25,"default":25,"type":"number"}},{"name":"ids","required":false,"in":"query","description":"Batch-hydrate ad id tokens (comma-separated, max 25). When set, filters/pagination are ignored.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TiktokAdSummary"}}}}}},"security":[{"oauth":[]}],"summary":"List (or batch-hydrate) TikTok ads from your tracked advertisers","tags":["Explore · TikTok Ads"]}},"/api/v1/explore/tiktok/ads/reach":{"get":{"operationId":"batchTiktokAdReach","parameters":[{"name":"from","required":false,"in":"query","description":"Start date (ISO 8601).","schema":{"type":"string"}},{"name":"to","required":false,"in":"query","description":"End date (ISO 8601).","schema":{"type":"string"}},{"name":"ids","required":false,"in":"query","description":"Ad id tokens (comma-separated, max 25).","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TiktokReachTimeline"}}}}}},"security":[{"oauth":[]}],"summary":"Reach timeseries for multiple TikTok ads (sync path)","tags":["Explore · TikTok Ads"]}},"/api/v1/explore/tiktok/ads/{id_token}":{"get":{"operationId":"getTiktokAd","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}},{"name":"include","required":false,"in":"query","description":"Comma-separated heavy includes: full_targeting, transcript.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TiktokAd"}}}}},"security":[{"oauth":[]}],"summary":"Get one TikTok ad","tags":["Explore · TikTok Ads"]}},"/api/v1/explore/tiktok/ads/{id_token}/reach":{"get":{"operationId":"getTiktokAdReach","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}},{"name":"from","required":false,"in":"query","description":"Start date (ISO 8601).","schema":{"type":"string"}},{"name":"to","required":false,"in":"query","description":"End date (ISO 8601).","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TiktokReachTimeline"}}}}},"security":[{"oauth":[]}],"summary":"Daily reach timeseries for one TikTok ad","tags":["Explore · TikTok Ads"]}},"/api/v1/explore/tiktok/ads/{id_token}/snapshots":{"get":{"operationId":"listTiktokAdSnapshots","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}},{"name":"cursor","required":false,"in":"query","description":"Opaque pagination cursor.","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":25,"default":25,"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TiktokAdSnapshot"}}}}}},"security":[{"oauth":[]}],"summary":"List point-in-time captures of one TikTok ad","tags":["Explore · TikTok Ads"]}},"/api/v1/explore/tiktok/ads/{id_token}/snapshots/{snapshot_uuid}":{"get":{"operationId":"getTiktokAdAtSnapshot","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}},{"name":"snapshot_uuid","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TiktokAd"}}}}},"security":[{"oauth":[]}],"summary":"Get a TikTok ad as captured at a snapshot","tags":["Explore · TikTok Ads"]}},"/api/v1/explore/google/ads":{"get":{"operationId":"listGoogleAds","parameters":[{"name":"advertiser_id","required":false,"in":"query","description":"Filter to one advertiser (id token).","schema":{"type":"string"}},{"name":"query","required":false,"in":"query","description":"Free-text search across headline and description.","schema":{"type":"string"}},{"name":"active","required":false,"in":"query","description":"true | false — active vs ended.","schema":{"type":"string"}},{"name":"started_after","required":false,"in":"query","description":"First shown on/after (ISO 8601).","schema":{"type":"string"}},{"name":"updated_after","required":false,"in":"query","description":"Last shown on/after (ISO 8601).","schema":{"type":"string"}},{"name":"format","required":false,"in":"query","schema":{"type":"string","enum":["video","image","text"]}},{"name":"sort","required":false,"in":"query","schema":{"type":"string","enum":["newest","oldest","reach_desc"]}},{"name":"cursor","required":false,"in":"query","description":"Opaque pagination cursor.","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":25,"default":25,"type":"number"}},{"name":"ids","required":false,"in":"query","description":"Batch-hydrate ad id tokens (comma-separated, max 25). When set, filters/pagination are ignored.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GoogleAdSummary"}}}}}},"security":[{"oauth":[]}],"summary":"List (or batch-hydrate) Google ads from your tracked advertisers","tags":["Explore · Google Ads"]}},"/api/v1/explore/google/ads/{id_token}":{"get":{"operationId":"getGoogleAd","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}},{"name":"include","required":false,"in":"query","description":"Comma-separated heavy includes: full_targeting.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAd"}}}}},"security":[{"oauth":[]}],"summary":"Get one Google ad","tags":["Explore · Google Ads"]}},"/api/v1/explore/linkedin/ads":{"get":{"operationId":"listLinkedinAds","parameters":[{"name":"advertiser_id","required":false,"in":"query","description":"Filter to one advertiser (id token).","schema":{"type":"string"}},{"name":"query","required":false,"in":"query","description":"Free-text search across headline and commentary.","schema":{"type":"string"}},{"name":"active","required":false,"in":"query","description":"true | false — active vs ended.","schema":{"type":"string"}},{"name":"started_after","required":false,"in":"query","description":"Started on/after (ISO 8601).","schema":{"type":"string"}},{"name":"format","required":false,"in":"query","schema":{"type":"string","enum":["video","image"]}},{"name":"sort","required":false,"in":"query","schema":{"type":"string","enum":["newest","oldest","impressions_desc"]}},{"name":"cursor","required":false,"in":"query","description":"Opaque pagination cursor.","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":25,"default":25,"type":"number"}},{"name":"ids","required":false,"in":"query","description":"Batch-hydrate ad id tokens (comma-separated, max 25). When set, filters/pagination are ignored.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/LinkedinAdSummary"}}}}}},"security":[{"oauth":[]}],"summary":"List (or batch-hydrate) LinkedIn ads from your tracked advertisers","tags":["Explore · LinkedIn Ads"]}},"/api/v1/explore/linkedin/ads/impressions":{"get":{"operationId":"batchLinkedinAdImpressions","parameters":[{"name":"from","required":false,"in":"query","description":"Start date (ISO 8601).","schema":{"type":"string"}},{"name":"to","required":false,"in":"query","description":"End date (ISO 8601).","schema":{"type":"string"}},{"name":"ids","required":false,"in":"query","description":"Ad id tokens (comma-separated, max 25).","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/LinkedinImpressionsTimeline"}}}}}},"security":[{"oauth":[]}],"summary":"Impression-bracket timeseries for multiple LinkedIn ads","tags":["Explore · LinkedIn Ads"]}},"/api/v1/explore/linkedin/ads/{id_token}":{"get":{"operationId":"getLinkedinAd","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}},{"name":"include","required":false,"in":"query","description":"Comma-separated heavy includes: full_targeting, transcript.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedinAd"}}}}},"security":[{"oauth":[]}],"summary":"Get one LinkedIn ad","tags":["Explore · LinkedIn Ads"]}},"/api/v1/explore/linkedin/ads/{id_token}/impressions":{"get":{"operationId":"getLinkedinAdImpressions","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}},{"name":"from","required":false,"in":"query","description":"Start date (ISO 8601).","schema":{"type":"string"}},{"name":"to","required":false,"in":"query","description":"End date (ISO 8601).","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedinImpressionsTimeline"}}}}},"security":[{"oauth":[]}],"summary":"Impression-bracket timeseries for one LinkedIn ad","tags":["Explore · LinkedIn Ads"]}},"/api/v1/explore/linkedin/ads/{id_token}/snapshots":{"get":{"operationId":"listLinkedinAdSnapshots","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}},{"name":"cursor","required":false,"in":"query","description":"Opaque pagination cursor.","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":25,"default":25,"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/LinkedinAdSnapshot"}}}}}},"security":[{"oauth":[]}],"summary":"List point-in-time captures of one LinkedIn ad","tags":["Explore · LinkedIn Ads"]}},"/api/v1/explore/linkedin/ads/{id_token}/snapshots/{snapshot_uuid}":{"get":{"operationId":"getLinkedinAdAtSnapshot","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}},{"name":"snapshot_uuid","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedinAd"}}}}},"security":[{"oauth":[]}],"summary":"Get a LinkedIn ad as captured at a snapshot","tags":["Explore · LinkedIn Ads"]}},"/api/v1/insights/meta/advertisers":{"get":{"operationId":"listMetaAdvertisers","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Advertiser"}}}}}},"security":[{"oauth":[]}],"summary":"List your tracked Meta advertisers","tags":["Insights · Meta"]},"post":{"operationId":"trackMetaAdvertiser","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaTrackBody"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackedAdvertiser"}}}}},"security":[{"oauth":[]}],"summary":"Track a Meta advertiser","tags":["Insights · Meta"]}},"/api/v1/insights/meta/advertisers/{id_token}":{"get":{"operationId":"getMetaAdvertiser","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Advertiser"}}}}},"security":[{"oauth":[]}],"summary":"Get a tracked Meta advertiser","tags":["Insights · Meta"]},"delete":{"operationId":"untrackMetaAdvertiser","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"oauth":[]}],"summary":"Untrack a Meta advertiser","tags":["Insights · Meta"]}},"/api/v1/insights/meta/advertisers/{id_token}/summary":{"get":{"operationId":"getMetaAdvertiserSummary","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvertiserInsight"}}}}},"security":[{"oauth":[]}],"summary":"AI insight summary for a tracked Meta advertiser","tags":["Insights · Meta"]}},"/api/v1/insights/meta/advertisers/{id_token}/reports/weekly":{"get":{"operationId":"getMetaAdvertiserWeeklyReport","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}},{"name":"week_start","required":false,"in":"query","description":"Week start date (ISO 8601). Omit for the latest report.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WeeklyReport"}}}}},"security":[{"oauth":[]}],"summary":"Weekly report for a tracked Meta advertiser","tags":["Insights · Meta"]}},"/api/v1/insights/tiktok/advertisers":{"get":{"operationId":"listTiktokAdvertisers","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Advertiser"}}}}}},"security":[{"oauth":[]}],"summary":"List your tracked TikTok advertisers","tags":["Insights · TikTok"]},"post":{"operationId":"trackTiktokAdvertiser","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TiktokTrackBody"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackedAdvertiser"}}}}},"security":[{"oauth":[]}],"summary":"Track a TikTok advertiser","tags":["Insights · TikTok"]}},"/api/v1/insights/tiktok/advertisers/{id_token}":{"get":{"operationId":"getTiktokAdvertiser","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Advertiser"}}}}},"security":[{"oauth":[]}],"summary":"Get a tracked TikTok advertiser","tags":["Insights · TikTok"]},"delete":{"operationId":"untrackTiktokAdvertiser","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"oauth":[]}],"summary":"Untrack a TikTok advertiser","tags":["Insights · TikTok"]}},"/api/v1/insights/tiktok/advertisers/{id_token}/summary":{"get":{"operationId":"getTiktokAdvertiserSummary","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvertiserInsight"}}}}},"security":[{"oauth":[]}],"summary":"AI insight summary for a tracked TikTok advertiser","tags":["Insights · TikTok"]}},"/api/v1/insights/tiktok/advertisers/{id_token}/reports/weekly":{"get":{"operationId":"getTiktokAdvertiserWeeklyReport","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}},{"name":"week_start","required":false,"in":"query","description":"Week start date (ISO 8601). Omit for the latest report.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WeeklyReport"}}}}},"security":[{"oauth":[]}],"summary":"Weekly report for a tracked TikTok advertiser","tags":["Insights · TikTok"]}},"/api/v1/insights/google/advertisers":{"get":{"operationId":"listGoogleAdvertisers","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Advertiser"}}}}}},"security":[{"oauth":[]}],"summary":"List your tracked Google advertisers","tags":["Insights · Google"]},"post":{"operationId":"trackGoogleAdvertiser","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleTrackBody"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackedAdvertiser"}}}}},"security":[{"oauth":[]}],"summary":"Track a Google advertiser","tags":["Insights · Google"]}},"/api/v1/insights/google/advertisers/{id_token}":{"get":{"operationId":"getGoogleAdvertiser","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Advertiser"}}}}},"security":[{"oauth":[]}],"summary":"Get a tracked Google advertiser","tags":["Insights · Google"]},"delete":{"operationId":"untrackGoogleAdvertiser","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"oauth":[]}],"summary":"Untrack a Google advertiser","tags":["Insights · Google"]}},"/api/v1/insights/google/advertisers/{id_token}/summary":{"get":{"operationId":"getGoogleAdvertiserSummary","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvertiserInsight"}}}}},"security":[{"oauth":[]}],"summary":"AI insight summary for a tracked Google advertiser","tags":["Insights · Google"]}},"/api/v1/insights/google/advertisers/{id_token}/reports/weekly":{"get":{"operationId":"getGoogleAdvertiserWeeklyReport","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}},{"name":"week_start","required":false,"in":"query","description":"Week start date (ISO 8601). Omit for the latest report.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WeeklyReport"}}}}},"security":[{"oauth":[]}],"summary":"Weekly report for a tracked Google advertiser","tags":["Insights · Google"]}},"/api/v1/insights/linkedin/advertisers":{"get":{"operationId":"listLinkedinAdvertisers","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Advertiser"}}}}}},"security":[{"oauth":[]}],"summary":"List your tracked LinkedIn advertisers","tags":["Insights · LinkedIn"]},"post":{"operationId":"trackLinkedinAdvertiser","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedinTrackBody"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackedAdvertiser"}}}}},"security":[{"oauth":[]}],"summary":"Track a LinkedIn advertiser","tags":["Insights · LinkedIn"]}},"/api/v1/insights/linkedin/advertisers/{id_token}":{"get":{"operationId":"getLinkedinAdvertiser","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Advertiser"}}}}},"security":[{"oauth":[]}],"summary":"Get a tracked LinkedIn advertiser","tags":["Insights · LinkedIn"]},"delete":{"operationId":"untrackLinkedinAdvertiser","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"oauth":[]}],"summary":"Untrack a LinkedIn advertiser","tags":["Insights · LinkedIn"]}},"/api/v1/insights/linkedin/advertisers/{id_token}/summary":{"get":{"operationId":"getLinkedinAdvertiserSummary","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvertiserInsight"}}}}},"security":[{"oauth":[]}],"summary":"AI insight summary for a tracked LinkedIn advertiser","tags":["Insights · LinkedIn"]}},"/api/v1/insights/linkedin/advertisers/{id_token}/reports/weekly":{"get":{"operationId":"getLinkedinAdvertiserWeeklyReport","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}},{"name":"week_start","required":false,"in":"query","description":"Week start date (ISO 8601). Omit for the latest report.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WeeklyReport"}}}}},"security":[{"oauth":[]}],"summary":"Weekly report for a tracked LinkedIn advertiser","tags":["Insights · LinkedIn"]}},"/api/v1/insights/tiktok-social/accounts":{"get":{"operationId":"listTiktokSocialAccounts","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SocialAccount"}}}}}},"security":[{"oauth":[]}],"summary":"List your tracked TikTok Organic accounts","tags":["Insights · TikTok Organic"]},"post":{"operationId":"trackTiktokSocialAccount","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialAccountTrackBody"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackedSocialAccount"}}}}},"security":[{"oauth":[]}],"summary":"Track a TikTok Organic account","tags":["Insights · TikTok Organic"]}},"/api/v1/insights/tiktok-social/accounts/{id_token}":{"get":{"operationId":"getTiktokSocialAccount","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialAccount"}}}}},"security":[{"oauth":[]}],"summary":"Get a tracked TikTok Organic account","tags":["Insights · TikTok Organic"]},"delete":{"operationId":"untrackTiktokSocialAccount","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"oauth":[]}],"summary":"Untrack a TikTok Organic account","tags":["Insights · TikTok Organic"]}},"/api/v1/insights/tiktok-social/accounts/{id_token}/summary":{"get":{"operationId":"getTiktokSocialAccountSummary","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialAccountInsight"}}}}},"security":[{"oauth":[]}],"summary":"AI insight summary for a tracked TikTok Organic account","tags":["Insights · TikTok Organic"]}},"/api/v1/insights/tiktok-social/accounts/{id_token}/reports/weekly":{"get":{"operationId":"getTiktokSocialAccountWeeklyReport","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}},{"name":"week_start","required":false,"in":"query","description":"Week start date (ISO 8601). Omit for the latest report.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialAccountWeeklyReport"}}}}},"security":[{"oauth":[]}],"summary":"Weekly organic report for a tracked TikTok Organic account","tags":["Insights · TikTok Organic"]}},"/api/v1/insights/instagram-social/accounts":{"get":{"operationId":"listInstagramSocialAccounts","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SocialAccount"}}}}}},"security":[{"oauth":[]}],"summary":"List your tracked Instagram Organic accounts","tags":["Insights · Instagram Organic"]},"post":{"operationId":"trackInstagramSocialAccount","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialAccountTrackBody"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackedSocialAccount"}}}}},"security":[{"oauth":[]}],"summary":"Track an Instagram Organic account","tags":["Insights · Instagram Organic"]}},"/api/v1/insights/instagram-social/accounts/{id_token}":{"get":{"operationId":"getInstagramSocialAccount","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialAccount"}}}}},"security":[{"oauth":[]}],"summary":"Get a tracked Instagram Organic account","tags":["Insights · Instagram Organic"]},"delete":{"operationId":"untrackInstagramSocialAccount","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"oauth":[]}],"summary":"Untrack an Instagram Organic account","tags":["Insights · Instagram Organic"]}},"/api/v1/insights/instagram-social/accounts/{id_token}/summary":{"get":{"operationId":"getInstagramSocialAccountSummary","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialAccountInsight"}}}}},"security":[{"oauth":[]}],"summary":"AI insight summary for a tracked Instagram Organic account","tags":["Insights · Instagram Organic"]}},"/api/v1/insights/instagram-social/accounts/{id_token}/reports/weekly":{"get":{"operationId":"getInstagramSocialAccountWeeklyReport","parameters":[{"name":"id_token","required":true,"in":"path","schema":{"type":"string"}},{"name":"week_start","required":false,"in":"query","description":"Week start date (ISO 8601). Omit for the latest report.","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialAccountWeeklyReport"}}}}},"security":[{"oauth":[]}],"summary":"Weekly organic report for a tracked Instagram Organic account","tags":["Insights · Instagram Organic"]}},"/api/v1/analytics/meta/reach":{"get":{"operationId":"getMetaReach","parameters":[{"name":"advertiser_ids","required":false,"in":"query","description":"Comma-separated advertiser id tokens. Defaults to all tracked.","schema":{"example":"meta.advertiser.abc,meta.advertiser.def","type":"string"}},{"name":"date_from","required":false,"in":"query","description":"Start date (ISO 8601).","schema":{"type":"string"}},{"name":"date_to","required":false,"in":"query","description":"End date (ISO 8601).","schema":{"type":"string"}},{"name":"region_codes","required":false,"in":"query","description":"Comma-separated region codes (e.g. US,GB).","schema":{"type":"string"}},{"name":"granularity","required":false,"in":"query","schema":{"example":"day","type":"string","enum":["day","week","month"]}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaReachChart"}}}}},"security":[{"oauth":[]}],"summary":"Meta reach over time, per advertiser","tags":["Analytics · Meta"]}},"/api/v1/analytics/meta/reach/regions":{"get":{"operationId":"getMetaReachRegions","parameters":[{"name":"advertiser_ids","required":false,"in":"query","description":"Comma-separated advertiser id tokens. Defaults to all tracked.","schema":{"example":"meta.advertiser.abc,meta.advertiser.def","type":"string"}},{"name":"date_from","required":false,"in":"query","description":"Start date (ISO 8601).","schema":{"type":"string"}},{"name":"date_to","required":false,"in":"query","description":"End date (ISO 8601).","schema":{"type":"string"}},{"name":"region_codes","required":false,"in":"query","description":"Comma-separated region codes (e.g. US,GB).","schema":{"type":"string"}},{"name":"granularity","required":false,"in":"query","schema":{"example":"day","type":"string","enum":["day","week","month"]}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaReachRegionsChart"}}}}},"security":[{"oauth":[]}],"summary":"Meta reach by region","tags":["Analytics · Meta"]}},"/api/v1/analytics/meta/ac

# --- truncated at 32 KB (102 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/adsmom-inc/refs/heads/main/openapi/adsmom-inc-openapi.json