Ads API Guides | Spotify for Developers

<!DOCTYPE html><html lang="en"><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width"/><link rel="icon" href="/images/favicon.ico"/><link rel="alternate" type="application/rss+xml" title="Spotify for Developers Blog" href="/rss.xml"/><title>Ads API Guides | Spotify for Developers</title><meta name="next-head-count" content="5"/><link rel="preload" href="https://developer-assets.spotifycdn.com/_next/static/css/45e40d914d96e1ea.css" as="style"/><link rel="stylesheet" href="https://developer-assets.spotifycdn.com/_next/static/css/45e40d914d96e1ea.css" data-n-g=""/><noscript data-n-css=""></noscript><script defer="" nomodule="" src="https://developer-assets.spotifycdn.com/_next/static/chunks/polyfills-42372ed130431b0a.js"></script><script src="https://developer-assets.spotifycdn.com/_next/static/chunks/webpack-db188ed8859ef64d.js" defer=""></script><script src="https://developer-assets.spotifycdn.com/_next/static/chunks/framework-cee0c71b0288f8ed.js" defer=""></script><script src="https://developer-assets.spotifycdn.com/_next/static/chunks/main-e29722dd35baabe6.js" defer=""></script><script src="https://developer-assets.spotifycdn.com/_next/static/chunks/pages/_app-22cb2970a3474f15.js" defer=""></script><script src="https://developer-assets.spotifycdn.com/_next/static/chunks/80efaec8-878ba2ae51cd8aa3.js" defer=""></script><script src="https://developer-assets.spotifycdn.com/_next/static/chunks/3094-de9a9d9517a28252.js" defer=""></script><script src="https://developer-assets.spotifycdn.com/_next/static/chunks/5681-3cc54193ee7abe5e.js" defer=""></script><script src="https://developer-assets.spotifycdn.com/_next/static/chunks/4909-6450ee824db0ae4f.js" defer=""></script><script src="https://developer-assets.spotifycdn.com/_next/static/chunks/pages/documentation/ads-api/%5B...mdx%5D-795589e7529d4120.js" defer=""></script><script src="https://developer-assets.spotifycdn.com/_next/static/r3rwF3wRfylFAVhtsmTnH/_buildManifest.js" defer=""></script><script src="https://developer-assets.spotifycdn.com/_next/static/r3rwF3wRfylFAVhtsmTnH/_ssgManifest.js" defer=""></script><style data-styled="" data-styled-version="5.3.9">body{overflow-y:visible;}/*!sc*/ data-styled.g1[id="sc-global-gQDQsF1"]{content:"sc-global-gQDQsF1,"}/*!sc*/ .dYwJAo{display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-flex-flow:column;-ms-flex-flow:column;flex-flow:column;min-height:100vh;min-height:100dvh;}/*!sc*/ data-styled.g2[id="sc-70f368a6-0"]{content:"dYwJAo,"}/*!sc*/ .ifAlMH{display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-flex-flow:column;-ms-flex-flow:column;flex-flow:column;-webkit-flex:1 1 auto;-ms-flex:1 1 auto;flex:1 1 auto;overflow-x:hidden;}/*!sc*/ data-styled.g3[id="sc-ae97880a-0"]{content:"ifAlMH,"}/*!sc*/ .AXGli{display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-flex:1 1 auto;-ms-flex:1 1 auto;flex:1 1 auto;}/*!sc*/ data-styled.g4[id="sc-7ead898e-0"]{content:"AXGli,"}/*!sc*/ .hWSKsH{box-sizing:border-box;-webkit-tap-highlight-color:transparent;padding-inline:0;margin-block:0;overflow-wrap:break-word;list-style-type:none;}/*!sc*/ .hrsDVQ{box-sizing:border-box;-webkit-tap-highlight-color:transparent;padding-inline:32px 0;margin-block:0;overflow-wrap:break-word;}/*!sc*/ data-styled.g7[id="TypeList__TypeListElement-sc-1jhixr6-0"]{content:"hWSKsH,hrsDVQ,"}/*!sc*/ .eHnYHF{position:absolute;-webkit-inset-block-start:0;-ms-intb-rlock-start:0;inset-block-start:0;inset-inline-start:0;display:inline-block;background-color:var(--background-base,#ffffff);padding-block:var(--encore-spacing-base,16px) 24px;padding-inline:var(--encore-spacing-base,16px);-webkit-text-decoration:none;text-decoration:none;z-index:9999;}/*!sc*/ .eHnYHF:focus{outline:none;}/*!sc*/ .eHnYHF:not(:focus){border:0;-webkit-clip:rect(0,0,0,0);clip:rect(0,0,0,0);height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;width:1px;}/*!sc*/ data-styled.g15[id="Link-sc-1rnxmqt-0"]{content:"eHnYHF,"}/*!sc*/ .hohWVl{box-sizing:border-box;-webkit-tap-highlight-color:transparent;color:var(--text-base,#000000);border-color:var(--essential-base,#000000);overflow-wrap:break-word;}/*!sc*/ .hohWVl::after{content:'';display:block;position:absolute;pointer-events:none;-webkit-transition:border-color 200ms ease-in;transition:border-color 200ms ease-in;box-sizing:border-box;bottom:-6px;border-bottom:3px solid transparent;width:100%;content:'';position:relative;border-color:inherit;}/*!sc*/ data-styled.g16[id="LinkText-sc-3xixkl-0"]{content:"hohWVl,"}/*!sc*/ .huwcwr{box-sizing:border-box;-webkit-tap-highlight-color:transparent;margin-block:0;font-size:1.125rem;font-weight:700;font-family:var(--encore-body-font-stack,var(--fallback-fonts,sans-serif));color:inherit;}/*!sc*/ .eyOwjh{box-sizing:border-box;-webkit-tap-highlight-color:transparent;margin-block:0;font-size:1rem;font-weight:400;font-family:var(--encore-body-font-stack,var(--fallback-fonts,sans-serif));color:var(--text-subdued,#656565);}/*!sc*/ .jFxTq{box-sizing:border-box;-webkit-tap-highlight-color:transparent;margin-block:0;font-size:0.875rem;font-weight:700;font-family:var(--encore-body-font-stack,var(--fallback-fonts,sans-serif));color:inherit;}/*!sc*/ .kqItdM{box-sizing:border-box;-webkit-tap-highlight-color:transparent;margin-block:0;font-size:1rem;font-weight:400;font-family:var(--encore-body-font-stack,var(--fallback-fonts,sans-serif));color:inherit;}/*!sc*/ .cMheqG{box-sizing:border-box;-webkit-tap-highlight-color:transparent;margin-block:0;font-size:2rem;font-weight:700;font-family:var(--encore-title-font-stack,var(--fallback-fonts,sans-serif));color:inherit;}/*!sc*/ @media (min-width:768px){.cMheqG{font-size:3rem;}}/*!sc*/ .ckCbjl{box-sizing:border-box;-webkit-tap-highlight-color:transparent;margin-block:0;font-size:1rem;font-weight:400;font-family:var(--encore-body-font-stack,var(--fallback-fonts,sans-serif));padding-block-end:12px;color:inherit;}/*!sc*/ .bXWpix{box-sizing:border-box;-webkit-tap-highlight-color:transparent;margin-block:0;font-size:0.875rem;font-weight:400;font-family:var(--encore-body-font-stack,var(--fallback-fonts,sans-serif));color:inherit;}/*!sc*/ data-styled.g17[id="Type__TypeElement-sc-goli3j-0"]{content:"huwcwr,eyOwjh,jFxTq,kqItdM,cMheqG,ckCbjl,bXWpix,"}/*!sc*/ .kqbyZR{display:list-item;padding-block-end:1em;}/*!sc*/ data-styled.g20[id="TypeListItem__TypeListItemElement-sc-q1l2mf-0"]{content:"kqbyZR,"}/*!sc*/ .bKOEJW{box-sizing:border-box;-webkit-tap-highlight-color:transparent;color:inherit;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;-webkit-text-decoration:none;text-decoration:none;color:var(--text-subdued,#656565);}/*!sc*/ .bKOEJW[href],.bKOEJW:hover:not([disabled]){-webkit-text-decoration:underline;text-decoration:underline;}/*!sc*/ .bKOEJW[href]:hover{-webkit-text-decoration:underline;text-decoration:underline;color:var(--text-bright-accent,#107434);}/*!sc*/ .bKOEJW[href]:focus{outline:none;box-shadow:0 3px 0 0;-webkit-transition:box-shadow 200ms ease-in;transition:box-shadow 200ms ease-in;}/*!sc*/ .bKOEJW[href]:focus.Link-sc-k8gsk-0[href]:focus{-webkit-text-decoration:none;text-decoration:none;}/*!sc*/ .bKOEJW[href]:active{color:var(--text-bright-accent,#107434);}/*!sc*/ .bKOEJW[disabled],.bKOEJW[href][disabled],.bKOEJW[aria-disabled='true']{color:var(--text-subdued,#656565);opacity:0.3;cursor:not-allowed;}/*!sc*/ .bKOEJW,.bKOEJW[href]{-webkit-text-decoration:none;text-decoration:none;}/*!sc*/ .bKOEJW[href]:focus{-webkit-text-decoration:none;text-decoration:none;color:var(--text-base,#000000);}/*!sc*/ .bKOEJW[href]:active{-webkit-text-decoration:underline;text-decoration:underline;color:var(--text-base,#000000);}/*!sc*/ .bKOEJW[href]:hover,.bKOEJW[href]:hover:focus{-webkit-text-decoration:underline;text-decoration:underline;color:var(--text-subdued,#656565);}/*!sc*/ .bKOEJW[disabled],.bKOEJW[href][disabled],.bKOEJW[aria-disabled='true']{-webkit-text-decoration:none;text-decoration:none;}/*!sc*/ .flYERd{box-sizing:border-box;-webkit-tap-highlight-color:transparent;color:var(--text-positive,#107434);-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;-webkit-text-decoration:none;text-decoration:none;}/*!sc*/ .flYERd[href],.flYERd:hover:not([disabled]){-webkit-text-decoration:underline;text-decoration:underline;}/*!sc*/ .flYERd[href]:hover{-webkit-text-decoration:underline;text-decoration:underline;color:var(--text-positive,#107434);}/*!sc*/ .flYERd[href]:focus{outline:none;box-shadow:0 3px 0 0;-webkit-transition:box-shadow 200ms ease-in;transition:box-shadow 200ms ease-in;}/*!sc*/ .flYERd[href]:focus.Link-sc-k8gsk-0[href]:focus{-webkit-text-decoration:none;text-decoration:none;}/*!sc*/ .flYERd[href]:active{color:var(--text-bright-accent,#107434);}/*!sc*/ .flYERd[disabled],.flYERd[href][disabled],.flYERd[aria-disabled='true']{color:var(--text-subdued,#656565);opacity:0.3;cursor:not-allowed;}/*!sc*/ data-styled.g21[id="Link-sc-k8gsk-0"]{content:"bKOEJW,flYERd,"}/*!sc*/ .hDhnlR{box-sizing:border-box;-webkit-tap-highlight-color:transparent;background-color:transparent;border:0;border-radius:var(--encore-button-corner-radius,9999px);cursor:pointer;display:inline-block;text-align:center;-webkit-text-decoration:none;text-decoration:none;text-transform:none;touch-action:manipulation;-webkit-transition-duration:33ms;transition-duration:33ms;-webkit-transition-property:background-color,border-color,color,box-shadow,filter,-webkit-transform;-webkit-transition-property:background-color,border-color,color,box-shadow,filter,transform;transition-property:background-color,border-color,color,box-shadow,filter,transform;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;vertical-align:middle;-webkit-transform:translate3d(0,0,0);-ms-transform:translate3d(0,0,0);transform:translate3d(0,0,0);color:var(--text-base,#000000);min-inline-size:0;min-block-size:var(--encore-control-size-base,48px);padding-block:var(--encore-spacing-tighter,12px);padding-inline:var(--encore-spacing-tighter,12px);display:-webkit-inline-box;display:-webkit-inline-flex;display:-ms-inline-flexbox;display:inline-flex;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;-webkit-box-pack:center;-webkit-justify-content:center;-ms-flex-pack:center;justify-content:center;position:relative;}/*!sc*/ .hDhnlR:hover{-webkit-transform:scale(1.04);-ms-transform:scale(1.04);transform:scale(1.04);}/*!sc*/ .hDhnlR:active{opacity:0.7;outline:none;-webkit-transform:scale(1);-ms-transform:scale(1);transform:scale(1);color:var(--text-base,#000000);}/*!sc*/ .hDhnlR:focus{outline:none;}/*!sc*/ .hDhnlR::after{content:'';display:block;position:absolute;pointer-events:none;-webkit-transition:border-color 200ms ease-in;transition:border-color 200ms ease-in;box-sizing:border-box;bottom:5px;border-bottom:3px solid transparent;width:100%;}/*!sc*/ .hDhnlR:focus::after{border-color:inherit;}/*!sc*/ .hDhnlR::after{inline-size:24px;}/*!sc*/ .hDhnlR[disabled],.hDhnlR[aria-disabled='true'],fieldset[disabled] .hDhnlR{cursor:not-allowed;opacity:0.3;-webkit-transform:scale(1);-ms-transform:scale(1);transform:scale(1);color:var(--text-base,#000000);}/*!sc*/ .hDhnlR[disabled]::before,.hDhnlR[aria-disabled='true']::before,fieldset[disabled] .hDhnlR::before{background-color:transparent;}/*!sc*/ .hDhnlR[disabled]::after,.hDhnlR[aria-disabled='true']::after,fieldset[disabled] .hDhnlR::after{border-color:transparent;}/*!sc*/ data-styled.g23[id="Button-sc-1dqy6lx-0"]{content:"hDhnlR,"}/*!sc*/ .jyHIqB{display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;}/*!sc*/ data-styled.g24[id="IconWrapper__Wrapper-sc-16usrgb-0"]{content:"jyHIqB,"}/*!sc*/ .hQQTps{max-inline-size:100%;-webkit-block-size:auto;-ms-flex-block-size:auto;block-size:auto;}/*!sc*/ data-styled.g34[id="Image-sc-1u215sg-3"]{content:"hQQTps,"}/*!sc*/ *{box-sizing:border-box;}/*!sc*/ *::before,*::after{box-sizing:border-box;}/*!sc*/ body{margin:0;}/*!sc*/ body,input,textarea,button{font-family:var(--encore-body-font-stack);}/*!sc*/ html,body{height:100%;}/*!sc*/ data-styled.g116[id="sc-global-cnFbJs1"]{content:"sc-global-cnFbJs1,"}/*!sc*/ @media screen and (max-width:991px){.dPqbzU{background-color:var(--background-base,#ffffff);position:fixed;left:0;top:64px;bottom:0;padding:0;width:100vw;overflow-y:auto;z-index:1030;}.dPqbzU.panel-enter{left:100vw;}.dPqbzU.panel-enter-active{left:0;-webkit-transition-property:left;transition-property:left;}.dPqbzU.panel-exit{display:block;opacity:1;}.dPqbzU.panel-exit-active{display:block;opacity:0;-webkit-transition-property:opacity;transition-property:opacity;}}/*!sc*/ @media not (prefers-reduced-motion){.dPqbzU{-webkit-transition-duration:250ms;transition-duration:250ms;-webkit-transition-timing-function:cubic-bezier(0.3,0,0,1);transition-timing-function:cubic-bezier(0.3,0,0,1);}}/*!sc*/ data-styled.g197[id="sc-9fff6009-0"]{content:"dPqbzU,"}/*!sc*/ @media screen and (min-width:992px){.ljywHx{position:absolute;left:50%;top:calc(100% - 3px);-webkit-transform:translateX(-50%);-ms-transform:translateX(-50%);transform:translateX(-50%);-webkit-transform-origin:top;-ms-transform-origin:top;transform-origin:top;white-space:nowrap;z-index:1030;background-color:var(--background-base,#ffffff);border-radius:8px;box-shadow:0px 6px 18px rgba(0,0,0,0.2);padding:32px 40px 32px 64px;}.ljywHx.panel-enter{opacity:0;-webkit-transform:translateX(-50%) rotateX(-10deg);-ms-transform:translateX(-50%) rotateX(-10deg);transform:translateX(-50%) rotateX(-10deg);}.ljywHx.panel-enter-active{opacity:1;-webkit-transform:translateX(-50%) rotateX(0deg);-ms-transform:translateX(-50%) rotateX(0deg);transform:translateX(-50%) rotateX(0deg);-webkit-transition-property:-webkit-transform,opacity;-webkit-transition-property:transform,opacity;transition-property:transform,opacity;}.ljywHx.panel-exit{display:block;opacity:1;-webkit-transform:translateX(-50%) rotateX(0deg);-ms-transform:translateX(-50%) rotateX(0deg);transform:translateX(-50%) rotateX(0deg);}.ljywHx.panel-exit-active{display:block;opacity:0;-webkit-transform:translateX(-50%) rotateX(-10deg);-ms-transform:translateX(-50%) rotateX(-10deg);transform:translateX(-50%) rotateX(-10deg);-webkit-transition-property:-webkit-transform,opacity;-webkit-transition-property:transform,opacity;transition-property:transform,opacity;}}/*!sc*/ data-styled.g198[id="sc-147783a9-0"]{content:"ljywHx,"}/*!sc*/ .jYFMfm{width:32px;height:32px;}/*!sc*/ .jYFMfm path{-webkit-transition:all 500ms;transition:all 500ms;-webkit-transition-timing-function:cubic-bezier(0.3,0,0,1);transition-timing-function:cubic-bezier(0.3,0,0,1);}/*!sc*/ @media (prefers-reduced-motion){.jYFMfm path{-webkit-transition:none;transition:none;}}/*!sc*/ .jYFMfm path:nth-child(1){-webkit-transform-origin:3.5px 8px;-ms-transform-origin:3.5px 8px;transform-origin:3.5px 8px;-webkit-transform:rotate( 0deg );-ms-transform:rotate( 0deg );transform:rotate( 0deg );}/*!sc*/ .jYFMfm path:nth-child(2){opacity:1;}/*!sc*/ .jYFMfm path:nth-child(3){-webkit-transform-origin:3.5px 16px;-ms-transform-origin:3.5px 16px;transform-origin:3.5px 16px;-webkit-transform:rotate( 0deg );-ms-transform:rotate( 0deg );transform:rotate( 0deg );}/*!sc*/ data-styled.g199[id="sc-bbfbffd5-0"]{content:"jYFMfm,"}/*!sc*/ .kMlpAI{--background-base:#e91429 !important;--background-highlight:#d81326 !important;--background-press:#a60e1d !important;--background-elevated-base:#d81326 !important;--background-elevated-highlight:#d81326 !important;--background-elevated-press:#a60e1d !important;--background-tinted-base:#e91429 !important;--background-tinted-highlight:#e91429 !important;--background-tinted-press:#e91429 !important;--text-base:#ffffff !important;--text-subdued:#ffffff !important;--text-bright-accent:#ffffff !important;--text-negative:#ffffff !important;--text-warning:#ffffff !important;--text-positive:#ffffff !important;--text-announcement:#ffffff !important;--essential-base:#ffffff !important;--essential-subdued:#ffffff !important;--essential-bright-accent:#ffffff !important;--essential-negative:#ffffff !important;--essential-warning:#ffffff !important;--essential-positive:#ffffff !important;--essential-announcement:#ffffff !important;--decorative-base:#ffffff !important;--decorative-subdued:#ee3a4c !important;display:none;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;-webkit-box-pack:center;-webkit-justify-content:center;-ms-flex-pack:center;justify-content:center;-webkit-flex:0 0 auto;-ms-flex:0 0 auto;flex:0 0 auto;width:1.5rem;height:1.5rem;font-size:0.75rem;margin-left:12px;color:var(--text-base,#000000);background-color:var(--background-base,#ffffff);border-radius:100%;}/*!sc*/ data-styled.g200[id="sc-854fa934-0"]{content:"kMlpAI,"}/*!sc*/ .kUBZjS{position:absolute;pointer-events:none;top:0.5rem;right:0.5rem;}/*!sc*/ data-styled.g201[id="sc-c6c8ec75-0"]{content:"kUBZjS,"}/*!sc*/ @media screen and (min-width:992px){.cgDIHL.cgDIHL{display:none;}}/*!sc*/ data-styled.g202[id="sc-960b9084-0"]{content:"cgDIHL,"}/*!sc*/ @media screen and (max-width:991px){.hINOnu.hINOnu{display:none;}}/*!sc*/ data-styled.g203[id="sc-61e0ff0f-0"]{content:"hINOnu,"}/*!sc*/ .cKvXqF{border-radius:0;outline:transparent solid 3px;outline-offset:-3px;-webkit-transition:outline-color 200ms ease-in;transition:outline-color 200ms ease-in;background:none;border:none;color:var(--text-base,#000000);cursor:pointer;display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-box-pack:justify;-webkit-justify-content:space-between;-ms-flex-pack:justify;justify-content:space-between;padding:12px 24px;width:100%;}/*!sc*/ .cKvXqF:focus-visible{outline-color:var(--essential-base,#000000);}/*!sc*/ @supports not selector(:focus-visible){.cKvXqF{outline:transparent solid 1.5px;outline-offset:-2px;}.cKvXqF:focus{outline-color:var(--essential-base,#000000);}}/*!sc*/ data-styled.g204[id="sc-226e2e15-0"]{content:"cKvXqF,"}/*!sc*/ .fZekVo{border-radius:12px;outline:transparent solid 3px;outline-offset:6px;-webkit-transition:outline-color 200ms ease-in;transition:outline-color 200ms ease-in;display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;gap:12px;-webkit-box-pack:justify;-webkit-justify-content:space-between;-ms-flex-pack:justify;justify-content:space-between;color:var(--text-base,#000000);cursor:pointer;-webkit-text-decoration:none;text-decoration:none;}/*!sc*/ .fZekVo:focus-visible{outline-color:var(--essential-base,#000000);}/*!sc*/ @supports not selector(:focus-visible){.fZekVo{outline:transparent solid 1.5px;outline-offset:4px;}.fZekVo:focus{outline-color:var(--essential-base,#000000);}}/*!sc*/ .fZekVo > span{display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;gap:12px;}/*!sc*/ .fZekVo:hover,.fZekVo:focus{color:var(--text-positive,#107434);}/*!sc*/ @media screen and (max-width:991px){.fZekVo{border-radius:0;outline:transparent solid 3px;outline-offset:-3px;-webkit-transition:outline-color 200ms ease-in;transition:outline-color 200ms ease-in;padding:12px 24px;}.fZekVo:focus-visible{outline-color:var(--essential-base,#000000);}@supports not selector(:focus-visible){.fZekVo{outline:transparent solid 1.5px;outline-offset:-2px;}.fZekVo:focus{outline-color:var(--essential-base,#000000);}}}/*!sc*/ data-styled.g205[id="sc-57f92064-0"]{content:"fZekVo,"}/*!sc*/ @media screen and (min-width:992px){.bfMHgv.bfMHgv{display:none;}}/*!sc*/ data-styled.g206[id="sc-57f92064-1"]{content:"bfMHgv,"}/*!sc*/ @media screen and (min-width:992px){.daFODJ{display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-box-pack:justify;-webkit-justify-content:space-between;-ms-flex-pack:justify;justify-content:space-between;gap:12px;}}/*!sc*/ data-styled.g207[id="sc-e3bdb244-0"]{content:"daFODJ,"}/*!sc*/ .fngAVZ{position:relative;}/*!sc*/ @media screen and (min-width:992px){.fngAVZ{-webkit-perspective:999px;-moz-perspective:999px;-ms-perspective:999px;perspective:999px;}}/*!sc*/ data-styled.g208[id="sc-daaf2fce-0"]{content:"fngAVZ,"}/*!sc*/ .ggRfAl{background:none;border:0;color:var(--text-base,#000000);cursor:pointer;-webkit-text-decoration:none;text-decoration:none;font-size:1.33rem;}/*!sc*/ @media screen and (max-width:991px){.ggRfAl{border-radius:0;outline:transparent solid 3px;outline-offset:-3px;-webkit-transition:outline-color 200ms ease-in;transition:outline-color 200ms ease-in;background-color:var(--background-highlight,#f5f5f5);display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;margin:2px 0;padding:12px 24px;-webkit-box-pack:justify;-webkit-justify-content:space-between;-ms-flex-pack:justify;justify-content:space-between;width:100%;}.ggRfAl:focus-visible{outline-color:var(--essential-base,#000000);}@supports not selector(:focus-visible){.ggRfAl{outline:transparent solid 1.5px;outline-offset:-2px;}.ggRfAl:focus{outline-color:var(--essential-base,#000000);}}}/*!sc*/ @media screen and (min-width:992px){.ggRfAl{border-radius:28px;outline:transparent solid 3px;outline-offset:6px;-webkit-transition:outline-color 200ms ease-in;transition:outline-color 200ms ease-in;display:inline-block;padding:8px 16px;-webkit-transition:0.2s color linear,0.2s outline-color ease-in;transition:0.2s color linear,0.2s outline-color ease-in;white-space:nowrap;}.ggRfAl:focus-visible{outline-color:var(--essential-base,#000000);}@supports not selector(:focus-visible){.ggRfAl{outline:transparent solid 1.5px;outline-offset:4px;}.ggRfAl:focus{outline-color:var(--essential-base,#000000);}}.ggRfAl:hover{color:var(--text-bright-accent,#107434);}.ggRfAl[data-active]{color:var(--text-bright-accent,#107434);font-weight:700;}.ggRfAl[data-active]::after{content:'';display:block;border-top:2px solid var(--text-bright-accent,#107434);width:1em;position:absolute;bottom:0px;left:calc(50% - 0.5em);}}/*!sc*/ data-styled.g209[id="sc-a671ab29-0"]{content:"ggRfAl,"}/*!sc*/ @media screen and (min-width:992px){.iIHRIb.iIHRIb{display:none;}}/*!sc*/ data-styled.g210[id="sc-a671ab29-1"]{content:"iIHRIb,"}/*!sc*/ .dKipnq{border-radius:0;outline:transparent solid 3px;outline-offset:-3px;-webkit-transition:outline-color 200ms ease-in;transition:outline-color 200ms ease-in;display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;gap:8px;background-color:var(--background-highlight,#f5f5f5);border:none;color:var(--text-base,#000000);cursor:pointer;margin-bottom:12px;padding:12px 24px;width:100%;}/*!sc*/ .dKipnq:focus-visible{outline-color:var(--essential-base,#000000);}/*!sc*/ @supports not selector(:focus-visible){.dKipnq{outline:transparent solid 1.5px;outline-offset:-2px;}.dKipnq:focus{outline-color:var(--essential-base,#000000);}}/*!sc*/ data-styled.g211[id="sc-1a8d3606-0"]{content:"dKipnq,"}/*!sc*/ @media screen and (min-width:992px){.jzFsff.jzFsff{display:none;}}/*!sc*/ data-styled.g212[id="sc-a8ce54c5-0"]{content:"jzFsff,"}/*!sc*/ @media screen and (min-width:992px){.kRyiQK{--background-base:#FFFFFF !important;--background-highlight:#40007312 !important;--background-press:#FFFFFF !important;--background-elevated-base:#400073 !important;--background-elevated-highlight:#FFFFFF !important;--background-elevated-press:#FFFFFF !important;--background-tinted-base:#40007314 !important;--background-tinted-highlight:#DACFE6 !important;--background-tinted-press:#FFFFFF !important;--decorative-base:#400073 !important;--decorative-subdued:#bdb1cb !important;--essential-base:#000000 !important;--essential-subdued:#D7DBFF !important;--essential-bright-accent:#CDF56466 !important;--essential-negative:#000000 !important;--essential-warning:#000000 !important;--essential-positive:#000000 !important;--essential-announcement:#000000 !important;--text-base:#181818 !important;--text-subdued:#282828 !important;--text-bright-accent:#400073 !important;--text-negative:#000000 !important;--text-warning:#000000 !important;--text-positive:#8C20DF !important;--text-announcement:#000000 !important;display:grid;grid-template-columns:repeat(2,minmax(200px,1fr));-webkit-column-gap:32px;column-gap:32px;row-gap:16px;}}/*!sc*/ data-styled.g213[id="sc-ca6f2bb9-0"]{content:"kRyiQK,"}/*!sc*/ .yjgPF{display:block;margin:12px 0;text-transform:uppercase;}/*!sc*/ @media screen and (max-width:991px){.yjgPF{margin:12px 24px;}}/*!sc*/ @media screen and (min-width:992px){.yjgPF{margin-left:4px;}.sc-147783a9-0 .sc-45697e4e-0:first-of-type{margin:0 0 20px;}.sc-147783a9-0 .sc-45697e4e-0:not(:first-of-type){border-top:1px solid var(--decorative-subdued,#dedede);margin:20px 0;padding-top:16px;}}/*!sc*/ data-styled.g214[id="sc-45697e4e-0"]{content:"yjgPF,"}/*!sc*/ .fyfvvy{display:inline-block;border-radius:17px;outline:transparent solid 3px;outline-offset:6px;-webkit-transition:outline-color 200ms ease-in;transition:outline-color 200ms ease-in;}/*!sc*/ .fyfvvy:focus-visible{outline-color:var(--essential-base,#000000);}/*!sc*/ @supports not selector(:focus-visible){.fyfvvy{outline:transparent solid 1.5px;outline-offset:4px;}.fyfvvy:focus{outline-color:var(--essential-base,#000000);}}/*!sc*/ .fyfvvy svg{fill:var(--text-base,#000000);max-width:100%;vertical-align:middle;}/*!sc*/ .iUCAkX{display:inline-block;border-radius:17px;outline:transparent solid 3px;outline-offset:6px;-webkit-transition:outline-color 200ms ease-in;transition:outline-color 200ms ease-in;width:192px;}/*!sc*/ .iUCAkX:focus-visible{outline-color:var(--essential-base,#000000);}/*!sc*/ @supports not selector(:focus-visible){.iUCAkX{outline:transparent solid 1.5px;outline-offset:4px;}.iUCAkX:focus{outline-color:var(--essential-base,#000000);}}/*!sc*/ .iUCAkX svg{fill:var(--text-base,#000000);max-width:100%;vertical-align:middle;}/*!sc*/ data-styled.g218[id="sc-539db49-0"]{content:"fyfvvy,iUCAkX,"}/*!sc*/ html{-webkit-scroll-padding-top:calc(72px + 8px);-moz-scroll-padding-top:calc(72px + 8px);-ms-scroll-padding-top:calc(72px + 8px);scroll-padding-top:calc(72px + 8px);}/*!sc*/ @media screen and (max-width:991px){html{-webkit-scroll-padding-top:calc(64px + 8px);-moz-scroll-padding-top:calc(64px + 8px);-ms-scroll-padding-top:calc(64px + 8px);scroll-padding-top:calc(64px + 8px);}}/*!sc*/ data-styled.g219[id="sc-global-eXqpKN1"]{content:"sc-global-eXqpKN1,"}/*!sc*/ .eaUSlL{--background-base:#1E073C !important;--background-highlight:#290A50 !important;--background-press:#07020E !important;--background-elevated-base:#400073 !important;--background-elevated-highlight:#8C20DF !important;--background-elevated-press:#3C0068 !important;--background-tinted-base:#0F041D !important;--background-tinted-highlight:#551E99 !important;--background-tinted-press:#A269CF !important;--text-base:#FFFFFF !important;--text-subdued:#D8A3FF !important;--text-bright-accent:#CBF55C !important;--text-negative:#FFFFFF !important;--text-warning:#FFFFFF !important;--text-positive:#FFFFFF !important;--text-announcement:#FFFFFF !important;--decorative-base:#FFFFFF !important;--decorative-subdued:#5C13B5 !important;--essential-base:#CBF55C !important;--essential-subdued:#738A36 !important;--essential-bright-accent:#FFFFFF !important;--essential-negative:#FFFFFF !important;--essential-warning:#FFFFFF !important;--essential-positive:#FFFFFF !important;--essential-announcement:#FFFFFF !important;color:var(--text-base,#000000);position:-webkit-sticky;position:sticky;top:0;z-index:1030;background-color:var(--background-elevated-base,#ffffff);border-bottom:1px solid rgba(255,255,255,0.1);-webkit-box-pack:justify;-webkit-justify-content:space-between;-ms-flex-pack:justify;justify-content:space-between;padding-left:24px;padding-right:24px;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-flex:none;-ms-flex:none;flex:none;height:72px;}/*!sc*/ @media screen and (max-width:991px){.eaUSlL{height:64px;padding-left:16px;padding-right:4px;}}/*!sc*/ data-styled.g220[id="sc-5dd3d1dd-0"]{content:"eaUSlL,"}/*!sc*/ .jFBprj{-webkit-box-flex:3;-webkit-flex-grow:3;-ms-flex-positive:3;flex-grow:3;}/*!sc*/ data-styled.g221[id="sc-5dd3d1dd-1"]{content:"jFBprj,"}/*!sc*/ .gEpGzO{-webkit-box-flex:3;-webkit-flex-grow:3;-ms-flex-positive:3;flex-grow:3;-webkit-flex-basis:240px;-ms-flex-preferred-size:240px;flex-basis:240px;text-align:right;}/*!sc*/ data-styled.g223[id="sc-5dd3d1dd-3"]{content:"gEpGzO,"}/*!sc*/ .fdpdGa{-webkit-flex:1 1 auto;-ms-flex:1 1 auto;flex:1 1 auto;}/*!sc*/ data-styled.g224[id="sc-7eae9c62-0"]{content:"fdpdGa,"}/*!sc*/ .byLwnG{background-color:var(--background-base,#ffffff);color:var(--text-subdued,#656565);padding:56px 6vw 56px;justify-self:end;}/*!sc*/ @media (max-width:991px){.byLwnG{padding:24px 6vw 48px;}}/*!sc*/ data-styled.g225[id="sc-79176060-0"]{content:"byLwnG,"}/*!sc*/ .dPgCwV{display:grid;grid-template-columns:repeat(6,auto);-webkit-column-gap:12px;column-gap:12px;row-gap:24px;max-width:1200px;}/*!sc*/ @media (max-width:991px){.dPgCwV{grid-template-columns:repeat(2,auto);}}/*!sc*/ data-styled.g226[id="sc-79176060-1"]{content:"dPgCwV,"}/*!sc*/ .gpumOS{grid-column:span 2;}/*!sc*/ data-styled.g227[id="sc-79176060-2"]{content:"gpumOS,"}/*!sc*/ .fBSVgz > h3{margin:8px 0 16px;text-transform:uppercase;}/*!sc*/ @media (max-width:991px){.fBSVgz:first-of-type{grid-row:span 2;}}/*!sc*/ data-styled.g228[id="sc-79176060-3"]{content:"fBSVgz,"}/*!sc*/ .ckOHVi{color:var(--text-base,#000000);}/*!sc*/ data-styled.g229[id="sc-79176060-4"]{content:"ckOHVi,"}/*!sc*/ .dgothR{margin-top:56px;text-align:right;}/*!sc*/ .dgothR > *:not(:first-child){margin-left:20px;}/*!sc*/ data-styled.g230[id="sc-79176060-5"]{content:"dgothR,"}/*!sc*/ #onetrust-banner-sdk{overscroll-behavior:none;-webkit-flex-wrap:wrap;-ms-flex-wrap:wrap;flex-wrap:wrap;}/*!sc*/ data-styled.g234[id="sc-global-euAyPy1"]{content:"sc-global-euAyPy1,"}/*!sc*/ .kVWHyn{padding:0;}/*!sc*/ data-styled.g236[id="sc-33f1116f-0"]{content:"kVWHyn,"}/*!sc*/ .fIEjgQ{display:inline-block;background-color:var(--decorative-base,#000000);width:8px;height:8px;border-radius:50%;margin:auto 2px;}/*!sc*/ data-styled.g237[id="sc-4b98e795-0"]{content:"fIEjgQ,"}/*!sc*/ .inXpDH{border-radius:0;outline:transparent solid 3px;outline-offset:-3px;-webkit-transition:outline-color 200ms ease-in;transition:outline-color 200ms ease-in;color:var(--text-base,#000000);display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;-webkit-text-decoration:none;text-decoration:none;margin:0.25em 0;padding:0.25em 4px 0.25em;}/*!sc*/ .inXpDH:focus-visible{outline-color:var(--essential-base,#000000);}/*!sc*/ @supports not selector(:focus-visible){.inXpDH{outline:transparent solid 1.5px;outline-offset:-2px;}.inXpDH:focus{outline-color:var(--essential-base,#000000);}}/*!sc*/ .inXpDH:hover{color:var(--text-bright-accent,#107434);}/*!sc*/ @media screen and (max-width:991px){.inXpDH{padding:8px 24px;}}/*!sc*/ @media screen and (min-width:992px){.inXpDH[aria-current]{background-color:var(--background-tinted-base,rgba(0,0,0,0.08));color:var(--text-bright-accent,#107434);font-weight:700;}}/*!sc*/ data-styled.g238[id="sc-ca19fa36-0"]{content:"inXpDH,"}/*!sc*/ .eQIFgG{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;margin:0 8px 0 4px;}/*!sc*/ @media screen and (max-width:991px){.eQIFgG.eQIFgG{display:none;}}/*!sc*/ data-styled.g239[id="sc-ca19fa36-1"]{content:"eQIFgG,"}/*!sc*/ @media screen and (min-width:992px){.gDQowf{margin:0 0 0 20px;padding:0 0 0 12px;border-left:1px solid var(--decorative-subdued,#dedede);}.gDQowf a{color:var(--text-subdued,#656565);font-size:0.875rem;line-height:20px;}.gDQowf a > span{display:none;}.gDQowf a[aria-current]{border-left:3px solid var(--decorative-base,#000000);margin-left:-14px;padding-left:16px;}}/*!sc*/ data-styled.g240[id="sc-3b882ab6-0"]{content:"gDQowf,"}/*!sc*/ .jaqnEm{border-radius:16px;outline:transparent solid 3px;outline-offset:6px;-webkit-transition:outline-color 200ms ease-in;transition:outline-color 200ms ease-in;background:none;cursor:pointer;border:0;margin:4px 0;padding:4px 0;color:inherit;text-align:left;}/*!sc*/ .jaqnEm:focus-visible{outline-color:var(--essential-base,#000000);}/*!sc*/ @supports not selector(:focus-visible){.jaqnEm{outline:transparent solid 1.5px;outline-offset:4px;}.jaqnEm:focus{outline-color:var(--essential-base,#000000);}}/*!sc*/ .jaqnEm > *{vertical-align:middle;}/*!sc*/ .jaqnEm > span,.jaqnEm > a{margin-left:8px;}/*!sc*/ .jaqnEm > svg{-webkit-transform:rotate(0);-ms-transform:rotate(0);transform:rotate(0);}/*!sc*/ .jaqnEm[aria-expanded='true'] > svg{-webkit-transform:rotate(90deg);-ms-transform:rotate(90deg);transform:rotate(90deg);}/*!sc*/ data-styled.g241[id="sc-71f1783f-0"]{content:"jaqnEm,"}/*!sc*/ @media screen and (min-width:992px){.ifTmbP.ifTmbP{display:none;}}/*!sc*/ data-styled.g242[id="sc-5567915-0"]{content:"ifTmbP,"}/*!sc*/ .jPjXCP{padding-inline:4px;}/*!sc*/ @media screen and (max-width:991px){.jPjXCP.jPjXCP{display:none;}}/*!sc*/ data-styled.g243[id="sc-5567915-1"]{content:"jPjXCP,"}/*!sc*/ @media screen and (min-width:992px){.bCWGgN.bCWGgN{display:none;}}/*!sc*/ data-styled.g244[id="sc-5567915-2"]{content:"bCWGgN,"}/*!sc*/ .jjRUzu{margin-left:4px;vertical-align:middle;}/*!sc*/ @media screen and (max-width:991px){.jjRUzu.jjRUzu{display:none;}}/*!sc*/ data-styled.g245[id="sc-5567915-3"]{content:"jjRUzu,"}/*!sc*/ .hQAoDN{display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;gap:8px;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;}/*!sc*/ data-styled.g246[id="sc-8e747c9e-0"]{content:"hQAoDN,"}/*!sc*/ .esveKX{--top-offset:72px;--background-base:#FFFFFF !important;--background-highlight:#40007312 !important;--background-press:#FFFFFF !important;--background-elevated-base:#400073 !important;--background-elevated-highlight:#FFFFFF !important;--background-elevated-press:#FFFFFF !important;--background-tinted-base:#40007314 !important;--background-tinted-highlight:#DACFE6 !important;--background-tinted-press:#FFFFFF !important;--decorative-base:#400073 !important;--decorative-subdued:#bdb1cb !important;--essential-base:#000000 !important;--essential-subdued:#D7DBFF !important;--essential-bright-accent:#CDF56466 !important;--essential-negative:#000000 !important;--essential-warning:#000000 !important;--essential-positive:#000000 !important;--essential-announcement:#000000 !important;--text-base:#181818 !important;--text-subdued:#282828 !important;--text-bright-accent:#400073 !important;--text-negative:#000000 !important;--text-warning:#000000 !important;--text-positive:#8C20DF !important;--text-announcement:#000000 !important;background-color:var(--background-highlight,#f5f5f5);padding:20px 0 20px 20px;width:300px;height:calc(100vh - var(--top-offset));-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;position:-webkit-sticky;position:sticky;top:var(--top-offset);overflow-y:auto;}/*!sc*/ @supports (height:100dvh){.esveKX{height:calc(100dvh - var(--top-offset));}}/*!sc*/ @media screen and (max-width:991px){.esveKX.esveKX{display:none;}}/*!sc*/ data-styled.g247[id="sc-8e747c9e-1"]{content:"esveKX,"}/*!sc*/ .cyDyUk{margin-left:4px;padding-bottom:12px;}/*!sc*/ data-styled.g248[id="sc-8e747c9e-2"]{content:"cyDyUk,"}/*!sc*/ .kRdrPO{list-style:none;}/*!sc*/ @media screen and (max-width:991px){.kRdrPO.kRdrPO{display:none;}}/*!sc*/ data-styled.g249[id="sc-bad2eae7-0"]{content:"kRdrPO,"}/*!sc*/ .kRudhQ{padding-bottom:32px;}/*!sc*/ data-styled.g262[id="sc-9e80177b-0"]{content:"kRudhQ,"}/*!sc*/ .ifxrgl{padding:16px 0;}/*!sc*/ data-styled.g263[id="sc-9e80177b-1"]{content:"ifxrgl,"}/*!sc*/ .kEYUZZ{max-width:100%;max-height:100vh;}/*!sc*/ @media screen and (min-height:300px){.kEYUZZ{max-height:calc(100vh / 2);}}/*!sc*/ @media screen and (min-height:1000px){.kEYUZZ{max-height:calc(100vh / 3);}}/*!sc*/ data-styled.g265[id="sc-9e80177b-3"]{content:"kEYUZZ,"}/*!sc*/ .cnPCiV{padding:0 16px 16px;}/*!sc*/ @media screen and (min-width:992px){.cnPCiV{max-width:1800px;padding:0 32px 32px;}}/*!sc*/ data-styled.g270[id="sc-2b38a360-0"]{content:"cnPCiV,"}/*!sc*/ .kATMnr{padding-top:32px;padding-bottom:32px;}/*!sc*/ data-styled.g273[id="sc-823a4e88-2"]{content:"kATMnr,"}/*!sc*/ .dBEecC{--background-base:#FFFFFF !important;--background-highlight:#40007312 !important;--background-press:#FFFFFF !important;--background-elevated-base:#400073 !important;--background-elevated-highlight:#FFFFFF !important;--background-elevated-press:#FFFFFF !important;--background-tinted-base:#40007314 !important;--background-tinted-highlight:#DACFE6 !important;--background-tinted-press:#FFFFFF !important;--decorative-base:#400073 !important;--decorative-subdued:#bdb1cb !important;--essential-base:#000000 !important;--essential-subdued:#D7DBFF !important;--essential-bright-accent:#CDF56466 !important;--essential-negative:#000000 !important;--essential-warning:#000000 !important;--essential-positive:#000000 !important;--essential-announcement:#000000 !important;--text-base:#181818 !important;--text-subdued:#282828 !important;--text-bright-accent:#400073 !important;--text-negative:#000000 !important;--text-warning:#000000 !important;--text-positive:#8C20DF !important;--text-announcement:#000000 !important;}/*!sc*/ data-styled.g274[id="sc-823a4e88-3"]{content:"dBEecC,"}/*!sc*/ </style></head><body><div id="__next"><div class="sc-70f368a6-0 dYwJAo encore-creator-light-theme encore-layout-themes"><a class="Link-sc-1rnxmqt-0 eHnYHF encore-inverted-dark-set" href="#main" data-encore-id="skipLink"><div class="LinkText-sc-3xixkl-0 hohWVl">Skip to content</div></a><header class="sc-5dd3d1dd-0 eaUSlL"><div class="sc-5dd3d1dd-1 jFBprj"><a class="sc-539db49-0 fyfvvy" href="/"><svg aria-label="Spotify for Developers" xmlns="http://www.w3.org/2000/svg" width="240" height="34"><use href="/images/spotify-for-developers-logo.svg#s4d-logo"></use></svg></a></div><nav aria-label="primary" class="sc-61e0ff0f-0 sc-5dd3d1dd-2 hINOnu hZFTKR"><ul role="list" class="TypeList__TypeListElement-sc-1jhixr6-0 hWSKsH sc-e3bdb244-0 daFODJ" data-encore-id="typeList"><li class="sc-daaf2fce-0 fngAVZ"><button aria-expanded="false" data-active="true" class="sc-a671ab29-0 ggRfAl">Documentation<svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-a671ab29-1 iIHRIb" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><div hidden="" class="sc-9fff6009-0 dPqbzU sc-147783a9-0 ljywHx"><button aria-label="Go back to main navigation" class="sc-1a8d3606-0 dKipnq sc-a8ce54c5-0 jzFsff"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">Documentation</span></button><span class="Type__TypeElement-sc-goli3j-0 eyOwjh sc-45697e4e-0 yjgPF" data-encore-id="type">Products</span><ul role="list" class="TypeList__TypeListElement-sc-1jhixr6-0 hWSKsH sc-ca6f2bb9-0 kRyiQK" data-encore-id="typeList"><li><a class="sc-57f92064-0 fZekVo" href="/documentation/web-api"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":R18l9dm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":R18l9dm6H1:"><rect width="16" height="16" rx="3.2"></rect></clipPath></defs><g clip-path="url(#:R18l9dm6:)"><rect width="16" height="16" rx="3.2" fill="#6900BA"></rect></g><g clip-path="url(#:R18l9dm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#CDF564"></circle></g></svg>Web API</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-57f92064-1 bfMHgv" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li><li><a class="sc-57f92064-0 fZekVo" href="/documentation/web-playback-sdk"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":R1959dm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":R1959dm6H1:"><rect width="16" height="16" rx="3.2"></rect></clipPath></defs><g clip-path="url(#:R1959dm6:)"><rect width="16" height="16" rx="3.2" fill="#4100F5"></rect></g><g clip-path="url(#:R1959dm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#F573A0"></circle></g></svg>Web Playback SDK</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-57f92064-1 bfMHgv" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li><li><a class="sc-57f92064-0 fZekVo" href="/documentation/ads-api"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":R19l9dm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":R19l9dm6H1:"><rect width="16" height="16" rx="3.2"></rect></clipPath></defs><g clip-path="url(#:R19l9dm6:)"><rect width="16" height="16" rx="3.2" fill="#9691FF"></rect></g><g clip-path="url(#:R19l9dm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#9BF0E1"></circle></g></svg>Ads API</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-57f92064-1 bfMHgv" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li><li><a class="sc-57f92064-0 fZekVo" href="/documentation/ios"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":R1a59dm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":R1a59dm6H1:"><rect width="16" height="16" rx="3.2"></rect></clipPath></defs><g clip-path="url(#:R1a59dm6:)"><rect width="16" height="16" rx="3.2" fill="#509BF5"></rect></g><g clip-path="url(#:R1a59dm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#FAE62D"></circle></g></svg>iOS</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-57f92064-1 bfMHgv" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li><li><a class="sc-57f92064-0 fZekVo" href="/documentation/android"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":R1al9dm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":R1al9dm6H1:"><rect width="16" height="16" rx="3.2"></rect></clipPath></defs><g clip-path="url(#:R1al9dm6:)"><rect width="16" height="16" rx="3.2" fill="#FFCDD2"></rect></g><g clip-path="url(#:R1al9dm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#0A59B8"></circle></g></svg>Android</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-57f92064-1 bfMHgv" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li><li><a class="sc-57f92064-0 fZekVo" href="/documentation/embeds"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":R1b59dm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":R1b59dm6H1:"><rect width="16" height="16" rx="3.2"></rect></clipPath></defs><g clip-path="url(#:R1b59dm6:)"><rect width="16" height="16" rx="3.2" fill="#705378"></rect></g><g clip-path="url(#:R1b59dm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#FF6437"></circle></g></svg>Embeds</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-57f92064-1 bfMHgv" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li><li><a class="sc-57f92064-0 fZekVo" href="/documentation/commercial-hardware"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":R1bl9dm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":R1bl9dm6H1:"><rect width="16" height="16" rx="3.2"></rect></clipPath></defs><g clip-path="url(#:R1bl9dm6:)"><rect width="16" height="16" rx="3.2" fill="#27856A"></rect></g><g clip-path="url(#:R1bl9dm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#C8E0FC"></circle></g></svg>Commercial Hardware</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-57f92064-1 bfMHgv" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li><li><a class="sc-57f92064-0 fZekVo" href="/documentation/open-access"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":R1c59dm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":R1c59dm6H1:"><rect width="16" height="16" rx="3.2"></rect></clipPath></defs><g clip-path="url(#:R1c59dm6:)"><rect width="16" height="16" rx="3.2" fill="#213261"></rect></g><g clip-path="url(#:R1c59dm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#D8A3FF"></circle></g></svg>Open Access</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-57f92064-1 bfMHgv" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li></ul><span class="Type__TypeElement-sc-goli3j-0 eyOwjh sc-45697e4e-0 yjgPF" data-encore-id="type">Guidelines</span><ul role="list" class="TypeList__TypeListElement-sc-1jhixr6-0 hWSKsH sc-ca6f2bb9-0 kRyiQK" data-encore-id="typeList"><li><a class="sc-57f92064-0 fZekVo" href="/documentation/design"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":Rap9dm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":Rap9dm6H1:"><circle cx="8" cy="8" r="8"></circle></clipPath></defs><g clip-path="url(#:Rap9dm6:)"><circle cx="8" cy="8" r="8" fill="#503750"></circle></g><g clip-path="url(#:Rap9dm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#F573A0"></circle></g></svg>Design</span></a></li><li><a class="sc-57f92064-0 fZekVo" href="/documentation/accessibility"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":Rb99dm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":Rb99dm6H1:"><circle cx="8" cy="8" r="8"></circle></clipPath></defs><g clip-path="url(#:Rb99dm6:)"><circle cx="8" cy="8" r="8" fill="#1D006C"></circle></g><g clip-path="url(#:Rb99dm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#FFAF45"></circle></g></svg>Accessibility</span></a></li><li><a class="sc-57f92064-0 fZekVo" href="/terms"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":Rbp9dm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":Rbp9dm6H1:"><circle cx="8" cy="8" r="8"></circle></clipPath></defs><g clip-path="url(#:Rbp9dm6:)"><circle cx="8" cy="8" r="8" fill="#9C78FF"></circle></g><g clip-path="url(#:Rbp9dm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#FFC864"></circle></g></svg>Legal</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-57f92064-1 bfMHgv" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li></ul></div></li><li class="sc-daaf2fce-0 fngAVZ"><a class="sc-a671ab29-0 ggRfAl" href="/community">Community<svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-a671ab29-1 iIHRIb" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li></ul></nav><div class="sc-61e0ff0f-0 sc-5dd3d1dd-3 hINOnu gEpGzO"></div><div class="sc-960b9084-0 cgDIHL"><nav aria-label="primary"><button type="button" aria-expanded="false" class="Button-sc-1dqy6lx-0 hDhnlR e-9581-overflow-wrap-anywhere" aria-label="Open menu" data-encore-id="buttonTertiary"><span aria-hidden="true" class="IconWrapper__Wrapper-sc-16usrgb-0 jyHIqB"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentcolor" viewBox="0 0 24 24" class="sc-bbfbffd5-0 jYFMfm"><path d="M20.25 6H3.75c-1.5 0-1.5-2 0-2h16.5c1.5 0 1.5 2 0 2Z"></path><path d="M20.25 13H3.75c-1.5 0-1.5-2 0-2h16.5c1.5 0 1.5 2 0 2Z"></path><path d="M20.25 20H3.75c-1.5 0-1.5-2 0-2h16.5c1.5 0 1.5 2 0 2Z"></path></svg></span></button><div role="region" aria-label="0 alert(s) to review" class="sc-854fa934-0 sc-c6c8ec75-0 kMlpAI kUBZjS">0</div><div hidden="" class="sc-9fff6009-0 dPqbzU sc-147783a9-0 ljywHx"><ul role="list" class="TypeList__TypeListElement-sc-1jhixr6-0 hWSKsH sc-e3bdb244-0 daFODJ" data-encore-id="typeList"><li class="sc-daaf2fce-0 fngAVZ"><button aria-expanded="false" data-active="true" class="sc-a671ab29-0 ggRfAl">Documentation<svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-a671ab29-1 iIHRIb" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><div hidden="" class="sc-9fff6009-0 dPqbzU sc-147783a9-0 ljywHx"><button aria-label="Go back to main navigation" class="sc-1a8d3606-0 dKipnq sc-a8ce54c5-0 jzFsff"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">Documentation</span></button><span class="Type__TypeElement-sc-goli3j-0 eyOwjh sc-45697e4e-0 yjgPF" data-encore-id="type">Products</span><ul role="list" class="TypeList__TypeListElement-sc-1jhixr6-0 hWSKsH sc-ca6f2bb9-0 kRyiQK" data-encore-id="typeList"><li><a class="sc-57f92064-0 fZekVo" href="/documentation/web-api"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":Ra5aclm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":Ra5aclm6H1:"><rect width="16" height="16" rx="3.2"></rect></clipPath></defs><g clip-path="url(#:Ra5aclm6:)"><rect width="16" height="16" rx="3.2" fill="#6900BA"></rect></g><g clip-path="url(#:Ra5aclm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#CDF564"></circle></g></svg>Web API</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-57f92064-1 bfMHgv" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li><li><a class="sc-57f92064-0 fZekVo" href="/documentation/web-playback-sdk"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":Ra9aclm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":Ra9aclm6H1:"><rect width="16" height="16" rx="3.2"></rect></clipPath></defs><g clip-path="url(#:Ra9aclm6:)"><rect width="16" height="16" rx="3.2" fill="#4100F5"></rect></g><g clip-path="url(#:Ra9aclm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#F573A0"></circle></g></svg>Web Playback SDK</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-57f92064-1 bfMHgv" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li><li><a class="sc-57f92064-0 fZekVo" href="/documentation/ads-api"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":Radaclm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":Radaclm6H1:"><rect width="16" height="16" rx="3.2"></rect></clipPath></defs><g clip-path="url(#:Radaclm6:)"><rect width="16" height="16" rx="3.2" fill="#9691FF"></rect></g><g clip-path="url(#:Radaclm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#9BF0E1"></circle></g></svg>Ads API</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-57f92064-1 bfMHgv" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li><li><a class="sc-57f92064-0 fZekVo" href="/documentation/ios"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":Rahaclm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":Rahaclm6H1:"><rect width="16" height="16" rx="3.2"></rect></clipPath></defs><g clip-path="url(#:Rahaclm6:)"><rect width="16" height="16" rx="3.2" fill="#509BF5"></rect></g><g clip-path="url(#:Rahaclm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#FAE62D"></circle></g></svg>iOS</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-57f92064-1 bfMHgv" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li><li><a class="sc-57f92064-0 fZekVo" href="/documentation/android"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":Ralaclm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":Ralaclm6H1:"><rect width="16" height="16" rx="3.2"></rect></clipPath></defs><g clip-path="url(#:Ralaclm6:)"><rect width="16" height="16" rx="3.2" fill="#FFCDD2"></rect></g><g clip-path="url(#:Ralaclm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#0A59B8"></circle></g></svg>Android</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-57f92064-1 bfMHgv" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li><li><a class="sc-57f92064-0 fZekVo" href="/documentation/embeds"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":Rapaclm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":Rapaclm6H1:"><rect width="16" height="16" rx="3.2"></rect></clipPath></defs><g clip-path="url(#:Rapaclm6:)"><rect width="16" height="16" rx="3.2" fill="#705378"></rect></g><g clip-path="url(#:Rapaclm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#FF6437"></circle></g></svg>Embeds</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-57f92064-1 bfMHgv" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li><li><a class="sc-57f92064-0 fZekVo" href="/documentation/commercial-hardware"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":Rataclm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":Rataclm6H1:"><rect width="16" height="16" rx="3.2"></rect></clipPath></defs><g clip-path="url(#:Rataclm6:)"><rect width="16" height="16" rx="3.2" fill="#27856A"></rect></g><g clip-path="url(#:Rataclm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#C8E0FC"></circle></g></svg>Commercial Hardware</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-57f92064-1 bfMHgv" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li><li><a class="sc-57f92064-0 fZekVo" href="/documentation/open-access"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":Rb1aclm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":Rb1aclm6H1:"><rect width="16" height="16" rx="3.2"></rect></clipPath></defs><g clip-path="url(#:Rb1aclm6:)"><rect width="16" height="16" rx="3.2" fill="#213261"></rect></g><g clip-path="url(#:Rb1aclm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#D8A3FF"></circle></g></svg>Open Access</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-57f92064-1 bfMHgv" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li></ul><span class="Type__TypeElement-sc-goli3j-0 eyOwjh sc-45697e4e-0 yjgPF" data-encore-id="type">Guidelines</span><ul role="list" class="TypeList__TypeListElement-sc-1jhixr6-0 hWSKsH sc-ca6f2bb9-0 kRyiQK" data-encore-id="typeList"><li><a class="sc-57f92064-0 fZekVo" href="/documentation/design"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":R2maclm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":R2maclm6H1:"><circle cx="8" cy="8" r="8"></circle></clipPath></defs><g clip-path="url(#:R2maclm6:)"><circle cx="8" cy="8" r="8" fill="#503750"></circle></g><g clip-path="url(#:R2maclm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#F573A0"></circle></g></svg>Design</span></a></li><li><a class="sc-57f92064-0 fZekVo" href="/documentation/accessibility"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":R2qaclm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":R2qaclm6H1:"><circle cx="8" cy="8" r="8"></circle></clipPath></defs><g clip-path="url(#:R2qaclm6:)"><circle cx="8" cy="8" r="8" fill="#1D006C"></circle></g><g clip-path="url(#:R2qaclm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#FFAF45"></circle></g></svg>Accessibility</span></a></li><li><a class="sc-57f92064-0 fZekVo" href="/terms"><span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":R2uaclm6:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":R2uaclm6H1:"><circle cx="8" cy="8" r="8"></circle></clipPath></defs><g clip-path="url(#:R2uaclm6:)"><circle cx="8" cy="8" r="8" fill="#9C78FF"></circle></g><g clip-path="url(#:R2uaclm6H1:)"><circle cx="0" cy="16" r="9.6" fill="#FFC864"></circle></g></svg>Legal</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-57f92064-1 bfMHgv" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li></ul></div></li><li class="sc-daaf2fce-0 fngAVZ"><a class="sc-a671ab29-0 ggRfAl" href="/community">Community<svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror sc-a671ab29-1 iIHRIb" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></a></li></ul></div></nav></div></header><div class="sc-7ead898e-0 AXGli"><nav aria-labelledby="side-nav-header" class="sc-8e747c9e-1 esveKX"><div class="sc-8e747c9e-2 cyDyUk"><p id="side-nav-header" data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 jFxTq"><span class="sc-8e747c9e-0 hQAoDN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":Rlaq66:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":Rlaq66H1:"><rect width="16" height="16" rx="3.2"></rect></clipPath></defs><g clip-path="url(#:Rlaq66:)"><rect width="16" height="16" rx="3.2" fill="#9691FF"></rect></g><g clip-path="url(#:Rlaq66H1:)"><circle cx="0" cy="16" r="9.6" fill="#9BF0E1"></circle></g></svg>Ads API</span></p></div><div><ul role="list" class="TypeList__TypeListElement-sc-1jhixr6-0 hWSKsH sc-33f1116f-0 kVWHyn" data-encore-id="typeList"><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Introduction</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="Introduction menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg></button><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-5567915-3 jjRUzu" data-encore-id="textLink" href="/documentation/ads-api"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Introduction</span></a><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">Introduction</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#about"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>About</a></li><li class="sc-bad2eae7-0 kRdrPO"><ul class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#next-steps"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Next Steps</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#support"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Support</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#subscribe-to-newsletter"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Subscribe to Newsletter</a></li></ul></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#api-design"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>API Design</a></li><li class="sc-bad2eae7-0 kRdrPO"><ul class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#rate-limiting"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Rate Limiting</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#breaking-v-non-breaking-changes-policy"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Breaking v. Non-Breaking Changes Policy</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#versioning"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Versioning</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#time-format"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Time format</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#pagination"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Pagination</a></li></ul></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#release-notes"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Release Notes</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Quickstart</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="Quickstart menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg></button><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-5567915-3 jjRUzu" data-encore-id="textLink" href="/documentation/ads-api/quick-start"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Quickstart</span></a><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">Quickstart</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/quick-start#account-prerequisites"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Account Prerequisites</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/quick-start#initialize-your-new-ads-api-application"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Initialize your new Ads API application</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/quick-start#authenticate-your-ad-studio-account"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Authenticate your Ad Studio account</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/quick-start#using-the-refresh-token"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Using the refresh token</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Guides</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="true" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="Guides menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg></button><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-5567915-3 jjRUzu" data-encore-id="textLink" href="/documentation/ads-api/guides"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Guides</span></a><ul class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">Guides</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#object-hierarchy"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Object hierarchy</a></li><li class="sc-bad2eae7-0 kRdrPO"><ul class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#ad-accounts"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Ad Accounts</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#advertisers"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Advertisers</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#campaigns"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Campaigns</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#ad-sets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Ad Sets</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#ads"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Ads</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#assets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Assets</a></li></ul></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#campaign-management"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Campaign Management</a></li><li class="sc-bad2eae7-0 kRdrPO"><ul class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#overview"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Overview</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#eligibility-criteria"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Eligibility Criteria</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#differences-from-the-ui"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Differences from the UI</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#build-a-campaign"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Build a Campaign</a></li></ul></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#reporting"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Reporting</a></li><li class="sc-bad2eae7-0 kRdrPO"><ul class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#overview-1"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Overview</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#eligibility-criteria-1"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Eligibility Criteria</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#differences-from-the-ui-reporting"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Differences from the UI (Reporting)</a></li></ul></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#metrics-glossary"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Metrics Glossary</a></li><li class="sc-bad2eae7-0 kRdrPO"><ul class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#campaign-performance-metrics"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Campaign Performance Metrics</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#streaming-conversion-metrics"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Streaming Conversion Metrics</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#pixel-metrics"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Pixel Metrics</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#app-conversion-metrics"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>App Conversion Metrics</a></li></ul></li></ul></li></ul><span class="Type__TypeElement-sc-goli3j-0 eyOwjh sc-45697e4e-0 yjgPF" data-encore-id="type">Reference</span><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/info"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>General info</a></li><ul role="list" class="TypeList__TypeListElement-sc-1jhixr6-0 hWSKsH sc-33f1116f-0 kVWHyn" data-encore-id="typeList"><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">ad-accounts</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="ad-accounts menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">ad-accounts</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">ad-accounts</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAdAccount"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Ad Account by ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/updateAdAccount"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Update Ad Account</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAdAccountsInBusiness"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Ad Accounts for Current User by Business ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/createAdAccountForBusiness"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Create Ad Account</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">ad-categories</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="ad-categories menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">ad-categories</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">ad-categories</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAdCategories"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Ad Categories</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">ad-sets</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="ad-sets menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">ad-sets</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">ad-sets</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAdSetById"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Ad Set by ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/updateAdSet"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Update Ad Set</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAdSetsByAdAccountId"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Ad Sets by Ad Account ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/createAdSet"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Create an Ad Set</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">ads</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="ads menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">ads</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">ads</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAds"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Ads by Ad Account ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/createAd"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Create an Ad</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAd"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Ad by ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/updateAd"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Update an Ad</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">assets</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="assets menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">assets</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">assets</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAssetsByAdAccount"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Assets by Ad Account</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/createAsset"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Create Asset</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAsset"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Asset by ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/updateAsset"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Update Asset</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/uploadAsset"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Upload Asset</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/startUploadChunkedAsset"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Start Upload Chunked Asset</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/transferChunkedAsset"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Transfer Chunked Asset</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/completeUploadChunkedAsset"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Complete Upload Chunked Asset</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">businesses</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="businesses menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">businesses</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">businesses</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getBusinesses"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Businesses for Current User</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/createBusiness"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Create Business</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getBusiness"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Business by ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/updateBusiness"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Update Business</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">campaigns</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="campaigns menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">campaigns</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">campaigns</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getCampaigns"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Campaigns by Ad Account ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/createCampaign"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Create a Campaign</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getCampaign"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Campaign by ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/updateCampaign"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Update a Campaign</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">estimates</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="estimates menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">estimates</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">estimates</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/estimateAudience"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Estimate audience</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/estimateBid"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Estimate bid</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">podcast-shows</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="podcast-shows menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">podcast-shows</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">podcast-shows</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getPodcastShows"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Podcast Shows</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">reports</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="reports menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">reports</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">reports</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAggregateReport"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Aggregate Report by Ad Account ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAudienceInsightReport"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Insight Report by Ad Account ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/createAsyncReport"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Create a CSV Report Asynchronously</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAsyncReport"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get CSV Report Status by ID</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">targets</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="targets menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">targets</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">targets</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getArtistTargets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Artist Targets</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getGenreTargets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Genre Targets</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getGeoTargets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Geo Targets</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getInterestTargets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Interest Targets</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getLanguageTargets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Language Targets</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getPlaylistTargets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Playlist Targets</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getEpisodeTopicTargets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Podcast Episode Topic Targets</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getSensitiveTopicTargets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Sensitive Topic Targets</a></li></ul></li></ul></div></nav><div class="sc-960b9084-0 cgDIHL"><div hidden="" class="sc-9fff6009-0 dPqbzU"><button aria-label="Go back to Documentation" class="sc-1a8d3606-0 dKipnq"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)"><defs><clipPath id=":R9iq66:"><path d="M 0 0 L 16 0 L 16 16 L 8 16 L 0 8 Z"></path></clipPath><clipPath id=":R9iq66H1:"><rect width="16" height="16" rx="3.2"></rect></clipPath></defs><g clip-path="url(#:R9iq66:)"><rect width="16" height="16" rx="3.2" fill="#9691FF"></rect></g><g clip-path="url(#:R9iq66H1:)"><circle cx="0" cy="16" r="9.6" fill="#9BF0E1"></circle></g></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">Ads API</span></button><div><ul role="list" class="TypeList__TypeListElement-sc-1jhixr6-0 hWSKsH sc-33f1116f-0 kVWHyn" data-encore-id="typeList"><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Introduction</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="Introduction menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg></button><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-5567915-3 jjRUzu" data-encore-id="textLink" href="/documentation/ads-api"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Introduction</span></a><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">Introduction</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#about"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>About</a></li><li class="sc-bad2eae7-0 kRdrPO"><ul class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#next-steps"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Next Steps</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#support"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Support</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#subscribe-to-newsletter"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Subscribe to Newsletter</a></li></ul></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#api-design"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>API Design</a></li><li class="sc-bad2eae7-0 kRdrPO"><ul class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#rate-limiting"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Rate Limiting</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#breaking-v-non-breaking-changes-policy"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Breaking v. Non-Breaking Changes Policy</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#versioning"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Versioning</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#time-format"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Time format</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#pagination"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Pagination</a></li></ul></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api#release-notes"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Release Notes</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Quickstart</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="Quickstart menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg></button><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-5567915-3 jjRUzu" data-encore-id="textLink" href="/documentation/ads-api/quick-start"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Quickstart</span></a><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">Quickstart</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/quick-start#account-prerequisites"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Account Prerequisites</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/quick-start#initialize-your-new-ads-api-application"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Initialize your new Ads API application</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/quick-start#authenticate-your-ad-studio-account"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Authenticate your Ad Studio account</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/quick-start#using-the-refresh-token"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Using the refresh token</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Guides</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="true" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="Guides menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg></button><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-5567915-3 jjRUzu" data-encore-id="textLink" href="/documentation/ads-api/guides"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Guides</span></a><ul class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">Guides</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#object-hierarchy"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Object hierarchy</a></li><li class="sc-bad2eae7-0 kRdrPO"><ul class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#ad-accounts"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Ad Accounts</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#advertisers"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Advertisers</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#campaigns"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Campaigns</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#ad-sets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Ad Sets</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#ads"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Ads</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#assets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Assets</a></li></ul></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#campaign-management"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Campaign Management</a></li><li class="sc-bad2eae7-0 kRdrPO"><ul class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#overview"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Overview</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#eligibility-criteria"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Eligibility Criteria</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#differences-from-the-ui"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Differences from the UI</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#build-a-campaign"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Build a Campaign</a></li></ul></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#reporting"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Reporting</a></li><li class="sc-bad2eae7-0 kRdrPO"><ul class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#overview-1"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Overview</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#eligibility-criteria-1"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Eligibility Criteria</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#differences-from-the-ui-reporting"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Differences from the UI (Reporting)</a></li></ul></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#metrics-glossary"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Metrics Glossary</a></li><li class="sc-bad2eae7-0 kRdrPO"><ul class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#campaign-performance-metrics"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Campaign Performance Metrics</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#streaming-conversion-metrics"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Streaming Conversion Metrics</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#pixel-metrics"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Pixel Metrics</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/guides#app-conversion-metrics"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>App Conversion Metrics</a></li></ul></li></ul></li></ul><span class="Type__TypeElement-sc-goli3j-0 eyOwjh sc-45697e4e-0 yjgPF" data-encore-id="type">Reference</span><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/info"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>General info</a></li><ul role="list" class="TypeList__TypeListElement-sc-1jhixr6-0 hWSKsH sc-33f1116f-0 kVWHyn" data-encore-id="typeList"><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">ad-accounts</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="ad-accounts menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">ad-accounts</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">ad-accounts</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAdAccount"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Ad Account by ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/updateAdAccount"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Update Ad Account</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAdAccountsInBusiness"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Ad Accounts for Current User by Business ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/createAdAccountForBusiness"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Create Ad Account</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">ad-categories</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="ad-categories menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">ad-categories</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">ad-categories</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAdCategories"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Ad Categories</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">ad-sets</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="ad-sets menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">ad-sets</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">ad-sets</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAdSetById"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Ad Set by ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/updateAdSet"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Update Ad Set</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAdSetsByAdAccountId"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Ad Sets by Ad Account ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/createAdSet"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Create an Ad Set</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">ads</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="ads menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">ads</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">ads</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAds"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Ads by Ad Account ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/createAd"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Create an Ad</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAd"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Ad by ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/updateAd"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Update an Ad</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">assets</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="assets menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">assets</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">assets</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAssetsByAdAccount"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Assets by Ad Account</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/createAsset"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Create Asset</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAsset"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Asset by ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/updateAsset"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Update Asset</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/uploadAsset"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Upload Asset</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/startUploadChunkedAsset"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Start Upload Chunked Asset</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/transferChunkedAsset"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Transfer Chunked Asset</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/completeUploadChunkedAsset"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Complete Upload Chunked Asset</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">businesses</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="businesses menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">businesses</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">businesses</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getBusinesses"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Businesses for Current User</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/createBusiness"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Create Business</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getBusiness"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Business by ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/updateBusiness"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Update Business</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">campaigns</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="campaigns menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">campaigns</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">campaigns</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getCampaigns"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Campaigns by Ad Account ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/createCampaign"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Create a Campaign</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getCampaign"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Campaign by ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/updateCampaign"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Update a Campaign</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">estimates</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="estimates menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">estimates</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">estimates</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/estimateAudience"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Estimate audience</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/estimateBid"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Estimate bid</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">podcast-shows</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="podcast-shows menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">podcast-shows</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">podcast-shows</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getPodcastShows"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Podcast Shows</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">reports</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="reports menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">reports</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">reports</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAggregateReport"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Aggregate Report by Ad Account ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAudienceInsightReport"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Insight Report by Ad Account ID</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/createAsyncReport"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Create a CSV Report Asynchronously</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getAsyncReport"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get CSV Report Status by ID</a></li></ul></li><li><button class="sc-226e2e15-0 cKvXqF sc-5567915-0 ifTmbP"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">targets</span><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M4.97.47a.75.75 0 0 0 0 1.06L11.44 8l-6.47 6.47a.75.75 0 1 0 1.06 1.06L13.56 8 6.03.47a.75.75 0 0 0-1.06 0z'/></svg></button><button aria-expanded="false" class="sc-71f1783f-0 jaqnEm sc-5567915-1 jPjXCP" aria-label="targets menu"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon" style="--encore-icon-fill:var(--decorative-base, #000000);--encore-icon-height:var(--encore-graphic-size-decorative-smaller-2);--encore-icon-width:var(--encore-graphic-size-decorative-smaller-2)" viewBox="0 0 16 16"><path d='M3 1.713a.7.7 0 0 1 1.05-.607l10.89 6.288a.7.7 0 0 1 0 1.212L4.05 14.894A.7.7 0 0 1 3 14.288V1.713z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">targets</span></button><ul hidden="" class="sc-9fff6009-0 dPqbzU sc-3b882ab6-0 gDQowf"><button aria-label="Go back to " class="sc-1a8d3606-0 dKipnq sc-5567915-2 bCWGgN"><svg data-encore-id="icon" role="img" aria-hidden="true" class="e-9581-icon e-9581-icon--auto-mirror" style="--encore-icon-height:var(--encore-graphic-size-decorative-smaller);--encore-icon-width:var(--encore-graphic-size-decorative-smaller)" viewBox="0 0 16 16"><path d='M11.03.47a.75.75 0 0 1 0 1.06L4.56 8l6.47 6.47a.75.75 0 1 1-1.06 1.06L2.44 8 9.97.47a.75.75 0 0 1 1.06 0z'/></svg><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 huwcwr">targets</span></button><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getArtistTargets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Artist Targets</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getGenreTargets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Genre Targets</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getGeoTargets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Geo Targets</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getInterestTargets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Interest Targets</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getLanguageTargets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Language Targets</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getPlaylistTargets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Playlist Targets</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getEpisodeTopicTargets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Podcast Episode Topic Targets</a></li><li class="e-9581-list-item e-9581-baseline" data-encore-id="listItem"><a class="sc-ca19fa36-0 inXpDH" href="/documentation/ads-api/reference/v3.0/getSensitiveTopicTargets"><span class="sc-4b98e795-0 sc-ca19fa36-1 fIEjgQ eQIFgG"></span>Get Sensitive Topic Targets</a></li></ul></li></ul></div></div></div><main id="main" class="sc-ae97880a-0 ifAlMH"><div class="sc-7eae9c62-0 fdpdGa"><div class="sc-2b38a360-0 sc-823a4e88-3 cnPCiV dBEecC"><h1 class="Type__TypeElement-sc-goli3j-0 cMheqG sc-823a4e88-2 kATMnr" data-encore-id="type">Ads API Guides  </h1><style>[data-ch-theme="s4d"] { --ch-t-colorScheme: dark;--ch-t-foreground: #ffffff;--ch-t-background: #1E073C;--ch-t-lighter-inlineBackground: #1e073ce6;--ch-t-editor-background: #1E073C;--ch-t-editor-foreground: #F8F8F2;--ch-t-editor-lineHighlightBackground: #3E3D32;--ch-t-editor-rangeHighlightBackground: #ffffff0b;--ch-t-editor-infoForeground: #3794FF;--ch-t-editor-selectionBackground: #49483E;--ch-t-focusBorder: #007FD4;--ch-t-tab-activeBackground: #1E073C;--ch-t-tab-activeForeground: #ffffff;--ch-t-tab-inactiveBackground: #2D2D2D;--ch-t-tab-inactiveForeground: #ffffff80;--ch-t-tab-border: #252526;--ch-t-tab-activeBorder: #1E073C;--ch-t-editorGroup-border: #444444;--ch-t-editorGroupHeader-tabsBackground: #252526;--ch-t-editorLineNumber-foreground: #858585;--ch-t-input-background: #3C3C3C;--ch-t-input-foreground: #F8F8F2;--ch-t-icon-foreground: #C5C5C5;--ch-t-sideBar-background: #252526;--ch-t-sideBar-foreground: #F8F8F2;--ch-t-sideBar-border: #252526;--ch-t-list-activeSelectionBackground: #094771;--ch-t-list-activeSelectionForeground: #fffffe;--ch-t-list-hoverBackground: #2A2D2E; }</style> <div class="sc-9e80177b-1 ifxrgl"><h2 class="e-9581-text encore-text-title-medium" data-encore-id="text" id="object-hierarchy">Object Hierarchy</h2></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">Your <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="https://ads.spotify.com/en-US/how-it-works/">Ads Manager</a> account comprises sets of related objects organized in a hierarchy. The Ads API gives you direct, programmatic access to these objects. From top to bottom, the objects that build the structure of your account include:</p> <ul role="list" data-encore-id="typeList" class="TypeList__TypeListElement-sc-1jhixr6-0 hrsDVQ"> <li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem">Businesses</li> <li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem">Ad Accounts</li> <li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem">Campaigns</li> <li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem">Ad Sets</li> <li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem">Ads</li> <li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem">Assets</li> </ul> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl"><img src="/images/products/ads-api/ads-manager-account-structure.png" alt=""Ads Manager Platform Structure"" class="Image-sc-1u215sg-3 hQQTps sc-9e80177b-3 kEYUZZ" data-encore-id="image"/></p> <div class="sc-9e80177b-1 ifxrgl"><h3 class="e-9581-text encore-text-title-small" data-encore-id="text" id="businesses">Businesses</h3></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">When you create an account in Spotify Ads Manager, a business account and an associated ad account will automatically be created for you. A business is an object used to centrally manage multiple ad accounts.</p> <div class="sc-9e80177b-1 ifxrgl"><h3 class="e-9581-text encore-text-title-small" data-encore-id="text" id="ad-accounts">Ad Accounts</h3></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">You must have an ad account before you can create advertisers, campaigns, ad sets, or ads. Use the <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/getAllAdAccountsInBusiness">Get Ad Account by ID</a> endpoint to view information about your account after it has been set up.</p> <div class="sc-9e80177b-1 ifxrgl"><h3 class="e-9581-text encore-text-title-small" data-encore-id="text" id="campaigns">Campaigns</h3></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">A campaign is an object that contains and organizes one or more ad sets. Also, you need a campaign <em>before</em> you can create an ad set. Use the <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/createCampaign">Create Campaign</a> endpoint to create a campaign under your ad account.</p> <div class="sc-9e80177b-1 ifxrgl"><h3 class="e-9581-text encore-text-title-small" data-encore-id="text" id="ad-sets">Ad Sets</h3></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">An ad set is the core component of your Ads Manager campaign. It is a child of a campaign object and contains all the essential information Ads Manager needs to execute your campaign. For example, an ad set contains:</p> <ul role="list" data-encore-id="typeList" class="TypeList__TypeListElement-sc-1jhixr6-0 hrsDVQ"> <li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem">Information about how, when, and where your campaign runs (e.g., start and end dates, bids, budgets, targeting, etc).</li> <li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem">One or more ads.</li> </ul> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">See the <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/createAdSet">Create Ad Set</a> endpoint for more information or to add an ad set to a campaign.</p> <div class="sc-9e80177b-1 ifxrgl"><h3 class="e-9581-text encore-text-title-small" data-encore-id="text" id="ads">Ads</h3></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">An ad is an object that contains an image asset along with either an audio or video asset. Each ad must be linked to an ad set but a given ad cannot be linked to multiple ad sets. See the eponymous <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/createAd">Create Ad</a> endpoint to get started.</p> <div class="sc-9e80177b-1 ifxrgl"><h3 class="e-9581-text encore-text-title-small" data-encore-id="text" id="assets">Assets</h3></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">The Ads Manager platform supports audio, video, and image assets. These assets are required to create an ad. The asset endpoints help you upload and manage these items. Use the following endpoints to first create and then upload an asset:</p> <ul role="list" data-encore-id="typeList" class="TypeList__TypeListElement-sc-1jhixr6-0 hrsDVQ"> <li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/createAsset">Create Asset</a></li> <li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/uploadAsset">Upload Asset</a></li> </ul> <div class="sc-9e80177b-1 ifxrgl"><h2 class="e-9581-text encore-text-title-medium" data-encore-id="text" id="campaign-management">Campaign Management</h2></div> <div class="sc-9e80177b-1 ifxrgl"><h3 class="e-9581-text encore-text-title-small" data-encore-id="text" id="overview">Overview</h3></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">The Campaign Management API allows you to create and manage campaigns, ad sets, and ads at scale. It also includes endpoints to estimate audience size and bid amount based on your targeting specifications (set at the ad set level).</p> <div class="sc-9e80177b-1 ifxrgl"><h3 class="e-9581-text encore-text-title-small" data-encore-id="text" id="eligibility-criteria">Eligibility Criteria</h3></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">As of August 2023, the Campaign Management API is generally available ("GA") and no longer requires a manual allowlisting process to gain access. As soon as you have <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/documentation/ads-api/quick-start#initialize-your-new-ads-api-application">set up your application</a>, your client ID will be able to access these endpoints automatically.</p> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">Please note that the Campaign Management API is only available for advertisers with a Spotify <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="https://adsmanager.spotify.com/">Ads Manager</a> account.</p> <div class="sc-9e80177b-1 ifxrgl"><h3 class="e-9581-text encore-text-title-small" data-encore-id="text" id="differences-from-the-ui">Differences from the UI</h3></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">Most features available in the Ads Manager UI are also available via the Ads API, with a few exceptions:</p> <div class="sc-9e80177b-0 kRudhQ"><table class="e-9581-table" data-encore-id="table"><thead><tr class="e-9581-table-row" data-encore-id="tableRow"><th scope="col" class="encore-text-body-small-bold e-9581-baseline e-9581-table-header-cell e-9581-table-header-cell--start" data-encore-id="tableHeaderCell">Feature</th><th scope="col" class="encore-text-body-small-bold e-9581-baseline e-9581-table-header-cell e-9581-table-header-cell--start" data-encore-id="tableHeaderCell">Supported in Spotify Ads Manager UI</th><th scope="col" class="encore-text-body-small-bold e-9581-baseline e-9581-table-header-cell e-9581-table-header-cell--start" data-encore-id="tableHeaderCell">Supported in Spotify Ads API</th></tr></thead><tbody><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Create new ad account</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">yes</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">yes - as of v3</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Manage users</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">yes</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">no</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Manage billing/payment</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">yes</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">no</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Voiceover generation</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">yes</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">no</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM"><a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="https://ads.spotify.com/en-US/help-center/targeting-ad-studio/#real_time_context_targeting">Real-time context targeting</a></span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">yes</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">yes - Referred to as <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/getPlaylistTargets">playlist</a> targeting</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM"><a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="https://ads.spotify.com/en-US/help-center/targeting-ad-studio/#fan_targeting">Fan targeting</a></span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">yes</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">yes - Referred to as <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/getArtistTargets">artist</a> targeting</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">MOAT viewability tracking set up</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">yes</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">no - Only IAS is available</span></td></tr></tbody></table></div> <div class="sc-9e80177b-1 ifxrgl"><h3 class="e-9581-text encore-text-title-small" data-encore-id="text" id="build-a-campaign">Build a campaign</h3></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">Follow these steps to build your first end-to-end campaign with the Ads API. NOTE: The below sample curl requests do not reflect every request parameter available.</p> <div class="sc-9e80177b-1 ifxrgl"><h4 class="e-9581-text encore-text-body-medium-bold" data-encore-id="text" id="step-1-retrieve-your-business--ad-account-id">Step 1: Retrieve your business & ad account ID</h4></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">If you're unsure of your business ID, you can call the <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/getBusinesses">Get Businesses for Current User</a> endpoint to return a list of all businesses available to the current authenticated user.</p> <div class="ch-codeblock not-prose " data-ch-theme="s4d"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br/><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span>curl --request GET \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> --url https://api-partner.spotify.com/ads/v3/businesses \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> --header 'Authorization: Bearer <ACCESS_TOKEN>'</span></div></div><br/></code></div></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">You can then use the business ID to retrieve a list of all ad accounts under the business that the current authenticated user has access to via the <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/getAllAdAccountsInBusiness">Get Ad Accounts for Current User by Business ID</a> endpoint.</p> <div class="ch-codeblock not-prose " data-ch-theme="s4d"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br/><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span>curl --request GET \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> --url https://api-partner.spotify.com/ads/v3/businesses/<BUSINESS_ID>/ad_accounts \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> --header 'Authorization: Bearer <ACCESS_TOKEN>'</span></div></div><br/></code></div></div> <div class="sc-9e80177b-1 ifxrgl"><h4 class="e-9581-text encore-text-body-medium-bold" data-encore-id="text" id="step-2-create-a-campaign">Step 2: <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/createCampaign">Create a campaign</a></h4></div> <div class="ch-codeblock not-prose " data-ch-theme="s4d"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br/><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span>curl --request POST \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> --url https://api-partner.spotify.com/ads/v3/ad_accounts/<AD_ACCOUNT_ID>/campaigns \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> --header 'Authorization: Bearer <ACCESS_TOKEN>' \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> --header 'Content-Type: application/json' \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> --data '{</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> "name": "My Test Campaign",</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> "objective": "EVEN_IMPRESSION_DELIVERY"</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span>}'</span></div></div><br/></code></div></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">Upon success, the API will return an ID for the newly created campaign. Store this ID for use in Step 5 (Create an ad set).</p> <div class="sc-9e80177b-1 ifxrgl"><h4 class="e-9581-text encore-text-body-medium-bold" data-encore-id="text" id="step-3-define-targeting-specifications">Step 3: Define targeting specifications</h4></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">Use the /targets endpoints to understand/retrieve the available targeting options -- supported categories include:</p> <ul role="list" data-encore-id="typeList" class="TypeList__TypeListElement-sc-1jhixr6-0 hrsDVQ"> <li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/getArtistTargets">artist</a></li> <li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/getGenreTargets">genre</a></li> <li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/getPlaylistTargets">playlist</a></li> <li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/getInterestTargets">interest</a></li> <li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/getLanguageTargets">language</a></li> <li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/getGeoTargets">geographic location</a> (country, region, DMA, city, and postal code)</li> <li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/getEpisodeTopicTargets">podcast episode topics</a></li> <li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/getSensitiveTopicTargets">sensitive topic targets</a></li> </ul> <div class="sc-9e80177b-1 ifxrgl"><h4 class="e-9581-text encore-text-body-medium-bold" data-encore-id="text" id="step-4-optional-estimate-audience-size-and-recommended-bid-amount">Step 4: [Optional] Estimate audience size and recommended bid amount</h4></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">In order to help plan your campaign, we recommend using the /estimates endpoints to help forecast estimated audience size and recommended bid amount based on your targeting specifications (NOTE: Estimates are NOT a guarantee of performance).</p> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl"><a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/estimateBid">Retrieve a recommended bid range</a>:</p> <div class="ch-codeblock not-prose " data-ch-theme="s4d"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br/><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span>curl --request POST \</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> --url https://api-partner.spotify.com/ads/v3/estimates/bid \</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> --header 'Authorization: Bearer <ACCESS_TOKEN>' \</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> --header 'Content-Type: application/json' \</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> --data '{</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "start_date": "2025-09-23T04:00:00Z",</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "end_date": "2025-10-23T04:00:00Z",</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "bid_strategy": "MAX_BID",</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "asset_format": "AUDIO",</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "currency": "USD",</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "targets": {</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "age_ranges": [</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> {</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "min": 18,</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "max": 65</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> }</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "playlist_ids": [</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "holidays",</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "cooking"</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "genders": [</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "MALE"</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "geo_targets": {</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "dma_ids": [</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "501"</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "region_ids": [</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "5279468"</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "city_ids": [</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "4174700"</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> ]</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> },</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "genre_ids": [</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "rock",</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "blues"</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "platforms": [</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "IOS"</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "placements": [</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "PODCAST",</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "MUSIC"</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> ]</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> },</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span> "objective": "EVEN_IMPRESSION_DELIVERY"</span></div></div><div><span class="ch-code-line-number">_49</span><div style="display:inline-block;margin-left:16px"><span>}'</span></div></div><br/></code></div></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl"><a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/estimateAudience">Retrieve an audience estimate</a>:</p> <div class="ch-codeblock not-prose " data-ch-theme="s4d"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br/><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span>curl --request POST \</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> --url https://api-partner.spotify.com/ads/v3/estimates/audience \</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> --header 'Authorization: Bearer <ACCESS_TOKEN>' \</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> --header 'Content-Type: application/json' \</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> --data '{</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "ad_account_id": "<AD_ACCOUNT_ID>",</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "start_date": "2025-09-23T04:00:00Z",</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "end_date": "2025-10-23T04:00:00Z",</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "bid_strategy": "MAX_BID",</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "asset_format": "AUDIO",</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "targets": {</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "age_ranges": [</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> {</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "min": 18,</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "max": 65</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> }</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "playlist_ids": [</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "holidays",</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "cooking"</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "platforms": [</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "IOS"</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "genders": [</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "MALE"</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "language": "en",</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "geo_targets": {</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "country_code": "US",</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "dma_ids": [</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "501"</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "region_ids": [</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "5279468"</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "city_ids": [</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "4174700"</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> ]</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> },</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "genre_ids": [</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "rock",</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "blues"</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "placements": [</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "PODCAST",</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "MUSIC"</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> ]</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> }</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> },</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "objective": "EVEN_IMPRESSION_DELIVERY",</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "budget": {</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "micro_amount": 25000000,</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "type": "DAILY",</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> "currency": "USD"</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span> }</span></div></div><div><span class="ch-code-line-number">_57</span><div style="display:inline-block;margin-left:16px"><span>}'</span></div></div><br/></code></div></div> <div class="sc-9e80177b-1 ifxrgl"><h4 class="e-9581-text encore-text-body-medium-bold" data-encore-id="text" id="step-5-create-an-ad-set">Step 5: <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/createAdSet">Create an ad set</a></h4></div> <div class="ch-codeblock not-prose " data-ch-theme="s4d"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br/><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span>curl --request POST \</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> --url https://api-partner.spotify.com/ads/v3/ad_accounts/<AD_ACCOUNT_ID>/ad_sets \</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> --header 'Authorization: Bearer <ACCESS_TOKEN>' \</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> --header 'Content-Type: application/json' \</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> --data '{</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "name": "My Test Ad Set",</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "start_time": "2025-10-23T00:00:00Z",</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "end_time": "2025-10-30T00:00:00Z",</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "frequency_caps": [</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> {</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "frequency_unit": "DAY",</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "max_impressions": 3,</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "frequency_period": 1</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> },</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> {</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "frequency_unit": "WEEK",</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "max_impressions": 5,</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "frequency_period": 1</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> },</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> {</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "frequency_unit": "MONTH",</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "max_impressions": 15,</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "frequency_period": 1</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> }</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "bid_micro_amount": 5000000,</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "category": "ADV_1_1",</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "budget": {</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "micro_amount": 15000000,</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "type": "DAILY"</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> },</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "targets": {</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "age_ranges": [</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> {</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "min": 18,</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "max": 65</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> }</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "playlist_ids": [</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "holidays",</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "cooking"</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "genders": [</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "MALE"</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "geo_targets": {</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "dma_ids": [</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "501"</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "region_ids": [</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "5279468"</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "city_ids": [</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "4174700"</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> ]</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> },</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "genre_ids": [</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "rock",</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "blues"</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "platforms": [</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "IOS"</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> ],</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "placements": [</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "PODCAST",</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "MUSIC"</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> ]</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> },</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "bid_strategy": "MAX_BID",</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "campaign_id": "<CAMPAIGN_ID>",</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span> "asset_format": "AUDIO"</span></div></div><div><span class="ch-code-line-number">_72</span><div style="display:inline-block;margin-left:16px"><span>}'</span></div></div><br/></code></div></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">Upon success, the API will return an ID for the newly created ad set. Store this ID for use in Step 7 (Create an ad).</p> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">TIP: If you want to ensure your ad set is not trafficked while you are still finalizing details, you can set the "delivery" to "OFF" until you are ready to have it go live.</p> <div class="sc-9e80177b-1 ifxrgl"><h4 class="e-9581-text encore-text-body-medium-bold" data-encore-id="text" id="step-6-create--upload-assets">Step 6: Create & Upload assets</h4></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">First, <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/createAsset">create an asset</a> (the below example is for creating a companion image asset):</p> <div class="ch-codeblock not-prose " data-ch-theme="s4d"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br/><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span>curl --request POST \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> --url https://api-partner.spotify.com/ads/v3/ad_accounts/<AD_ACCOUNT_ID>/assets \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> --header 'Authorization: Bearer <ACCESS_TOKEN>' \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> --header 'Content-Type: application/json' \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> --data '{</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> "asset_type": "IMAGE",</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> "name": "myImage.png"</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span>}'</span></div></div><br/></code></div></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">Upon success, the API will return an ID for the newly created image asset.</p> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">Next, <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/uploadAsset">upload</a> your file to the newly created asset:</p> <div class="ch-codeblock not-prose " data-ch-theme="s4d"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br/><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span>curl -X 'POST' \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> 'https://api-partner.spotify.com/ads/v3/ad_accounts/<AD_ACCOUNT_ID>/assets/<ASSET_ID>/upload' \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> -H 'accept: application/json' \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> -H 'Authorization: Bearer <ACCESS_TOKEN>' \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> -H 'Content-Type: multipart/form-data' \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> -F 'media=@"<FILE_PATH>";type=image/"<FILE_TYPE>"' \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> -F 'asset_type="IMAGE"'</span></div></div><br/></code></div></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">TIP: You can confirm the asset has been processed successfully by calling the <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/getAsset">Get Asset</a> endpoint and referring to 'status' in the response:</p> <div class="ch-codeblock not-prose " data-ch-theme="s4d"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br/><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span>curl --request GET \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> --url https://api-partner.spotify.com/ads/v3/ad_accounts/<AD_ACCOUNT_ID>/assets/<ASSET_ID> \</span></div></div><div><span class="ch-code-line-number">_10</span><div style="display:inline-block;margin-left:16px"><span> --header 'Authorization: Bearer <ACCESS_TOKEN>'</span></div></div><br/></code></div></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">Repeat the above upload process for either an audio or a video asset and then proceed to Step 7. There are endpoints available to do a <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/startUploadChunkedAsset">chunked upload</a> for larger audio or video files.</p> <div class="sc-9e80177b-1 ifxrgl"><h4 class="e-9581-text encore-text-body-medium-bold" data-encore-id="text" id="step-7-create-an-ad">Step 7: <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/createAd">Create an ad</a></h4></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">All ads must include either an audio asset or a video asset, in addition to a companion image asset.</p> <div class="ch-codeblock not-prose " data-ch-theme="s4d"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br/><div><span class="ch-code-line-number">_17</span><div style="display:inline-block;margin-left:16px"><span>curl --request POST \</span></div></div><div><span class="ch-code-line-number">_17</span><div style="display:inline-block;margin-left:16px"><span> --url https://api-partner.spotify.com/ads/v3/ad_accounts/<AD_ACCOUNT_ID>/ads \</span></div></div><div><span class="ch-code-line-number">_17</span><div style="display:inline-block;margin-left:16px"><span> --header 'Authorization: Bearer <ACCESS_TOKEN>' \</span></div></div><div><span class="ch-code-line-number">_17</span><div style="display:inline-block;margin-left:16px"><span> --header 'Content-Type: application/json' \</span></div></div><div><span class="ch-code-line-number">_17</span><div style="display:inline-block;margin-left:16px"><span> --data '{</span></div></div><div><span class="ch-code-line-number">_17</span><div style="display:inline-block;margin-left:16px"><span> "advertiser_name": "My Advertiser",</span></div></div><div><span class="ch-code-line-number">_17</span><div style="display:inline-block;margin-left:16px"><span> "assets": {</span></div></div><div><span class="ch-code-line-number">_17</span><div style="display:inline-block;margin-left:16px"><span> "asset_id": "<AUDIO_OR_VIDEO_ASSET_ID>",</span></div></div><div><span class="ch-code-line-number">_17</span><div style="display:inline-block;margin-left:16px"><span> "companion_asset_id": "<IMAGE_ASSET_ID>"</span></div></div><div><span class="ch-code-line-number">_17</span><div style="display:inline-block;margin-left:16px"><span> },</span></div></div><div><span class="ch-code-line-number">_17</span><div style="display:inline-block;margin-left:16px"><span> "call_to_action": {</span></div></div><div><span class="ch-code-line-number">_17</span><div style="display:inline-block;margin-left:16px"><span> "clickthrough_url": "https://www.spotify.com"</span></div></div><div><span class="ch-code-line-number">_17</span><div style="display:inline-block;margin-left:16px"><span> },</span></div></div><div><span class="ch-code-line-number">_17</span><div style="display:inline-block;margin-left:16px"><span> "name": "My Test Ad",</span></div></div><div><span class="ch-code-line-number">_17</span><div style="display:inline-block;margin-left:16px"><span> "tagline": "Music for everyone",</span></div></div><div><span class="ch-code-line-number">_17</span><div style="display:inline-block;margin-left:16px"><span> "ad_set_id": "<AD_SET_ID>"</span></div></div><div><span class="ch-code-line-number">_17</span><div style="display:inline-block;margin-left:16px"><span>}'</span></div></div><br/></code></div></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">Upon success, the API will return an ID for the newly created ad.</p> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">TIP: If you want to ensure your ad is not trafficked while you are still finalizing details, you can set the "delivery" to "OFF" until you are ready to have it go live.</p> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">Congratulations on creating your first full campaign! Once your campaign has been approved through the review process and goes live, you can track its performance using the <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/reference/v3.0/getAggregateReport">Get Aggregate Report by Ad Account Id endpoint</a> endpoint.</p> <div class="sc-9e80177b-1 ifxrgl"><h2 class="e-9581-text encore-text-title-medium" data-encore-id="text" id="reporting">Reporting</h2></div> <div class="sc-9e80177b-1 ifxrgl"><h3 class="e-9581-text encore-text-title-small" data-encore-id="text" id="overview-1">Overview</h3></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">The Reporting API allows advertisers to access real-time performance data for campaigns created via Ads Manager UI or via third party platforms integrated with Spotify Campaign Management API based on custom queries. You can find definitions of the available metrics (aka “fields”) in the <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/guides#Metrics-Glossary">Metrics Glossary</a> section.</p> <div class="sc-9e80177b-1 ifxrgl"><h3 class="e-9581-text encore-text-title-small" data-encore-id="text" id="eligibility-criteria-1">Eligibility Criteria</h3></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">As of November 2022, the Reporting API is generally available ("GA") and no longer requires a manual allowlisting process to gain access. As soon as you have <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="/documentation/ads-api/documentation/ads-api/quick-start#initialize-your-new-ads-api-application">set up your application</a>, your client ID will be able to access these endpoints automatically.</p> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">Please note that the Reporting API is only available for advertisers with a Spotify <a class="Link-sc-k8gsk-0 flYERd e-9581-text-link" data-encore-id="textLink" href="https://adsmanager.spotify.com/">Ads Manager</a> account.</p> <div class="sc-9e80177b-1 ifxrgl"><h3 class="e-9581-text encore-text-title-small" data-encore-id="text" id="differences-from-the-ui-reporting">Differences from the UI (Reporting)</h3></div> <div class="sc-9e80177b-0 kRudhQ"><table class="e-9581-table" data-encore-id="table"><thead><tr class="e-9581-table-row" data-encore-id="tableRow"><th scope="col" class="encore-text-body-small-bold e-9581-baseline e-9581-table-header-cell e-9581-table-header-cell--start" data-encore-id="tableHeaderCell">Metric</th><th scope="col" class="encore-text-body-small-bold e-9581-baseline e-9581-table-header-cell e-9581-table-header-cell--start" data-encore-id="tableHeaderCell">Spotify Ads Manager UI</th><th scope="col" class="encore-text-body-small-bold e-9581-baseline e-9581-table-header-cell e-9581-table-header-cell--start" data-encore-id="tableHeaderCell">Spotify Ads API</th></tr></thead><tbody><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Budgets and Spend</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">“Budget Spent” metric (available at the ad set level only) will never exceed the budget amount set by the advertiser – overdelivery is only reflected in the ‘Pacing’ column</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM"><code>SPEND</code> field is not capped based on budget set by advertiser - in the event of overdelivery, <code>SPEND</code> may exceed the budget amount set by the advertiser but <strong>advertisers will only be billed up to their budget amount</strong></span></td></tr></tbody></table></div> <div class="sc-9e80177b-1 ifxrgl"><h2 class="e-9581-text encore-text-title-medium" data-encore-id="text" id="metrics-glossary">Metrics Glossary</h2></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">This section includes definitions for all of the campaign metrics (referred to as <code>fields</code>) that are available via the Reports endpoints.</p> <div class="sc-9e80177b-1 ifxrgl"><h3 class="e-9581-text encore-text-title-small" data-encore-id="text" id="campaign-performance-metrics">Campaign Performance Metrics</h3></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">These metrics provide the information you need to manage and optimize your campaigns efficiently and in real-time.</p> <div class="sc-9e80177b-0 kRudhQ"><table class="e-9581-table" data-encore-id="table"><thead><tr class="e-9581-table-row" data-encore-id="tableRow"><th scope="col" class="encore-text-body-small-bold e-9581-baseline e-9581-table-header-cell e-9581-table-header-cell--start" data-encore-id="tableHeaderCell">Metric/Field</th><th scope="col" class="encore-text-body-small-bold e-9581-baseline e-9581-table-header-cell e-9581-table-header-cell--start" data-encore-id="tableHeaderCell">Definition</th></tr></thead><tbody><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Clicks (<code>"CLICKS"</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of impressions in which your ad was clicked (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Completes (<code>“COMPLETES”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of ads served that was played to the end (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Completion Rate (<code>“COMPLETION_RATE”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The percentage of ads played to completion(%)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Click Through Rate (<code>“CTR”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The percentage of ads that were clicked (%)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Effective Cost per Mille (<code>“E_CPM”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The average cost per 1,000 impressions</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Effective Cost per Completed Listen (<code>“E_CPCL”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The average cost per 1,000 completed listens - NOTE: Applies to active audio/CPCL campaigns only</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">First Quartiles (<code>“FIRST_QUARTILES”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of users who listened or viewed 25% of the ad's total length (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Frequency of Ads Served(<code>“FREQUENCY”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The average number of times each person heard or viewed your ad (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Impressions(<code>"IMPRESSIONS"</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of times an ad has been served (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Midpoints (<code>“MIDPOINTS”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of users for which the ad played to the midpoint of the ads total length (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Off Spotify Impressions (<code>"OFF_SPOTIFY_IMPRESSIONS"</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of ads served off of Spotify (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Paid Listens (<code>“PAID_LISTENS”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of listens for a CPCL campaign where a user did NOT skip the ad -- NOTE: Applies to active audio/CPCL campaigns only</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Frequency of Paid Listens (<code>“PAID_LISTENS_FREQUENCY”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The average frequency for listens on a CPCL campaign -- NOTE: Applies to CPCL campaigns only</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Reach of Paid Listens (<code>“PAID_LISTENS_REACH”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of unique users who had a paid listen for this CPCL campaign -- NOTE: Applies to active audio/CPCL campaigns only</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Reach of Ads Served (<code>“REACH”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of unique users who received your ad (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Amount Spent (<code>"SPEND"</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The total amount spent in this campaign (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Starts (<code>“STARTS”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of times a user starts hearing/viewing your ad (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Skips(<code>"SKIPS"</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of times a user skips an ad -- NOTE: Skippable ads are currently supported in AU only (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Third Quartiles (<code>“THIRD_QUARTILES”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of users who listened or viewed 75% of the ad's total length (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Unmutes (<code>"UNMUTES"</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of times a user unmutes an ad (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Video Expands (<code>"VIDEO_EXPANDS"</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of times someone tapped your ad to expand it -- NOTE: Only available for campaigns with the video views objective (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Video Expand Rate (<code>"VIDEO_EXPAND_RATE"</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number ad expands divided by the number of impressions -- NOTE: Only available for campaigns with the video views objective (%)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Video Views (<code>"VIDEO_VIEWS"</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of times your video played for at least 3 seconds -- NOTE: Only available for campaigns with the video views objective (#)</span></td></tr></tbody></table></div> <div class="sc-9e80177b-1 ifxrgl"><h3 class="e-9581-text encore-text-title-small" data-encore-id="text" id="streaming-conversion-metrics">Streaming Conversion Metrics</h3></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl"><strong>Available only for campaigns using artist promotion or the streams objective.</strong> These metrics show you how listeners are responding to your ad so that you can understand how advertising impacts the listener journey on Spotify.</p> <div class="sc-9e80177b-0 kRudhQ"><table class="e-9581-table" data-encore-id="table"><thead><tr class="e-9581-table-row" data-encore-id="tableRow"><th scope="col" class="encore-text-body-small-bold e-9581-baseline e-9581-table-header-cell e-9581-table-header-cell--start" data-encore-id="tableHeaderCell">Metric/Field</th><th scope="col" class="encore-text-body-small-bold e-9581-baseline e-9581-table-header-cell e-9581-table-header-cell--start" data-encore-id="tableHeaderCell">Definition</th></tr></thead><tbody><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Average Streams per Listener (<code>“STREAMS_PER_USER”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The average number of times each listener streamed your content after seeing or hearing your ad. (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Average Streams per New Listener (<code>“STREAMS_PER_NEW_LISTENER”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The average number of times each new listener streamed your content after seeing or hearing your ad. (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Intent Rate (<code>“INTENT_RATE”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The percentage of listeners who took actions showing intent to stream your content again in the future. Actions include saving your content (by tapping the + icon or “save”) or adding it to a playlist. (%)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Listener Conversion Rate (<code>“CONVERSION_RATE”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The percentage of listeners who streamed your content after seeing or hearing your ad. (%)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Listeners(<code>“LISTENERS”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of unique Spotify users who streamed at least 30 seconds of the promoted content within 14 days of seeing or hearing your ad. (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">New Listener Streams (<code>"NEW_LISTENER_STREAMS"</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of streams from new listeners who heard or saw your ad. (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">New Listeners (<code>“NEW_LISTENERS”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of listeners who had not streamed your content in the 28 days before seeing or hearing your ad. (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">New Listeners Conversion Rate (<code>“NEW_LISTENER_CONVERSION_RATE”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The percentage of new listeners who streamed your content after seeing or hearing your ad. (%)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Streams (<code>"STREAMS"</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of times listeners streamed your content for at least 30 seconds within 14 days of seeing or hearing your ads. (#)</span></td></tr></tbody></table></div> <div class="sc-9e80177b-1 ifxrgl"><h3 class="e-9581-text encore-text-title-small" data-encore-id="text" id="pixel-metrics">Pixel Metrics</h3></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">These metrics help you understand how your advertising drives measurable conversions, providing insights into post-ad behaviors and the overall effectiveness of your campaign.</p> <div class="sc-9e80177b-0 kRudhQ"><table class="e-9581-table" data-encore-id="table"><thead><tr class="e-9581-table-row" data-encore-id="tableRow"><th scope="col" class="encore-text-body-small-bold e-9581-baseline e-9581-table-header-cell e-9581-table-header-cell--start" data-encore-id="tableHeaderCell">Metric/Field</th><th scope="col" class="encore-text-body-small-bold e-9581-baseline e-9581-table-header-cell e-9581-table-header-cell--start" data-encore-id="tableHeaderCell">Definition</th></tr></thead><tbody><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Modeled Add to Cart (<code>“MODELED_ADD_TO_CART”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of attributed add-to-cart events by modeled (not IP-matched) households (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Modeled Leads (<code>“MODELED_LEAD”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of attributed add-to-cart events by modeled (not IP-matched) households (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Modeled Page Views (<code>“MODELED_PAGE_VIEW”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of attributed website page views by modeled (not IP-matched) households (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Modeled Purchases (<code>“MODELED_PURCHASE”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of attributed purchase events by modeled (not IP-matched) households (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Unmodeled Add to Cart (<code>“UNMODELED_ADD_TO_CART”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of attributed add-to-cart events by IP-matched households (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Unmodeled Leads (<code>“UNMODELED_LEAD”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of attributed add-to-cart events by IP-matched households (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Unmodeled Page Views (<code>“UNMODELED_PAGE_VIEW”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of attributed website page views by IP-matched households (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">Unmodeled Purchases (<code>“UNMODELED_PURCHASE”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">The number of attributed purchase events by IP-matched households (#)</span></td></tr></tbody></table></div> <div class="sc-9e80177b-1 ifxrgl"><h3 class="e-9581-text encore-text-title-small" data-encore-id="text" id="app-conversion-metrics">App Conversion Metrics</h3></div> <p data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 ckCbjl">These metrics track the actions users take with your app after interacting with your ad, helping you to understand how your advertising influences behavior associated with your app.</p> <div class="sc-9e80177b-0 kRudhQ"><table class="e-9581-table" data-encore-id="table"><thead><tr class="e-9581-table-row" data-encore-id="tableRow"><th scope="col" class="encore-text-body-small-bold e-9581-baseline e-9581-table-header-cell e-9581-table-header-cell--start" data-encore-id="tableHeaderCell">Metric/Field</th><th scope="col" class="encore-text-body-small-bold e-9581-baseline e-9581-table-header-cell e-9581-table-header-cell--start" data-encore-id="tableHeaderCell">Definition</th></tr></thead><tbody><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">App Installs (AppsFlyer) (<code>“APPSFLYER_APP_INSTALLS”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">An attributed app install is counted when the downloaded app is opened. This data is provided to Spotify by your mobile measurement provider. (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">App Installs (Kochava) (<code>“KOCHAVA_APP_INSTALLS”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">An attributed app install is counted when the downloaded app is opened. This data is provided to Spotify by your mobile measurement provider. (#)</span></td></tr><tr class="e-9581-table-row" data-encore-id="tableRow"><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">SKAdNetwork App Installs (<code>“SKAD_APP_INSTALLS”</code>)</span></td><td class="encore-text-body-small e-9581-baseline e-9581-table-cell e-9581-table-cell--start" data-encore-id="tableCell"><span data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 kqItdM">An attributed app install is counted when the downloaded app is opened. This data is provided to Spotify by your mobile measurement provider. (#)</span></td></tr></tbody></table></div></div></div></main></div><footer class="sc-79176060-0 byLwnG encore-inverted-dark-set"><h2 class="e-9581-visually-hidden" data-encore-id="visuallyHidden">Footer</h2><nav aria-label="footer" class="sc-79176060-1 dPgCwV"><span class="sc-79176060-2 gpumOS"><a data-small="true" class="sc-539db49-0 iUCAkX" href="/"><svg aria-label="Spotify for Developers" xmlns="http://www.w3.org/2000/svg" width="240" height="34"><use href="/images/spotify-for-developers-logo.svg#s4d-logo"></use></svg></a></span><div class="Type__TypeElement-sc-goli3j-0 bXWpix sc-79176060-3 fBSVgz" data-encore-id="type"><h3 data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 jFxTq">Documentation</h3><ul role="list" data-encore-id="typeList" class="TypeList__TypeListElement-sc-1jhixr6-0 hWSKsH"><li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-79176060-4 ckOHVi" data-encore-id="textLink" href="/documentation/web-api">Web API</a></li><li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-79176060-4 ckOHVi" data-encore-id="textLink" href="/documentation/web-playback-sdk">Web Playback SDK</a></li><li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-79176060-4 ckOHVi" data-encore-id="textLink" href="/documentation/ads-api">Ads API</a></li><li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-79176060-4 ckOHVi" data-encore-id="textLink" href="/documentation/ios">iOS</a></li><li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-79176060-4 ckOHVi" data-encore-id="textLink" href="/documentation/android">Android</a></li><li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-79176060-4 ckOHVi" data-encore-id="textLink" href="/documentation/embeds">Embeds</a></li><li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-79176060-4 ckOHVi" data-encore-id="textLink" href="/documentation/commercial-hardware">Commercial Hardware</a></li></ul></div><div class="Type__TypeElement-sc-goli3j-0 bXWpix sc-79176060-3 fBSVgz" data-encore-id="type"><h3 data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 jFxTq">Guidelines</h3><ul role="list" data-encore-id="typeList" class="TypeList__TypeListElement-sc-1jhixr6-0 hWSKsH"><li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-79176060-4 ckOHVi" data-encore-id="textLink" href="/documentation/design">Design</a></li><li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-79176060-4 ckOHVi" data-encore-id="textLink" href="/documentation/accessibility">Accessibility</a></li></ul></div><div class="Type__TypeElement-sc-goli3j-0 bXWpix sc-79176060-3 fBSVgz" data-encore-id="type"><h3 data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 jFxTq">Community</h3><ul role="list" data-encore-id="typeList" class="TypeList__TypeListElement-sc-1jhixr6-0 hWSKsH"><li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-79176060-4 ckOHVi" data-encore-id="textLink" href="/community">News</a></li><li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-79176060-4 ckOHVi" data-encore-id="textLink" href="https://community.spotify.com/t5/Spotify-for-Developers/bd-p/Spotify_Developer">Forum</a></li></ul></div><div class="Type__TypeElement-sc-goli3j-0 bXWpix sc-79176060-3 fBSVgz" data-encore-id="type"><h3 data-encore-id="type" class="Type__TypeElement-sc-goli3j-0 jFxTq">Legal</h3><ul role="list" data-encore-id="typeList" class="TypeList__TypeListElement-sc-1jhixr6-0 hWSKsH"><li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-79176060-4 ckOHVi" data-encore-id="textLink" href="/terms">Developer Terms</a></li><li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-79176060-4 ckOHVi" data-encore-id="textLink" href="/policy">Developer Policy</a></li><li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-79176060-4 ckOHVi" data-encore-id="textLink" href="/compliance-tips">Compliance Tips</a></li><li class="e-9581-text encore-text-body-medium TypeListItem__TypeListItemElement-sc-q1l2mf-0 kqbyZR" data-encore-id="typeListItem"><a class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone sc-79176060-4 ckOHVi" data-encore-id="textLink" href="/third-party-licenses">Third Party Licenses</a></li></ul></div></nav><p class="Type__TypeElement-sc-goli3j-0 bXWpix sc-79176060-5 dgothR" data-encore-id="type"><a href="https://www.spotify.com/legal/end-user-agreement/" class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone" data-encore-id="textLink">Legal</a><a href="https://www.spotify.com/legal/cookies-policy/" class="Link-sc-k8gsk-0 bKOEJW e-9581-text-link e-9581-text-link--standalone" data-encore-id="textLink">Cookies</a><span>© 2025 Spotify AB</span></p></footer></div></div><script id="__NEXT_DATA__" type="application/json">{"props":{"pageProps":{"source":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nconst chCodeConfig = {\n \"staticMediaQuery\": \"not screen, (max-width: 768px)\",\n \"lineNumbers\": true,\n \"showCopyButton\": true,\n \"themeName\": \"s4d\"\n};\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n em: \"em\",\n h2: \"h2\",\n h3: \"h3\",\n h4: \"h4\",\n img: \"img\",\n li: \"li\",\n p: \"p\",\n strong: \"strong\",\n table: \"table\",\n tbody: \"tbody\",\n td: \"td\",\n th: \"th\",\n thead: \"thead\",\n tr: \"tr\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n }, {CH} = _components;\n if (!CH) _missingMdxReference(\"CH\", false);\n if (!CH.Code) _missingMdxReference(\"CH.Code\", true);\n return _jsxs(_Fragment, {\n children: [_jsx(\"style\", {\n dangerouslySetInnerHTML: {\n __html: \"[data-ch-theme=\\\"s4d\\\"] { --ch-t-colorScheme: dark;--ch-t-foreground: #ffffff;--ch-t-background: #1E073C;--ch-t-lighter-inlineBackground: #1e073ce6;--ch-t-editor-background: #1E073C;--ch-t-editor-foreground: #F8F8F2;--ch-t-editor-lineHighlightBackground: #3E3D32;--ch-t-editor-rangeHighlightBackground: #ffffff0b;--ch-t-editor-infoForeground: #3794FF;--ch-t-editor-selectionBackground: #49483E;--ch-t-focusBorder: #007FD4;--ch-t-tab-activeBackground: #1E073C;--ch-t-tab-activeForeground: #ffffff;--ch-t-tab-inactiveBackground: #2D2D2D;--ch-t-tab-inactiveForeground: #ffffff80;--ch-t-tab-border: #252526;--ch-t-tab-activeBorder: #1E073C;--ch-t-editorGroup-border: #444444;--ch-t-editorGroupHeader-tabsBackground: #252526;--ch-t-editorLineNumber-foreground: #858585;--ch-t-input-background: #3C3C3C;--ch-t-input-foreground: #F8F8F2;--ch-t-icon-foreground: #C5C5C5;--ch-t-sideBar-background: #252526;--ch-t-sideBar-foreground: #F8F8F2;--ch-t-sideBar-border: #252526;--ch-t-list-activeSelectionBackground: #094771;--ch-t-list-activeSelectionForeground: #fffffe;--ch-t-list-hoverBackground: #2A2D2E; }\"\n }\n }), \"\\n\", _jsx(_components.h2, {\n id: \"object-hierarchy\",\n children: \"Object Hierarchy\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Your \", _jsx(_components.a, {\n href: \"https://ads.spotify.com/en-US/how-it-works/\",\n children: \"Ads Manager\"\n }), \" account comprises sets of related objects organized in a hierarchy. The Ads API gives you direct, programmatic access to these objects. From top to bottom, the objects that build the structure of your account include:\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Businesses\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Ad Accounts\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Campaigns\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Ad Sets\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Ads\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Assets\"\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.img, {\n src: \"/images/products/ads-api/ads-manager-account-structure.png\",\n alt: \"\\\"Ads Manager Platform Structure\\\"\"\n })\n }), \"\\n\", _jsx(_components.h3, {\n id: \"businesses\",\n children: \"Businesses\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"When you create an account in Spotify Ads Manager, a business account and an associated ad account will automatically be created for you. A business is an object used to centrally manage multiple ad accounts.\"\n }), \"\\n\", _jsx(_components.h3, {\n id: \"ad-accounts\",\n children: \"Ad Accounts\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"You must have an ad account before you can create advertisers, campaigns, ad sets, or ads. Use the \", _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/getAllAdAccountsInBusiness\",\n children: \"Get Ad Account by ID\"\n }), \" endpoint to view information about your account after it has been set up.\"]\n }), \"\\n\", _jsx(_components.h3, {\n id: \"campaigns\",\n children: \"Campaigns\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"A campaign is an object that contains and organizes one or more ad sets. Also, you need a campaign \", _jsx(_components.em, {\n children: \"before\"\n }), \" you can create an ad set. Use the \", _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/createCampaign\",\n children: \"Create Campaign\"\n }), \" endpoint to create a campaign under your ad account.\"]\n }), \"\\n\", _jsx(_components.h3, {\n id: \"ad-sets\",\n children: \"Ad Sets\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"An ad set is the core component of your Ads Manager campaign. It is a child of a campaign object and contains all the essential information Ads Manager needs to execute your campaign. For example, an ad set contains:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Information about how, when, and where your campaign runs (e.g., start and end dates, bids, budgets, targeting, etc).\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"One or more ads.\"\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"See the \", _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/createAdSet\",\n children: \"Create Ad Set\"\n }), \" endpoint for more information or to add an ad set to a campaign.\"]\n }), \"\\n\", _jsx(_components.h3, {\n id: \"ads\",\n children: \"Ads\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"An ad is an object that contains an image asset along with either an audio or video asset. Each ad must be linked to an ad set but a given ad cannot be linked to multiple ad sets. See the eponymous \", _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/createAd\",\n children: \"Create Ad\"\n }), \" endpoint to get started.\"]\n }), \"\\n\", _jsx(_components.h3, {\n id: \"assets\",\n children: \"Assets\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"The Ads Manager platform supports audio, video, and image assets. These assets are required to create an ad. The asset endpoints help you upload and manage these items. Use the following endpoints to first create and then upload an asset:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/createAsset\",\n children: \"Create Asset\"\n })\n }), \"\\n\", _jsx(_components.li, {\n children: _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/uploadAsset\",\n children: \"Upload Asset\"\n })\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.h2, {\n id: \"campaign-management\",\n children: \"Campaign Management\"\n }), \"\\n\", _jsx(_components.h3, {\n id: \"overview\",\n children: \"Overview\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"The Campaign Management API allows you to create and manage campaigns, ad sets, and ads at scale. It also includes endpoints to estimate audience size and bid amount based on your targeting specifications (set at the ad set level).\"\n }), \"\\n\", _jsx(_components.h3, {\n id: \"eligibility-criteria\",\n children: \"Eligibility Criteria\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"As of August 2023, the Campaign Management API is generally available (\\\"GA\\\") and no longer requires a manual allowlisting process to gain access. As soon as you have \", _jsx(_components.a, {\n href: \"documentation/ads-api/quick-start#initialize-your-new-ads-api-application\",\n children: \"set up your application\"\n }), \", your client ID will be able to access these endpoints automatically.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Please note that the Campaign Management API is only available for advertisers with a Spotify \", _jsx(_components.a, {\n href: \"https://adsmanager.spotify.com/\",\n children: \"Ads Manager\"\n }), \" account.\"]\n }), \"\\n\", _jsx(_components.h3, {\n id: \"differences-from-the-ui\",\n children: \"Differences from the UI\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Most features available in the Ads Manager UI are also available via the Ads API, with a few exceptions:\"\n }), \"\\n\", _jsxs(_components.table, {\n children: [_jsx(_components.thead, {\n children: _jsxs(_components.tr, {\n children: [_jsx(_components.th, {\n style: {\n textAlign: \"center\"\n },\n children: \"Feature\"\n }), _jsx(_components.th, {\n style: {\n textAlign: \"center\"\n },\n children: \"Supported in Spotify Ads Manager UI\"\n }), _jsx(_components.th, {\n style: {\n textAlign: \"center\"\n },\n children: \"Supported in Spotify Ads API\"\n })]\n })\n }), _jsxs(_components.tbody, {\n children: [_jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"Create new ad account\"\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"yes\"\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"yes - as of v3\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"Manage users\"\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"yes\"\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"no\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"Manage billing/payment\"\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"yes\"\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"no\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"Voiceover generation\"\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"yes\"\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"no\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: _jsx(_components.a, {\n href: \"https://ads.spotify.com/en-US/help-center/targeting-ad-studio/#real_time_context_targeting\",\n children: \"Real-time context targeting\"\n })\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"yes\"\n }), _jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"yes - Referred to as \", _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/getPlaylistTargets\",\n children: \"playlist\"\n }), \" targeting\"]\n })]\n }), _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: _jsx(_components.a, {\n href: \"https://ads.spotify.com/en-US/help-center/targeting-ad-studio/#fan_targeting\",\n children: \"Fan targeting\"\n })\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"yes\"\n }), _jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"yes - Referred to as \", _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/getArtistTargets\",\n children: \"artist\"\n }), \" targeting\"]\n })]\n }), _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"MOAT viewability tracking set up\"\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"yes\"\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"no - Only IAS is available\"\n })]\n })]\n })]\n }), \"\\n\", _jsx(_components.h3, {\n id: \"build-a-campaign\",\n children: \"Build a campaign\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Follow these steps to build your first end-to-end campaign with the Ads API. NOTE: The below sample curl requests do not reflect every request parameter available.\"\n }), \"\\n\", _jsx(_components.h4, {\n id: \"step-1-retrieve-your-business--ad-account-id\",\n children: \"Step 1: Retrieve your business \u0026 ad account ID\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"If you're unsure of your business ID, you can call the \", _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/getBusinesses\",\n children: \"Get Businesses for Current User\"\n }), \" endpoint to return a list of all businesses available to the current authenticated user.\"]\n }), \"\\n\", _jsx(CH.Code, {\n codeConfig: chCodeConfig,\n northPanel: {\n \"tabs\": [\"\"],\n \"active\": \"\",\n \"heightRatio\": 1\n },\n files: [{\n \"name\": \"\",\n \"focus\": \"\",\n \"code\": {\n \"lines\": [{\n \"tokens\": [{\n \"content\": \"curl \",\n \"props\": {\n \"style\": {\n \"color\": \"#FFFFFF\"\n }\n }\n }, {\n \"content\": \"--request \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"GET \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --url \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"https://api-partner.spotify.com/ads/v3/businesses \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --header \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'Authorization: Bearer \u003cACCESS_TOKEN\u003e'\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }],\n \"lang\": \"bash\"\n },\n \"annotations\": []\n }]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"You can then use the business ID to retrieve a list of all ad accounts under the business that the current authenticated user has access to via the \", _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/getAllAdAccountsInBusiness\",\n children: \"Get Ad Accounts for Current User by Business ID\"\n }), \" endpoint.\"]\n }), \"\\n\", _jsx(CH.Code, {\n codeConfig: chCodeConfig,\n northPanel: {\n \"tabs\": [\"\"],\n \"active\": \"\",\n \"heightRatio\": 1\n },\n files: [{\n \"name\": \"\",\n \"focus\": \"\",\n \"code\": {\n \"lines\": [{\n \"tokens\": [{\n \"content\": \"curl \",\n \"props\": {\n \"style\": {\n \"color\": \"#FFFFFF\"\n }\n }\n }, {\n \"content\": \"--request \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"GET \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --url \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"https://api-partner.spotify.com/ads/v3/businesses/\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\u003c\",\n \"props\": {\n \"style\": {\n \"color\": \"#E1D457\"\n }\n }\n }, {\n \"content\": \"BUSINESS_I\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"D\",\n \"props\": {\n \"style\": {\n \"color\": \"#FFFFFF\"\n }\n }\n }, {\n \"content\": \"\u003e\",\n \"props\": {\n \"style\": {\n \"color\": \"#E1D457\"\n }\n }\n }, {\n \"content\": \"/ad_accounts \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --header \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'Authorization: Bearer \u003cACCESS_TOKEN\u003e'\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }],\n \"lang\": \"bash\"\n },\n \"annotations\": []\n }]\n }), \"\\n\", _jsxs(_components.h4, {\n id: \"step-2-create-a-campaign\",\n children: [\"Step 2: \", _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/createCampaign\",\n children: \"Create a campaign\"\n })]\n }), \"\\n\", _jsx(CH.Code, {\n codeConfig: chCodeConfig,\n northPanel: {\n \"tabs\": [\"\"],\n \"active\": \"\",\n \"heightRatio\": 1\n },\n files: [{\n \"name\": \"\",\n \"focus\": \"\",\n \"code\": {\n \"lines\": [{\n \"tokens\": [{\n \"content\": \"curl \",\n \"props\": {\n \"style\": {\n \"color\": \"#FFFFFF\"\n }\n }\n }, {\n \"content\": \"--request \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"POST \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --url \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"https://api-partner.spotify.com/ads/v3/ad_accounts/\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\u003c\",\n \"props\": {\n \"style\": {\n \"color\": \"#E1D457\"\n }\n }\n }, {\n \"content\": \"AD_ACCOUNT_I\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"D\",\n \"props\": {\n \"style\": {\n \"color\": \"#FFFFFF\"\n }\n }\n }, {\n \"content\": \"\u003e\",\n \"props\": {\n \"style\": {\n \"color\": \"#E1D457\"\n }\n }\n }, {\n \"content\": \"/campaigns \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --header \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'Authorization: Bearer \u003cACCESS_TOKEN\u003e' \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --header \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'Content-Type: application/json' \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --data \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'{\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"name\\\": \\\"My Test Campaign\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"objective\\\": \\\"EVEN_IMPRESSION_DELIVERY\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \"}'\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }],\n \"lang\": \"bash\"\n },\n \"annotations\": []\n }]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Upon success, the API will return an ID for the newly created campaign. Store this ID for use in Step 5 (Create an ad set).\"\n }), \"\\n\", _jsx(_components.h4, {\n id: \"step-3-define-targeting-specifications\",\n children: \"Step 3: Define targeting specifications\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Use the /targets endpoints to understand/retrieve the available targeting options -- supported categories include:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/getArtistTargets\",\n children: \"artist\"\n })\n }), \"\\n\", _jsx(_components.li, {\n children: _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/getGenreTargets\",\n children: \"genre\"\n })\n }), \"\\n\", _jsx(_components.li, {\n children: _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/getPlaylistTargets\",\n children: \"playlist\"\n })\n }), \"\\n\", _jsx(_components.li, {\n children: _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/getInterestTargets\",\n children: \"interest\"\n })\n }), \"\\n\", _jsx(_components.li, {\n children: _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/getLanguageTargets\",\n children: \"language\"\n })\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/getGeoTargets\",\n children: \"geographic location\"\n }), \" (country, region, DMA, city, and postal code)\"]\n }), \"\\n\", _jsx(_components.li, {\n children: _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/getEpisodeTopicTargets\",\n children: \"podcast episode topics\"\n })\n }), \"\\n\", _jsx(_components.li, {\n children: _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/getSensitiveTopicTargets\",\n children: \"sensitive topic targets\"\n })\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.h4, {\n id: \"step-4-optional-estimate-audience-size-and-recommended-bid-amount\",\n children: \"Step 4: [Optional] Estimate audience size and recommended bid amount\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"In order to help plan your campaign, we recommend using the /estimates endpoints to help forecast estimated audience size and recommended bid amount based on your targeting specifications (NOTE: Estimates are NOT a guarantee of performance).\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/estimateBid\",\n children: \"Retrieve a recommended bid range\"\n }), \":\"]\n }), \"\\n\", _jsx(CH.Code, {\n codeConfig: chCodeConfig,\n northPanel: {\n \"tabs\": [\"\"],\n \"active\": \"\",\n \"heightRatio\": 1\n },\n files: [{\n \"name\": \"\",\n \"focus\": \"\",\n \"code\": {\n \"lines\": [{\n \"tokens\": [{\n \"content\": \"curl \",\n \"props\": {\n \"style\": {\n \"color\": \"#FFFFFF\"\n }\n }\n }, {\n \"content\": \"--request \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"POST \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --url \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"https://api-partner.spotify.com/ads/v3/estimates/bid \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --header \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'Authorization: Bearer \u003cACCESS_TOKEN\u003e' \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --header \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'Content-Type: application/json' \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --data \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'{\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"start_date\\\": \\\"2025-09-23T04:00:00Z\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"end_date\\\": \\\"2025-10-23T04:00:00Z\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"bid_strategy\\\": \\\"MAX_BID\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"asset_format\\\": \\\"AUDIO\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"currency\\\": \\\"USD\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"targets\\\": {\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"age_ranges\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" {\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"min\\\": 18,\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"max\\\": 65\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" }\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"playlist_ids\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"holidays\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"cooking\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"genders\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"MALE\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"geo_targets\\\": {\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"dma_ids\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"501\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"region_ids\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"5279468\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"city_ids\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"4174700\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ]\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" },\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"genre_ids\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"rock\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"blues\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"platforms\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"IOS\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"placements\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"PODCAST\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"MUSIC\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ]\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" },\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"objective\\\": \\\"EVEN_IMPRESSION_DELIVERY\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \"}'\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }],\n \"lang\": \"bash\"\n },\n \"annotations\": []\n }]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/estimateAudience\",\n children: \"Retrieve an audience estimate\"\n }), \":\"]\n }), \"\\n\", _jsx(CH.Code, {\n codeConfig: chCodeConfig,\n northPanel: {\n \"tabs\": [\"\"],\n \"active\": \"\",\n \"heightRatio\": 1\n },\n files: [{\n \"name\": \"\",\n \"focus\": \"\",\n \"code\": {\n \"lines\": [{\n \"tokens\": [{\n \"content\": \"curl \",\n \"props\": {\n \"style\": {\n \"color\": \"#FFFFFF\"\n }\n }\n }, {\n \"content\": \"--request \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"POST \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --url \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"https://api-partner.spotify.com/ads/v3/estimates/audience \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --header \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'Authorization: Bearer \u003cACCESS_TOKEN\u003e' \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --header \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'Content-Type: application/json' \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --data \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'{\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"ad_account_id\\\": \\\"\u003cAD_ACCOUNT_ID\u003e\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"start_date\\\": \\\"2025-09-23T04:00:00Z\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"end_date\\\": \\\"2025-10-23T04:00:00Z\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"bid_strategy\\\": \\\"MAX_BID\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"asset_format\\\": \\\"AUDIO\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"targets\\\": {\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"age_ranges\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" {\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"min\\\": 18,\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"max\\\": 65\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" }\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"playlist_ids\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"holidays\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"cooking\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"platforms\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"IOS\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"genders\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"MALE\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"language\\\": \\\"en\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"geo_targets\\\": {\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"country_code\\\": \\\"US\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"dma_ids\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"501\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"region_ids\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"5279468\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"city_ids\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"4174700\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ]\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" },\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"genre_ids\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"rock\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"blues\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"placements\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"PODCAST\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"MUSIC\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ]\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" }\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" },\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"objective\\\": \\\"EVEN_IMPRESSION_DELIVERY\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"budget\\\": {\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"micro_amount\\\": 25000000,\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"type\\\": \\\"DAILY\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"currency\\\": \\\"USD\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" }\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \"}'\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }],\n \"lang\": \"bash\"\n },\n \"annotations\": []\n }]\n }), \"\\n\", _jsxs(_components.h4, {\n id: \"step-5-create-an-ad-set\",\n children: [\"Step 5: \", _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/createAdSet\",\n children: \"Create an ad set\"\n })]\n }), \"\\n\", _jsx(CH.Code, {\n codeConfig: chCodeConfig,\n northPanel: {\n \"tabs\": [\"\"],\n \"active\": \"\",\n \"heightRatio\": 1\n },\n files: [{\n \"name\": \"\",\n \"focus\": \"\",\n \"code\": {\n \"lines\": [{\n \"tokens\": [{\n \"content\": \"curl \",\n \"props\": {\n \"style\": {\n \"color\": \"#FFFFFF\"\n }\n }\n }, {\n \"content\": \"--request \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"POST \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --url \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"https://api-partner.spotify.com/ads/v3/ad_accounts/\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\u003c\",\n \"props\": {\n \"style\": {\n \"color\": \"#E1D457\"\n }\n }\n }, {\n \"content\": \"AD_ACCOUNT_I\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"D\",\n \"props\": {\n \"style\": {\n \"color\": \"#FFFFFF\"\n }\n }\n }, {\n \"content\": \"\u003e\",\n \"props\": {\n \"style\": {\n \"color\": \"#E1D457\"\n }\n }\n }, {\n \"content\": \"/ad_sets \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --header \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'Authorization: Bearer \u003cACCESS_TOKEN\u003e' \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --header \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'Content-Type: application/json' \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --data \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'{\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"name\\\": \\\"My Test Ad Set\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"start_time\\\": \\\"2025-10-23T00:00:00Z\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"end_time\\\": \\\"2025-10-30T00:00:00Z\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"frequency_caps\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" {\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"frequency_unit\\\": \\\"DAY\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"max_impressions\\\": 3,\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"frequency_period\\\": 1\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" },\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" {\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"frequency_unit\\\": \\\"WEEK\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"max_impressions\\\": 5,\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"frequency_period\\\": 1\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" },\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" {\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"frequency_unit\\\": \\\"MONTH\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"max_impressions\\\": 15,\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"frequency_period\\\": 1\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" }\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"bid_micro_amount\\\": 5000000,\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"category\\\": \\\"ADV_1_1\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"budget\\\": {\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"micro_amount\\\": 15000000,\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"type\\\": \\\"DAILY\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" },\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"targets\\\": {\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"age_ranges\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" {\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"min\\\": 18,\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"max\\\": 65\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" }\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"playlist_ids\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"holidays\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"cooking\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"genders\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"MALE\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"geo_targets\\\": {\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"dma_ids\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"501\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"region_ids\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"5279468\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"city_ids\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"4174700\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ]\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" },\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"genre_ids\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"rock\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"blues\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"platforms\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"IOS\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ],\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"placements\\\": [\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"PODCAST\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"MUSIC\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" ]\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" },\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"bid_strategy\\\": \\\"MAX_BID\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"campaign_id\\\": \\\"\u003cCAMPAIGN_ID\u003e\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"asset_format\\\": \\\"AUDIO\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \"}'\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }],\n \"lang\": \"bash\"\n },\n \"annotations\": []\n }]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Upon success, the API will return an ID for the newly created ad set. Store this ID for use in Step 7 (Create an ad).\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"TIP: If you want to ensure your ad set is not trafficked while you are still finalizing details, you can set the \\\"delivery\\\" to \\\"OFF\\\" until you are ready to have it go live.\"\n }), \"\\n\", _jsx(_components.h4, {\n id: \"step-6-create--upload-assets\",\n children: \"Step 6: Create \u0026 Upload assets\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"First, \", _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/createAsset\",\n children: \"create an asset\"\n }), \" (the below example is for creating a companion image asset):\"]\n }), \"\\n\", _jsx(CH.Code, {\n codeConfig: chCodeConfig,\n northPanel: {\n \"tabs\": [\"\"],\n \"active\": \"\",\n \"heightRatio\": 1\n },\n files: [{\n \"name\": \"\",\n \"focus\": \"\",\n \"code\": {\n \"lines\": [{\n \"tokens\": [{\n \"content\": \"curl \",\n \"props\": {\n \"style\": {\n \"color\": \"#FFFFFF\"\n }\n }\n }, {\n \"content\": \"--request \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"POST \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --url \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"https://api-partner.spotify.com/ads/v3/ad_accounts/\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\u003c\",\n \"props\": {\n \"style\": {\n \"color\": \"#E1D457\"\n }\n }\n }, {\n \"content\": \"AD_ACCOUNT_I\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"D\",\n \"props\": {\n \"style\": {\n \"color\": \"#FFFFFF\"\n }\n }\n }, {\n \"content\": \"\u003e\",\n \"props\": {\n \"style\": {\n \"color\": \"#E1D457\"\n }\n }\n }, {\n \"content\": \"/assets \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --header \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'Authorization: Bearer \u003cACCESS_TOKEN\u003e' \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --header \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'Content-Type: application/json' \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --data \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'{\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"asset_type\\\": \\\"IMAGE\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"name\\\": \\\"myImage.png\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \"}'\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }],\n \"lang\": \"bash\"\n },\n \"annotations\": []\n }]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Upon success, the API will return an ID for the newly created image asset.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Next, \", _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/uploadAsset\",\n children: \"upload\"\n }), \" your file to the newly created asset:\"]\n }), \"\\n\", _jsx(CH.Code, {\n codeConfig: chCodeConfig,\n northPanel: {\n \"tabs\": [\"\"],\n \"active\": \"\",\n \"heightRatio\": 1\n },\n files: [{\n \"name\": \"\",\n \"focus\": \"\",\n \"code\": {\n \"lines\": [{\n \"tokens\": [{\n \"content\": \"curl \",\n \"props\": {\n \"style\": {\n \"color\": \"#FFFFFF\"\n }\n }\n }, {\n \"content\": \"-X \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'POST' \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" 'https://api-partner.spotify.com/ads/v3/ad_accounts/\u003cAD_ACCOUNT_ID\u003e/assets/\u003cASSET_ID\u003e/upload' \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" -H \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'accept: application/json' \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" -H \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'Authorization: Bearer \u003cACCESS_TOKEN\u003e' \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" -H \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'Content-Type: multipart/form-data' \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" -F \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'media=@\\\"\u003cFILE_PATH\u003e\\\";type=image/\\\"\u003cFILE_TYPE\u003e\\\"' \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" -F \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'asset_type=\\\"IMAGE\\\"'\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }],\n \"lang\": \"bash\"\n },\n \"annotations\": []\n }]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"TIP: You can confirm the asset has been processed successfully by calling the \", _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/getAsset\",\n children: \"Get Asset\"\n }), \" endpoint and referring to 'status' in the response:\"]\n }), \"\\n\", _jsx(CH.Code, {\n codeConfig: chCodeConfig,\n northPanel: {\n \"tabs\": [\"\"],\n \"active\": \"\",\n \"heightRatio\": 1\n },\n files: [{\n \"name\": \"\",\n \"focus\": \"\",\n \"code\": {\n \"lines\": [{\n \"tokens\": [{\n \"content\": \"curl \",\n \"props\": {\n \"style\": {\n \"color\": \"#FFFFFF\"\n }\n }\n }, {\n \"content\": \"--request \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"GET \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --url \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"https://api-partner.spotify.com/ads/v3/ad_accounts/\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\u003c\",\n \"props\": {\n \"style\": {\n \"color\": \"#E1D457\"\n }\n }\n }, {\n \"content\": \"AD_ACCOUNT_I\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"D\",\n \"props\": {\n \"style\": {\n \"color\": \"#FFFFFF\"\n }\n }\n }, {\n \"content\": \"\u003e\",\n \"props\": {\n \"style\": {\n \"color\": \"#E1D457\"\n }\n }\n }, {\n \"content\": \"/assets/\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\u003c\",\n \"props\": {\n \"style\": {\n \"color\": \"#E1D457\"\n }\n }\n }, {\n \"content\": \"ASSET_I\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"D\",\n \"props\": {\n \"style\": {\n \"color\": \"#FFFFFF\"\n }\n }\n }, {\n \"content\": \"\u003e \",\n \"props\": {\n \"style\": {\n \"color\": \"#E1D457\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --header \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'Authorization: Bearer \u003cACCESS_TOKEN\u003e'\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }],\n \"lang\": \"bash\"\n },\n \"annotations\": []\n }]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Repeat the above upload process for either an audio or a video asset and then proceed to Step 7. There are endpoints available to do a \", _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/startUploadChunkedAsset\",\n children: \"chunked upload\"\n }), \" for larger audio or video files.\"]\n }), \"\\n\", _jsxs(_components.h4, {\n id: \"step-7-create-an-ad\",\n children: [\"Step 7: \", _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/createAd\",\n children: \"Create an ad\"\n })]\n }), \"\\n\", _jsx(_components.p, {\n children: \"All ads must include either an audio asset or a video asset, in addition to a companion image asset.\"\n }), \"\\n\", _jsx(CH.Code, {\n codeConfig: chCodeConfig,\n northPanel: {\n \"tabs\": [\"\"],\n \"active\": \"\",\n \"heightRatio\": 1\n },\n files: [{\n \"name\": \"\",\n \"focus\": \"\",\n \"code\": {\n \"lines\": [{\n \"tokens\": [{\n \"content\": \"curl \",\n \"props\": {\n \"style\": {\n \"color\": \"#FFFFFF\"\n }\n }\n }, {\n \"content\": \"--request \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"POST \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --url \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"https://api-partner.spotify.com/ads/v3/ad_accounts/\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\u003c\",\n \"props\": {\n \"style\": {\n \"color\": \"#E1D457\"\n }\n }\n }, {\n \"content\": \"AD_ACCOUNT_I\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"D\",\n \"props\": {\n \"style\": {\n \"color\": \"#FFFFFF\"\n }\n }\n }, {\n \"content\": \"\u003e\",\n \"props\": {\n \"style\": {\n \"color\": \"#E1D457\"\n }\n }\n }, {\n \"content\": \"/ads \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --header \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'Authorization: Bearer \u003cACCESS_TOKEN\u003e' \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --header \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'Content-Type: application/json' \",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }, {\n \"content\": \"\\\\\",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" --data \",\n \"props\": {\n \"style\": {\n \"color\": \"#C985FB\"\n }\n }\n }, {\n \"content\": \"'{\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"advertiser_name\\\": \\\"My Advertiser\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"assets\\\": {\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"asset_id\\\": \\\"\u003cAUDIO_OR_VIDEO_ASSET_ID\u003e\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"companion_asset_id\\\": \\\"\u003cIMAGE_ASSET_ID\u003e\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" },\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"call_to_action\\\": {\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"clickthrough_url\\\": \\\"https://www.spotify.com\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" },\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"name\\\": \\\"My Test Ad\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"tagline\\\": \\\"Music for everyone\\\",\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \" \\\"ad_set_id\\\": \\\"\u003cAD_SET_ID\u003e\\\"\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }, {\n \"tokens\": [{\n \"content\": \"}'\",\n \"props\": {\n \"style\": {\n \"color\": \"#2CCDA9\"\n }\n }\n }]\n }],\n \"lang\": \"bash\"\n },\n \"annotations\": []\n }]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Upon success, the API will return an ID for the newly created ad.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"TIP: If you want to ensure your ad is not trafficked while you are still finalizing details, you can set the \\\"delivery\\\" to \\\"OFF\\\" until you are ready to have it go live.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Congratulations on creating your first full campaign! Once your campaign has been approved through the review process and goes live, you can track its performance using the \", _jsx(_components.a, {\n href: \"/documentation/ads-api/reference/v3.0/getAggregateReport\",\n children: \"Get Aggregate Report by Ad Account Id endpoint\"\n }), \" endpoint.\"]\n }), \"\\n\", _jsx(_components.h2, {\n id: \"reporting\",\n children: \"Reporting\"\n }), \"\\n\", _jsx(_components.h3, {\n id: \"overview-1\",\n children: \"Overview\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The Reporting API allows advertisers to access real-time performance data for campaigns created via Ads Manager UI or via third party platforms integrated with Spotify Campaign Management API based on custom queries. You can find definitions of the available metrics (aka “fields”) in the \", _jsx(_components.a, {\n href: \"#Metrics-Glossary\",\n children: \"Metrics Glossary\"\n }), \" section.\"]\n }), \"\\n\", _jsx(_components.h3, {\n id: \"eligibility-criteria-1\",\n children: \"Eligibility Criteria\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"As of November 2022, the Reporting API is generally available (\\\"GA\\\") and no longer requires a manual allowlisting process to gain access. As soon as you have \", _jsx(_components.a, {\n href: \"documentation/ads-api/quick-start#initialize-your-new-ads-api-application\",\n children: \"set up your application\"\n }), \", your client ID will be able to access these endpoints automatically.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Please note that the Reporting API is only available for advertisers with a Spotify \", _jsx(_components.a, {\n href: \"https://adsmanager.spotify.com/\",\n children: \"Ads Manager\"\n }), \" account.\"]\n }), \"\\n\", _jsx(_components.h3, {\n id: \"differences-from-the-ui-reporting\",\n children: \"Differences from the UI (Reporting)\"\n }), \"\\n\", _jsxs(_components.table, {\n children: [_jsx(_components.thead, {\n children: _jsxs(_components.tr, {\n children: [_jsx(_components.th, {\n children: \"Metric\"\n }), _jsx(_components.th, {\n children: \"Spotify Ads Manager UI\"\n }), _jsx(_components.th, {\n children: \"Spotify Ads API\"\n })]\n })\n }), _jsx(_components.tbody, {\n children: _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n children: \"Budgets and Spend\"\n }), _jsx(_components.td, {\n children: \"“Budget Spent” metric (available at the ad set level only) will never exceed the budget amount set by the advertiser – overdelivery is only reflected in the ‘Pacing’ column\"\n }), _jsxs(_components.td, {\n children: [_jsx(_components.code, {\n children: \"SPEND\"\n }), \" field is not capped based on budget set by advertiser - in the event of overdelivery, \", _jsx(_components.code, {\n children: \"SPEND\"\n }), \" may exceed the budget amount set by the advertiser but \", _jsx(_components.strong, {\n children: \"advertisers will only be billed up to their budget amount\"\n })]\n })]\n })\n })]\n }), \"\\n\", _jsx(_components.h2, {\n id: \"metrics-glossary\",\n children: \"Metrics Glossary\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"This section includes definitions for all of the campaign metrics (referred to as \", _jsx(_components.code, {\n children: \"fields\"\n }), \") that are available via the Reports endpoints.\"]\n }), \"\\n\", _jsx(_components.h3, {\n id: \"campaign-performance-metrics\",\n children: \"Campaign Performance Metrics\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"These metrics provide the information you need to manage and optimize your campaigns efficiently and in real-time.\"\n }), \"\\n\", _jsxs(_components.table, {\n children: [_jsx(_components.thead, {\n children: _jsxs(_components.tr, {\n children: [_jsx(_components.th, {\n style: {\n textAlign: \"center\"\n },\n children: \"Metric/Field\"\n }), _jsx(_components.th, {\n style: {\n textAlign: \"center\"\n },\n children: \"Definition\"\n })]\n })\n }), _jsxs(_components.tbody, {\n children: [_jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Clicks (\", _jsx(_components.code, {\n children: \"\\\"CLICKS\\\"\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of impressions in which your ad was clicked (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Completes (\", _jsx(_components.code, {\n children: \"“COMPLETES”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of ads served that was played to the end (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Completion Rate (\", _jsx(_components.code, {\n children: \"“COMPLETION_RATE”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The percentage of ads played to completion(%)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Click Through Rate (\", _jsx(_components.code, {\n children: \"“CTR”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The percentage of ads that were clicked (%)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Effective Cost per Mille (\", _jsx(_components.code, {\n children: \"“E_CPM”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The average cost per 1,000 impressions\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Effective Cost per Completed Listen (\", _jsx(_components.code, {\n children: \"“E_CPCL”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The average cost per 1,000 completed listens - NOTE: Applies to active audio/CPCL campaigns only\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"First Quartiles (\", _jsx(_components.code, {\n children: \"“FIRST_QUARTILES”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of users who listened or viewed 25% of the ad's total length (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Frequency of Ads Served(\", _jsx(_components.code, {\n children: \"“FREQUENCY”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The average number of times each person heard or viewed your ad (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Impressions(\", _jsx(_components.code, {\n children: \"\\\"IMPRESSIONS\\\"\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of times an ad has been served (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Midpoints (\", _jsx(_components.code, {\n children: \"“MIDPOINTS”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of users for which the ad played to the midpoint of the ads total length (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Off Spotify Impressions (\", _jsx(_components.code, {\n children: \"\\\"OFF_SPOTIFY_IMPRESSIONS\\\"\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of ads served off of Spotify (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Paid Listens (\", _jsx(_components.code, {\n children: \"“PAID_LISTENS”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of listens for a CPCL campaign where a user did NOT skip the ad -- NOTE: Applies to active audio/CPCL campaigns only\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Frequency of Paid Listens (\", _jsx(_components.code, {\n children: \"“PAID_LISTENS_FREQUENCY”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The average frequency for listens on a CPCL campaign -- NOTE: Applies to CPCL campaigns only\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Reach of Paid Listens (\", _jsx(_components.code, {\n children: \"“PAID_LISTENS_REACH”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of unique users who had a paid listen for this CPCL campaign -- NOTE: Applies to active audio/CPCL campaigns only\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Reach of Ads Served (\", _jsx(_components.code, {\n children: \"“REACH”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of unique users who received your ad (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Amount Spent (\", _jsx(_components.code, {\n children: \"\\\"SPEND\\\"\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The total amount spent in this campaign (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Starts (\", _jsx(_components.code, {\n children: \"“STARTS”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of times a user starts hearing/viewing your ad (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Skips(\", _jsx(_components.code, {\n children: \"\\\"SKIPS\\\"\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of times a user skips an ad -- NOTE: Skippable ads are currently supported in AU only (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Third Quartiles (\", _jsx(_components.code, {\n children: \"“THIRD_QUARTILES”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of users who listened or viewed 75% of the ad's total length (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Unmutes (\", _jsx(_components.code, {\n children: \"\\\"UNMUTES\\\"\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of times a user unmutes an ad (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Video Expands (\", _jsx(_components.code, {\n children: \"\\\"VIDEO_EXPANDS\\\"\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of times someone tapped your ad to expand it -- NOTE: Only available for campaigns with the video views objective (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Video Expand Rate (\", _jsx(_components.code, {\n children: \"\\\"VIDEO_EXPAND_RATE\\\"\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number ad expands divided by the number of impressions -- NOTE: Only available for campaigns with the video views objective (%)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Video Views (\", _jsx(_components.code, {\n children: \"\\\"VIDEO_VIEWS\\\"\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of times your video played for at least 3 seconds -- NOTE: Only available for campaigns with the video views objective (#)\"\n })]\n })]\n })]\n }), \"\\n\", _jsx(_components.h3, {\n id: \"streaming-conversion-metrics\",\n children: \"Streaming Conversion Metrics\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Available only for campaigns using artist promotion or the streams objective.\"\n }), \" These metrics show you how listeners are responding to your ad so that you can understand how advertising impacts the listener journey on Spotify.\"]\n }), \"\\n\", _jsxs(_components.table, {\n children: [_jsx(_components.thead, {\n children: _jsxs(_components.tr, {\n children: [_jsx(_components.th, {\n style: {\n textAlign: \"center\"\n },\n children: \"Metric/Field\"\n }), _jsx(_components.th, {\n style: {\n textAlign: \"center\"\n },\n children: \"Definition\"\n })]\n })\n }), _jsxs(_components.tbody, {\n children: [_jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Average Streams per Listener (\", _jsx(_components.code, {\n children: \"“STREAMS_PER_USER”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The average number of times each listener streamed your content after seeing or hearing your ad. (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Average Streams per New Listener (\", _jsx(_components.code, {\n children: \"“STREAMS_PER_NEW_LISTENER”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The average number of times each new listener streamed your content after seeing or hearing your ad. (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Intent Rate (\", _jsx(_components.code, {\n children: \"“INTENT_RATE”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The percentage of listeners who took actions showing intent to stream your content again in the future. Actions include saving your content (by tapping the + icon or “save”) or adding it to a playlist. (%)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Listener Conversion Rate (\", _jsx(_components.code, {\n children: \"“CONVERSION_RATE”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The percentage of listeners who streamed your content after seeing or hearing your ad. (%)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Listeners(\", _jsx(_components.code, {\n children: \"“LISTENERS”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of unique Spotify users who streamed at least 30 seconds of the promoted content within 14 days of seeing or hearing your ad. (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"New Listener Streams (\", _jsx(_components.code, {\n children: \"\\\"NEW_LISTENER_STREAMS\\\"\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of streams from new listeners who heard or saw your ad. (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"New Listeners (\", _jsx(_components.code, {\n children: \"“NEW_LISTENERS”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of listeners who had not streamed your content in the 28 days before seeing or hearing your ad. (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"New Listeners Conversion Rate (\", _jsx(_components.code, {\n children: \"“NEW_LISTENER_CONVERSION_RATE”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The percentage of new listeners who streamed your content after seeing or hearing your ad. (%)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Streams (\", _jsx(_components.code, {\n children: \"\\\"STREAMS\\\"\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of times listeners streamed your content for at least 30 seconds within 14 days of seeing or hearing your ads. (#)\"\n })]\n })]\n })]\n }), \"\\n\", _jsx(_components.h3, {\n id: \"pixel-metrics\",\n children: \"Pixel Metrics\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"These metrics help you understand how your advertising drives measurable conversions, providing insights into post-ad behaviors and the overall effectiveness of your campaign.\"\n }), \"\\n\", _jsxs(_components.table, {\n children: [_jsx(_components.thead, {\n children: _jsxs(_components.tr, {\n children: [_jsx(_components.th, {\n style: {\n textAlign: \"center\"\n },\n children: \"Metric/Field\"\n }), _jsx(_components.th, {\n style: {\n textAlign: \"center\"\n },\n children: \"Definition\"\n })]\n })\n }), _jsxs(_components.tbody, {\n children: [_jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Modeled Add to Cart (\", _jsx(_components.code, {\n children: \"“MODELED_ADD_TO_CART”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of attributed add-to-cart events by modeled (not IP-matched) households (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Modeled Leads (\", _jsx(_components.code, {\n children: \"“MODELED_LEAD”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of attributed add-to-cart events by modeled (not IP-matched) households (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Modeled Page Views (\", _jsx(_components.code, {\n children: \"“MODELED_PAGE_VIEW”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of attributed website page views by modeled (not IP-matched) households (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Modeled Purchases (\", _jsx(_components.code, {\n children: \"“MODELED_PURCHASE”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of attributed purchase events by modeled (not IP-matched) households (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Unmodeled Add to Cart (\", _jsx(_components.code, {\n children: \"“UNMODELED_ADD_TO_CART”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of attributed add-to-cart events by IP-matched households (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Unmodeled Leads (\", _jsx(_components.code, {\n children: \"“UNMODELED_LEAD”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of attributed add-to-cart events by IP-matched households (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Unmodeled Page Views (\", _jsx(_components.code, {\n children: \"“UNMODELED_PAGE_VIEW”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of attributed website page views by IP-matched households (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"Unmodeled Purchases (\", _jsx(_components.code, {\n children: \"“UNMODELED_PURCHASE”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"The number of attributed purchase events by IP-matched households (#)\"\n })]\n })]\n })]\n }), \"\\n\", _jsx(_components.h3, {\n id: \"app-conversion-metrics\",\n children: \"App Conversion Metrics\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"These metrics track the actions users take with your app after interacting with your ad, helping you to understand how your advertising influences behavior associated with your app.\"\n }), \"\\n\", _jsxs(_components.table, {\n children: [_jsx(_components.thead, {\n children: _jsxs(_components.tr, {\n children: [_jsx(_components.th, {\n style: {\n textAlign: \"center\"\n },\n children: \"Metric/Field\"\n }), _jsx(_components.th, {\n style: {\n textAlign: \"center\"\n },\n children: \"Definition\"\n })]\n })\n }), _jsxs(_components.tbody, {\n children: [_jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"App Installs (AppsFlyer) (\", _jsx(_components.code, {\n children: \"“APPSFLYER_APP_INSTALLS”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"An attributed app install is counted when the downloaded app is opened. This data is provided to Spotify by your mobile measurement provider. (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"App Installs (Kochava) (\", _jsx(_components.code, {\n children: \"“KOCHAVA_APP_INSTALLS”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"An attributed app install is counted when the downloaded app is opened. This data is provided to Spotify by your mobile measurement provider. (#)\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsxs(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: [\"SKAdNetwork App Installs (\", _jsx(_components.code, {\n children: \"“SKAD_APP_INSTALLS”\"\n }), \")\"]\n }), _jsx(_components.td, {\n style: {\n textAlign: \"center\"\n },\n children: \"An attributed app install is counted when the downloaded app is opened. This data is provided to Spotify by your mobile measurement provider. (#)\"\n })]\n })]\n })]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n chCodeConfig,\n default: MDXContent\n};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\n}\n","frontmatter":{"title":"Ads API Guides"},"scope":{}},"pageTitle":"Ads API Guides","hideFromSearch":false,"policyReferences":{"StandalonePreview":{"title":"Spotify Audio preview clips can not be a standalone service","description":"Audio Preview Clips may not be offered as a standalone service or product.","url":"/policy/#ii-respect-content-and-creators:~:text=You must not offer metadata,as a standalone service or product."},"ContentAlteration":{"title":"Keep audio content in its original form","description":"The Spotify Platform can not be used to develop applications that alter Spotify Content.","url":"/policy/#iii-some-prohibited-applications:~:text=Do not permit any device or system to segue,."},"Synchronization":{"title":"Do not synchronize Spotify content","description":"You may not synchronize any sound recordings with any visual media, including any advertising, film, television program, slideshow, video, or similar content","url":"/policy/#iii-some-prohibited-applications:~:text=Do not synchronize any sound recordings with any visual media,."},"Downloading":{"title":"Spotify content may not be downloaded","description":"You may not facilitate downloads of Spotify content or enable “stream ripping”","url":"/terms/#section-iv-restrictions:~:text=facilitating,make permanent copies of Spotify Content."},"VisualAlteration":{"title":"Keep visual content in its original form","description":"Spotify visual content must be kept in its original form, e.g. you can not crop album artwork, overlay images on album artwork, place a brand/logo on album artwork","url":"/documentation/design#using-our-content"},"CommercialStreaming":{"title":"Streaming applications may not be commercial","description":"The Spotify Platform can not be used to develop commercial streaming integrations.","url":"/policy/#iv-streaming-and-commercial-use:~:text=Commercial use restrictions,Streaming SDA itself."},"Attribution":{"title":"Ensure content attribution","description":"Please keep in mind that metadata, cover art and artist images must be accompanied by a link back to the applicable artist, album, track, or playlist on the Spotify Service. You must also attribute content from Spotify with the logo.","url":"/policy/#ii-respect-content-and-creators:~:text=If you display any Spotify Content,on the Spotify Service."},"Broadcasting":{"title":"Spotify content may not be broadcasted","description":"The Spotify Platform can not be used for non-interactive broadcasting.","url":"/policy/#iii-some-prohibited-applications:~:text=Do not create any product or service which includes any non,several simultaneous listeners."},"MultipleIntegrations":{"title":"Spotify data may not be transferred","description":"Please keep in mind that you can not enable transfers of data to another service, except for the purpose of enabling a user to transfer their personal data or the metadata of the user's playlists to another service.","url":"/policy/#iii-some-prohibited-applications:~:text=Do not build an SDA that enables the transfer of data,."},"MachineLearning":{"title":"Spotify content may not be used to train machine learning or AI model","description":"Please note that you can not use the Spotify Platform or any Spotify Content to train a machine learning or AI model or otherwise ingesting Spotify Content into a machine learning or AI model.","url":"/terms#section-iv-restrictions:~:text=Misuse%20of%20the,or%20AI%20model%3B"}},"adsApiReferenceLinks":{"v3.0":[{"tags":["ad-accounts"],"path":"/ad_accounts/{ad_account_id}","method":"get","label":"Get Ad Account by ID","operationId":"getAdAccount"},{"tags":["ad-accounts"],"path":"/ad_accounts/{ad_account_id}","method":"patch","label":"Update Ad Account","operationId":"updateAdAccount"},{"tags":["ad-categories"],"path":"/ad_categories","method":"get","label":"Get Ad Categories","operationId":"getAdCategories"},{"tags":["ad-sets"],"path":"/ad_accounts/{ad_account_id}/ad_sets/{ad_set_id}","method":"get","label":"Get Ad Set by ID","operationId":"getAdSetById"},{"tags":["ad-sets"],"path":"/ad_accounts/{ad_account_id}/ad_sets/{ad_set_id}","method":"patch","label":"Update Ad Set","operationId":"updateAdSet"},{"tags":["ad-sets"],"path":"/ad_accounts/{ad_account_id}/ad_sets","method":"get","label":"Get Ad Sets by Ad Account ID","operationId":"getAdSetsByAdAccountId"},{"tags":["ad-sets"],"path":"/ad_accounts/{ad_account_id}/ad_sets","method":"post","label":"Create an Ad Set","operationId":"createAdSet"},{"tags":["ads"],"path":"/ad_accounts/{ad_account_id}/ads","method":"get","label":"Get Ads by Ad Account ID","operationId":"getAds"},{"tags":["ads"],"path":"/ad_accounts/{ad_account_id}/ads","method":"post","label":"Create an Ad","operationId":"createAd"},{"tags":["ads"],"path":"/ad_accounts/{ad_account_id}/ads/{ad_id}","method":"get","label":"Get Ad by ID","operationId":"getAd"},{"tags":["ads"],"path":"/ad_accounts/{ad_account_id}/ads/{ad_id}","method":"patch","label":"Update an Ad","operationId":"updateAd"},{"tags":["assets"],"path":"/ad_accounts/{ad_account_id}/assets","method":"get","label":"Get Assets by Ad Account","operationId":"getAssetsByAdAccount"},{"tags":["assets"],"path":"/ad_accounts/{ad_account_id}/assets","method":"post","label":"Create Asset","operationId":"createAsset"},{"tags":["assets"],"path":"/ad_accounts/{ad_account_id}/assets/{asset_id}","method":"get","label":"Get Asset by ID","operationId":"getAsset"},{"tags":["assets"],"path":"/ad_accounts/{ad_account_id}/assets/{asset_id}","method":"patch","label":"Update Asset","operationId":"updateAsset"},{"tags":["assets"],"path":"/ad_accounts/{ad_account_id}/assets/{asset_id}/upload","method":"post","label":"Upload Asset","operationId":"uploadAsset"},{"tags":["assets"],"path":"/ad_accounts/{ad_account_id}/assets/{asset_id}/chunked_upload/start","method":"post","label":"Start Upload Chunked Asset","operationId":"startUploadChunkedAsset"},{"tags":["assets"],"path":"/ad_accounts/{ad_account_id}/assets/{asset_id}/chunked_upload/transfer","method":"post","label":"Transfer Chunked Asset","operationId":"transferChunkedAsset"},{"tags":["assets"],"path":"/ad_accounts/{ad_account_id}/assets/{asset_id}/chunked_upload/complete","method":"post","label":"Complete Upload Chunked Asset","operationId":"completeUploadChunkedAsset"},{"tags":["businesses"],"path":"/businesses","method":"get","label":"Get Businesses for Current User","operationId":"getBusinesses"},{"tags":["businesses"],"path":"/businesses","method":"post","label":"Create Business","operationId":"createBusiness"},{"tags":["businesses"],"path":"/businesses/{business_id}","method":"get","label":"Get Business by ID","operationId":"getBusiness"},{"tags":["businesses"],"path":"/businesses/{business_id}","method":"patch","label":"Update Business","operationId":"updateBusiness"},{"tags":["ad-accounts"],"path":"/businesses/{business_id}/ad_accounts","method":"get","label":"Get Ad Accounts for Current User by Business ID","operationId":"getAdAccountsInBusiness"},{"tags":["ad-accounts"],"path":"/businesses/{business_id}/ad_accounts","method":"post","label":"Create Ad Account","operationId":"createAdAccountForBusiness"},{"tags":["campaigns"],"path":"/ad_accounts/{ad_account_id}/campaigns","method":"get","label":"Get Campaigns by Ad Account ID","operationId":"getCampaigns"},{"tags":["campaigns"],"path":"/ad_accounts/{ad_account_id}/campaigns","method":"post","label":"Create a Campaign","operationId":"createCampaign"},{"tags":["campaigns"],"path":"/ad_accounts/{ad_account_id}/campaigns/{campaign_id}","method":"get","label":"Get Campaign by ID","operationId":"getCampaign"},{"tags":["campaigns"],"path":"/ad_accounts/{ad_account_id}/campaigns/{campaign_id}","method":"patch","label":"Update a Campaign","operationId":"updateCampaign"},{"tags":["estimates"],"path":"/estimates/audience","method":"post","label":"Estimate audience","operationId":"estimateAudience"},{"tags":["estimates"],"path":"/estimates/bid","method":"post","label":"Estimate bid","operationId":"estimateBid"},{"tags":["podcast-shows"],"path":"/podcast_shows","method":"get","label":"Get Podcast Shows","operationId":"getPodcastShows"},{"tags":["reports"],"path":"/ad_accounts/{ad_account_id}/aggregate_reports","method":"get","label":"Get Aggregate Report by Ad Account ID","operationId":"getAggregateReport"},{"tags":["reports"],"path":"/ad_accounts/{ad_account_id}/insight_reports","method":"get","label":"Get Insight Report by Ad Account ID","operationId":"getAudienceInsightReport"},{"tags":["reports"],"path":"/ad_accounts/{ad_account_id}/async_reports","method":"post","label":"Create a CSV Report Asynchronously","operationId":"createAsyncReport"},{"tags":["reports"],"path":"/ad_accounts/{ad_account_id}/async_reports/{report_id}","method":"get","label":"Get CSV Report Status by ID","operationId":"getAsyncReport"},{"tags":["targets"],"path":"/targets/artists","method":"get","label":"Get Artist Targets","operationId":"getArtistTargets"},{"tags":["targets"],"path":"/targets/genres","method":"get","label":"Get Genre Targets","operationId":"getGenreTargets"},{"tags":["targets"],"path":"/targets/geos","method":"get","label":"Get Geo Targets","operationId":"getGeoTargets"},{"tags":["targets"],"path":"/targets/interests","method":"get","label":"Get Interest Targets","operationId":"getInterestTargets"},{"tags":["targets"],"path":"/targets/languages","method":"get","label":"Get Language Targets","operationId":"getLanguageTargets"},{"tags":["targets"],"path":"/targets/playlists","method":"get","label":"Get Playlist Targets","operationId":"getPlaylistTargets"},{"tags":["targets"],"path":"/targets/episode_topics","method":"get","label":"Get Podcast Episode Topic Targets","operationId":"getEpisodeTopicTargets"},{"tags":["targets"],"path":"/targets/sensitive_topics","method":"get","label":"Get Sensitive Topic Targets","operationId":"getSensitiveTopicTargets"}],"v2.0":[{"tags":["ad-accounts"],"path":"/ad_accounts","method":"get","label":"Get Ad Accounts for Current User","operationId":"getAdAccounts"},{"tags":["ad-accounts"],"path":"/ad_accounts/{ad_account_id}","method":"get","label":"Get an Ad Account by ID","operationId":"getAdAccount"},{"tags":["ad-categories"],"path":"/ad_categories","method":"get","label":"Get Ad Categories","operationId":"getAdCategories"},{"tags":["ad-sets"],"path":"/ad_accounts/{ad_account_id}/ad_sets/{ad_set_id}","method":"get","label":"Get Ad Set by ID","operationId":"getAdSetById"},{"tags":["ad-sets"],"path":"/ad_accounts/{ad_account_id}/ad_sets/{ad_set_id}","method":"patch","label":"Update Ad Set","operationId":"updateAdSet"},{"tags":["ad-sets"],"path":"/ad_accounts/{ad_account_id}/ad_sets","method":"get","label":"Get Ad Sets by Ad Account ID","operationId":"getAdSetsByAdAccountId"},{"tags":["ad-sets"],"path":"/ad_accounts/{ad_account_id}/ad_sets","method":"post","label":"Create an Ad Set","operationId":"createAdSet"},{"tags":["ads"],"path":"/ad_accounts/{ad_account_id}/ads","method":"get","label":"Get Ads by Ad Account ID","operationId":"getAds"},{"tags":["ads"],"path":"/ad_accounts/{ad_account_id}/ads","method":"post","label":"Create an Ad","operationId":"createAd"},{"tags":["ads"],"path":"/ad_accounts/{ad_account_id}/ads/{ad_id}","method":"get","label":"Get Ad by ID","operationId":"getAd"},{"tags":["ads"],"path":"/ad_accounts/{ad_account_id}/ads/{ad_id}","method":"patch","label":"Update an Ad","operationId":"updateAd"},{"tags":["assets"],"path":"/ad_accounts/{ad_account_id}/assets","method":"get","label":"Get Assets by Ad Account","operationId":"getAssetsByTypeAndAdAccount"},{"tags":["assets"],"path":"/ad_accounts/{ad_account_id}/assets","method":"post","label":"Create Asset","operationId":"createAsset"},{"tags":["assets"],"path":"/ad_accounts/{ad_account_id}/assets/{asset_id}","method":"get","label":"Get Asset by ID","operationId":"getAsset"},{"tags":["assets"],"path":"/ad_accounts/{ad_account_id}/assets/{asset_id}","method":"patch","label":"Update Asset","operationId":"updateAsset"},{"tags":["assets"],"path":"/ad_accounts/{ad_account_id}/assets/{asset_id}/upload","method":"post","label":"Upload Asset","operationId":"uploadAsset"},{"tags":["assets"],"path":"/ad_accounts/{ad_account_id}/assets/{asset_id}/chunked_upload/start","method":"post","label":"Start Upload Chunked Asset","operationId":"startUploadChunkedAsset"},{"tags":["assets"],"path":"/ad_accounts/{ad_account_id}/assets/{asset_id}/chunked_upload/transfer","method":"post","label":"Transfer Chunked Asset","operationId":"transferChunkedAsset"},{"tags":["assets"],"path":"/ad_accounts/{ad_account_id}/assets/{asset_id}/chunked_upload/complete","method":"post","label":"Complete Upload Chunked Asset","operationId":"completeUploadChunkedAsset"},{"tags":["campaigns"],"path":"/ad_accounts/{ad_account_id}/campaigns","method":"get","label":"Get Campaigns by Ad Account ID","operationId":"getCampaigns"},{"tags":["campaigns"],"path":"/ad_accounts/{ad_account_id}/campaigns","method":"post","label":"Create a Campaign","operationId":"createCampaign"},{"tags":["campaigns"],"path":"/ad_accounts/{ad_account_id}/campaigns/{campaign_id}","method":"get","label":"Get Campaign by ID","operationId":"getCampaign"},{"tags":["campaigns"],"path":"/ad_accounts/{ad_account_id}/campaigns/{campaign_id}","method":"patch","label":"Update a Campaign","operationId":"updateCampaign"},{"tags":["estimates"],"path":"/estimates/audience","method":"post","label":"Estimate audience","operationId":"estimateAudience"},{"tags":["estimates"],"path":"/estimates/bid","method":"post","label":"Estimate bid","operationId":"estimateBid"},{"tags":["podcast-shows"],"path":"/podcast_shows","method":"get","label":"Get Podcast Shows","operationId":"getPodcastShows"},{"tags":["reports"],"path":"/ad_accounts/{ad_account_id}/aggregate_reports","method":"get","label":"Get Aggregate Report by Ad Account ID","operationId":"getAggregateReport"},{"tags":["reports"],"path":"/ad_accounts/{ad_account_id}/insight_reports","method":"get","label":"Get Insight Report by Ad Account ID","operationId":"getAudienceInsightReport"},{"tags":["reports"],"path":"/ad_accounts/{ad_account_id}/async_reports","method":"post","label":"Create a CSV Report Asynchronously","operationId":"createAsyncReport"},{"tags":["reports"],"path":"/ad_accounts/{ad_account_id}/async_reports/{report_id}","method":"get","label":"Get CSV Report Status by ID","operationId":"getAsyncReport"},{"tags":["targets"],"path":"/targets/artists","method":"get","label":"Get Artist Targets","operationId":"getArtistTargets"},{"tags":["targets"],"path":"/targets/genres","method":"get","label":"Get Genre Targets","operationId":"getGenreTargets"},{"tags":["targets"],"path":"/targets/geos","method":"get","label":"Get Geo Targets","operationId":"getGeoTargets"},{"tags":["targets"],"path":"/targets/interests","method":"get","label":"Get Interest Targets","operationId":"getInterestTargets"},{"tags":["targets"],"path":"/targets/languages","method":"get","label":"Get Language Targets","operationId":"getLanguageTargets"},{"tags":["targets"],"path":"/targets/playlists","method":"get","label":"Get Playlist Targets","operationId":"getPlaylistTargets"},{"tags":["targets"],"path":"/targets/episode_topics","method":"get","label":"Get Podcast Episode Topic Targets","operationId":"getEpisodeTopicTargets"},{"tags":["targets"],"path":"/targets/sensitive_topics","method":"get","label":"Get Sensitive Topic Targets","operationId":"getSensitiveTopicTargets"}]},"padded":false},"__N_SSG":true},"page":"/documentation/ads-api/[...mdx]","query":{"mdx":["guides"]},"buildId":"r3rwF3wRfylFAVhtsmTnH","assetPrefix":"https://developer-assets.spotifycdn.com","isFallback":false,"gsp":true,"appGip":true,"scriptLoader":[]}</script></body></html>

CINXE.COM

Ads API Guides | Spotify for Developers