CINXE.COM
Twitter Ads API Documentation | Docs | Twitter Developer Platform
<!DOCTYPE html> <html lang="en" dir="ltr" prefix="og: http://ogp.me/ns#" data-behavior="i18n" data-environment="prod" data-server-mode="publish" data-dc="p" class=" twtr-type--chirp"> <head><script type="text/javascript" src="/_static/js/bundle-playback.js?v=HxkREWBo" charset="utf-8"></script> <script type="text/javascript" src="/_static/js/wombat.js?v=txqj7nKC" charset="utf-8"></script> <script>window.RufflePlayer=window.RufflePlayer||{};window.RufflePlayer.config={"autoplay":"on","unmuteOverlay":"hidden"};</script> <script type="text/javascript" src="/_static/js/ruffle/ruffle.js"></script> <script type="text/javascript"> __wm.init("https://web.archive.org/web"); __wm.wombat("https://developer.twitter.com/en/docs/twitter-ads-api","20230902233124","https://web.archive.org/","web","/_static/", "1693697484"); </script> <link rel="stylesheet" type="text/css" href="/_static/css/banner-styles.css?v=S1zqJCYt" /> <link rel="stylesheet" type="text/css" href="/_static/css/iconochive.css?v=3PDvdIFv" /> <!-- End Wayback Rewrite JS Include --> <meta charset="utf-8"/> <meta name="viewport" content="width=device-width, initial-scale=1"/> <title>Twitter Ads API Documentation | Docs | Twitter Developer Platform </title> <meta name="description"/> <link rel="canonical" href="https://web.archive.org/web/20230902233124/https://developer.twitter.com/en/docs/twitter-ads-api"/> <meta property="og:url" content="https://web.archive.org/web/20230902233124/https://developer.twitter.com/en/docs/twitter-ads-api"/> <meta property="og:type" content="article"/> <meta property="og:title" content="Twitter Ads API Documentation"/> <meta property="og:image" content="https://web.archive.org/web/20230902233124im_/https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/redesign-2021-images/og-social-card/devwebsite_card_tn.jpg.twimg.768.jpg"/> <meta name="keywords"/> <meta name="twitter:card" content="summary_large_image"/> <link rel="alternate" hreflang="ja" href="https://web.archive.org/web/20230902233124/https://developer.twitter.com/ja/docs/twitter-ads-api"/> <link rel="alternate" hreflang="zh-cn" href="https://web.archive.org/web/20230902233124/https://developer.twitter.com/zh-cn/docs/twitter-ads-api"/> <link rel="alternate" hreflang="de" href="https://web.archive.org/web/20230902233124/https://developer.twitter.com/de/docs/twitter-ads-api.html"/> <link rel="alternate" hreflang="en1" href="https://web.archive.org/web/20230902233124/https://developer.twitter.com/en1/docs/twitter-ads-api.html"/> <meta name="twitter:widgets:new-embed-design" content="on"/> <meta name="twitter:widgets:csp" content="on"/> <link href="https://web.archive.org/web/20230902233124im_/https://abs.twimg.com/favicons/twitter-orange.3.ico" rel="shortcut icon" type="image/x-icon"/> <script type="application/json" id="analytics-settings">{"google":{"accounts":[],"options":{"displayAdvertisingFeatures":false}},"scribe":{"scribeSectionWithImpression":false},"trackingPixel":{},"bing":{}}</script> <script type="application/json" class="u14-data-layer" data-component="u14-data-layer" id="data-layer">{"page":{"pageId":"480367f","pageKey":"480367f-en-en","pageName":"Twitter Ads API Documentation","pagePath":"/content/developer-twitter/en/docs/twitter-ads-api","pageType":"documentation-page","pagePublishDate":"","language":"en","geoRegion":"en","category":{"tags":{"tagIDs":[],"tagNames":[]},"scribe":{"component":"twitter-ads-api","section":"docs","page":"developer","element":"page"}},"attribute":{}}}</script> <link rel="preload" href="https://web.archive.org/web/20230902233124/https://fonts.twitter.com/chirp/chirp-bold-italic-web.woff2" as="font" type="font/woff2" crossorigin/> <link rel="preload" href="https://web.archive.org/web/20230902233124/https://fonts.twitter.com/chirp/chirp-bold-web.woff2" as="font" type="font/woff2" crossorigin/> <link rel="preload" href="https://web.archive.org/web/20230902233124/https://fonts.twitter.com/chirp/chirp-display-extended-black-web.woff2" as="font" type="font/woff2" crossorigin/> <link rel="preload" href="https://web.archive.org/web/20230902233124/https://fonts.twitter.com/chirp/chirp-regular-web.woff2" as="font" type="font/woff2" crossorigin/> <link rel="preload" href="https://web.archive.org/web/20230902233124/https://fonts.twitter.com/chirp/chirp-regular-italic-web.woff2" as="font" type="font/woff2" crossorigin/> <link rel="preload" href="https://web.archive.org/web/20230902233124/https://fonts.twitter.com/chirp/chirp-extended-bold-web.woff2" as="font" type="font/woff2" crossorigin/> <script type="text/javascript" src="/web/20230902233124js_/https://developer.twitter.com/etc/clientlibs/dtm/developer-twitter/c411b4930511/eb5ca470897a/launch-c9524692def8.min.js.twhash.p.f.9fd5005da5b50e40a11908f2663697c4.js" async></script> <link rel="stylesheet" href="https://web.archive.org/web/20230902233124cs_/https://cdn.cms-twdigitalassets.com/etc/designs/developer2-twitter/public/css/chirp.css.twhash.p.f.41e1f29c2d4295d68b05db0725781db3.css" media="screen" type="text/css"/> <link rel="stylesheet" href="https://web.archive.org/web/20230902233124cs_/https://cdn.cms-twdigitalassets.com/etc/designs/developer2-twitter/public/css/legacy-colors.css.twhash.p.f.20fd26d638816cbce52d44904fc9c3c2.css" type="text/css"/> <link rel="stylesheet" href="https://web.archive.org/web/20230902233124cs_/https://cdn.cms-twdigitalassets.com/etc/designs/developer2-twitter/public/css/project.css.twhash.p.f.47f4d1c504f9a065310d7d9f47df66d7.css" media="screen" type="text/css"/> <link rel="stylesheet" href="https://web.archive.org/web/20230902233124cs_/https://cdn.cms-twdigitalassets.com/etc/designs/developer2-twitter/public/css/print.css.twhash.p.f.67de1c964d9398cbf614aab841910ad6.css" media="print" type="text/css"/> </head> <body class=" twtr-theme--blue page documentation-page page-- twtr-color-bg--white-neutral js-no-scroll atm-light " style="--theme-color: var(--blue-dark)" data-analytics-page="developer" data-analytics-section="docs" data-analytics-component="twitter-ads-api" data-analytics-element="page"> <div id="twtr-dtc-main" style="--nav-height: var(--navbar-tall)" data-dtc-rebrand-on="true" class="dtc-rebrand-flag-on"> <div id="twBearerToken" data-value="AAAAAAAAAAAAAAAAAAAAACHguwAAAAAAaSlT0G31NDEyg%2BSnBN5JuyKjMCU%3Dlhg0gv0nE7KKyiJNEAojQbn8Y3wJm1xidDK7VnKGBP4ByJwHPb" style="display:none"></div> <div id="twAuthenticationFlag" data-value="guest" style="display:none"></div> <div id="twGeoLocationRegion" data-value="other" style="display:none"></div> <div class="u01-meganav__page-padding"></div> <div class="u01-meganav js-twtr-nav twtr-color-bg--white-neutral is-fixed"> <div class="twtr-container--wide"> <div class="twtr-grid"> <div class="twtr-col-12"> <div class="u01-meganav__container" data-bg-color="white-neutral" data-home-path="/content/developer-twitter/en" data-icon-close="<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" viewbox="0 0 24 24" style="enable-background:new 0 0 24 24;" xml:space="preserve" aria-hidden="true" focusable="false" role="none" class="twtr-icon--md"> <g> <g> <defs> <rect id="SVGID_1_" x="-468" y="-1360" width="1440" height="3027" /> </defs> <clippath id="SVGID_2_"> <use xlink:href="#SVGID_1_" style="overflow:visible;" /> </clippath> </g> </g> <rect x="-468" y="-1360" class="st0" width="1440" height="3027" style="fill:rgb(0,0,0,0);stroke-width:3;stroke:rgb(0,0,0)" /> <path d="M13.4,12l5.8-5.8c0.4-0.4,0.4-1,0-1.4c-0.4-0.4-1-0.4-1.4,0L12,10.6L6.2,4.8c-0.4-0.4-1-0.4-1.4,0c-0.4,0.4-0.4,1,0,1.4 l5.8,5.8l-5.8,5.8c-0.4,0.4-0.4,1,0,1.4c0.2,0.2,0.4,0.3,0.7,0.3s0.5-0.1,0.7-0.3l5.8-5.8l5.8,5.8c0.2,0.2,0.5,0.3,0.7,0.3 s0.5-0.1,0.7-0.3c0.4-0.4,0.4-1,0-1.4L13.4,12z" /> </svg>" data-icon-chevron-right="<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewbox="0 0 24 24" aria-hidden="true" focusable="false" role="none" class="twtr-icon"> <path opacity="0" d="M0 0h24v24H0z" /> <path d="M17.207 11.293l-7.5-7.5c-.39-.39-1.023-.39-1.414 0s-.39 1.023 0 1.414L15.086 12l-6.793 6.793c-.39.39-.39 1.023 0 1.414.195.195.45.293.707.293s.512-.098.707-.293l7.5-7.5c.39-.39.39-1.023 0-1.414z" /> </svg>" data-icon-chevron-down="<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewbox="0 0 24 24" aria-hidden="true" focusable="false" role="none" class="twtr-icon"> <path opacity="0" d="M0 0h24v24H0z" /> <path d="M20.207 7.043c-.39-.39-1.023-.39-1.414 0L12 13.836 5.207 7.043c-.39-.39-1.023-.39-1.414 0s-.39 1.023 0 1.414l7.5 7.5c.195.195.45.293.707.293s.512-.098.707-.293l7.5-7.5c.39-.39.39-1.023 0-1.414z" /> </svg>" data-icon-arrow-left="<svg width="28px" height="28px" viewbox="0 0 28 28" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" focusable="false" role="none" class="twtr-icon u01-meganav__icon-arrow-left"> <g stroke="none" stroke-width="1" fill="none" fill-rule="evenodd" stroke-linecap="round"> <g transform="translate(-1216.000000, -298.000000)" stroke-width="2.25"> <g transform="translate(1200.000000, 282.000000)"> <g transform="translate(17.000000, 17.000000)"> <path d="M0.756410256,12.8589744 L25.7179487,12.8589744"></path> <path d="M13.2371795,25.3397436 L25.7179487,12.8589744"></path> <path d="M13.2371795,12.4807692 L25.3397436,0.378205128" transform="translate(19.288462, 6.429487) rotate(-90.000000) translate(-19.288462, -6.429487) "></path> </g> </g> </g> </g> </svg>" data-left-nav-items="[{"isActive":false,"hasActiveChild":false,"children":[{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Twitter API","linkDisabled":false,"title":"Twitter API","path":"https://developer.twitter.com/en/products/twitter-api"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Twitter Ads API","linkDisabled":false,"title":"Twitter Ads API","path":"https://developer.twitter.com/en/products/twitter-ads-api"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Twitter for websites","linkDisabled":false,"title":"Twitter for websites","path":"https://developer.twitter.com/en/products/twitter-for-websites"}],"overviewTitle":"Products","linkDisabled":true,"title":"Products","path":"https://developer.twitter.com/en/products"},{"isActive":false,"hasActiveChild":true,"children":[{"isActive":false,"hasActiveChild":false,"children":[{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Getting Started","linkDisabled":false,"title":"Getting Started","path":"https://developer.twitter.com/en/docs/platform-overview"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Tutorials","linkDisabled":false,"title":"Tutorials","path":"https://developer.twitter.com/en/docs/tutorials"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Github","linkDisabled":false,"title":"Github","path":"https://github.com/twitterdev"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"API reference index","linkDisabled":false,"title":"API reference index","path":"https://developer.twitter.com/en/docs/api-reference-index"}],"linkDisabled":true,"title":"Resources","path":"https://developer.twitter.com/.html"},{"isActive":false,"hasActiveChild":false,"children":[{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Twitter API home","linkDisabled":false,"title":"Twitter API home","path":"https://developer.twitter.com/en/docs/twitter-api"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Twitter API getting started","linkDisabled":false,"title":"Twitter API getting started","path":"https://developer.twitter.com/en/docs/twitter-api/getting-started/about-twitter-api"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"SDKs","linkDisabled":false,"title":"SDKs","path":"https://developer.twitter.com/en/docs/twitter-api/tools-and-libraries/sdks/overview"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Tools and Libraries","linkDisabled":false,"title":"Tools and Libraries","path":"https://developer.twitter.com/en/docs/twitter-api/tools-and-libraries/v2"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"v2 migration","linkDisabled":false,"title":"v2 migration","path":"https://developer.twitter.com/en/docs/twitter-api/migrate/twitter-api-endpoint-map"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Enterprise APIs","linkDisabled":false,"title":"Enterprise APIs","path":"https://developer.twitter.com/en/docs/twitter-api/enterprise"}],"linkDisabled":true,"title":"Twitter Api","path":"https://developer.twitter.com/.html"},{"isActive":false,"hasActiveChild":true,"children":[{"isActive":true,"hasActiveChild":false,"children":[],"overviewTitle":"Twitter Ads API home","linkDisabled":false,"title":"Twitter Ads API home","path":"https://developer.twitter.com/en/docs/twitter-ads-api"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Twitter Ads API getting started","linkDisabled":false,"title":"Twitter Ads API getting started","path":"https://developer.twitter.com/en/docs/twitter-ads-api/getting-started"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Apply for access","linkDisabled":false,"title":"Apply for access","path":"https://developer.twitter.com/en/docs/twitter-ads-api/apply.html"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Tools and libraries","linkDisabled":false,"title":"Tools and libraries","path":"https://developer.twitter.com/en/docs/twitter-ads-api/tools-and-libraries"}],"linkDisabled":true,"title":"Twitter Ads API","path":"https://developer.twitter.com/.html"},{"isActive":false,"hasActiveChild":false,"children":[{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Twitter for Websites home","linkDisabled":false,"title":"Twitter for Websites home","path":"https://developer.twitter.com/en/docs/twitter-for-websites"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Embedded Tweets","linkDisabled":false,"title":"Embedded Tweets","path":"https://developer.twitter.com/en/docs/twitter-for-websites/embedded-tweets/overview"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Embedded Timelines","linkDisabled":false,"title":"Embedded Timelines","path":"https://developer.twitter.com/en/docs/twitter-for-websites/timelines/overview"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Embedded buttons","linkDisabled":false,"title":"Embedded buttons","path":"https://developer.twitter.com/en/docs/twitter-for-websites/tweet-button/overview"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Web intents","linkDisabled":false,"title":"Web intents","path":"https://developer.twitter.com/en/docs/twitter-for-websites/web-intents/overview"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Twitter cards","linkDisabled":false,"title":"Twitter cards","path":"https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/abouts-cards"}],"linkDisabled":true,"title":"Twitter for Websites","path":"https://developer.twitter.com/.html"}],"overviewTitle":"Docs","linkDisabled":false,"menuType":"multiCategory","title":"Docs","path":"https://developer.twitter.com/en/docs"},{"isActive":false,"hasActiveChild":false,"children":[{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Build for business","linkDisabled":false,"title":"Build for business","path":"https://developer.twitter.com/en/use-cases/build-for-businesses"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Build for the public","linkDisabled":false,"title":"Build for the public","path":"https://developer.twitter.com/en/use-cases/build-for-consumers"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Do research","linkDisabled":false,"title":"Do research","path":"https://developer.twitter.com/en/use-cases/do-research"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Teach \u0026 learn","linkDisabled":false,"title":"Teach \u0026 learn","path":"https://developer.twitter.com/en/use-cases/teach-and-learn"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Build for good","linkDisabled":false,"title":"Build for good","path":"https://developer.twitter.com/en/use-cases/build-for-good"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Build for fun","linkDisabled":false,"title":"Build for fun","path":"https://developer.twitter.com/en/use-cases/build-for-fun"}],"overviewTitle":"Use Cases","linkDisabled":true,"title":"Use Cases","path":"https://developer.twitter.com/en/navigation/left-nav-items/use-cases"},{"isActive":false,"hasActiveChild":false,"children":[{"isActive":false,"hasActiveChild":false,"children":[{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Changelog","linkDisabled":false,"title":"Changelog","path":"https://developer.twitter.com/en/updates/changelog"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Blog","linkDisabled":false,"title":"Blog","path":"https://developer.twitter.com/en/blog"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Newsletter","linkDisabled":false,"title":"Newsletter","path":"https://developer.twitter.com/en/updates/stay-informed"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"YouTube","linkDisabled":false,"title":"YouTube","path":"https://www.youtube.com/c/twitterdev"}],"linkDisabled":true,"title":"Stay informed","path":"https://developer.twitter.com/.html"},{"isActive":false,"hasActiveChild":false,"children":[{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Forums","linkDisabled":false,"title":"Forums","path":"https://twittercommunity.com/"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Events","linkDisabled":false,"title":"Events","path":"https://twitterdev.bevylabs.com/"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Insiders","linkDisabled":false,"title":"Insiders","path":"https://developer.twitter.com/en/community/insiders"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Community leaders","linkDisabled":false,"title":"Community leaders","path":"https://developer.twitter.com/en/community/leaders"}],"linkDisabled":true,"title":"Connect","path":"https://developer.twitter.com/.html"}],"overviewTitle":"Community","linkDisabled":false,"menuType":"multiCategory","title":"Community","path":"https://developer.twitter.com/en/community"}]" data-right-nav-items="[{"isActive":false,"hasActiveChild":false,"children":[{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Policies","linkDisabled":false,"title":"Policies","path":"https://developer.twitter.com/en/developer-terms"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Developer agreement","linkDisabled":false,"title":"Developer agreement","path":"https://developer.twitter.com/en/developer-terms/agreement-and-policy/source"}],"overviewTitle":"Support","linkDisabled":false,"title":"Support","path":"https://developer.twitter.com/en/support"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Developer Portal","linkDisabled":false,"title":"Developer Portal","path":"https://developer.twitter.com/en/portal/petition/essential/basic-info"}]" data-cta-enabled="true" data-profile-enabled="true" data-cta-link-new-tab="false" data-root-page-title="Developer Platform"> </div> <div aria-label="Search" class="u01-meganav__search-modal twtr-color-bg--blue-dark" role="dialog" aria-modal="true"> <button aria-label="Close search menu" class="u04-search__close-button js-close-search" type="button"> <svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" viewbox="0 0 24 24" style="enable-background:new 0 0 24 24;" xml:space="preserve" aria-hidden="true" focusable="false" role="none" class="u04-search__close-svg twtr-icon"> <g> <g> <defs> <rect id="SVGID_1_" x="-468" y="-1360" width="1440" height="3027"/> </defs> <clippath id="SVGID_2_"> <use xlink:href="/web/20230902233124im_/https://developer.twitter.com/en/docs/twitter-ads-api#SVGID_1_" style="overflow:visible;"/> </clippath> </g> </g> <rect x="-468" y="-1360" class="st0" width="1440" height="3027" style="fill:rgb(0,0,0,0);stroke-width:3;stroke:rgb(0,0,0)"/> <path d="M13.4,12l5.8-5.8c0.4-0.4,0.4-1,0-1.4c-0.4-0.4-1-0.4-1.4,0L12,10.6L6.2,4.8c-0.4-0.4-1-0.4-1.4,0c-0.4,0.4-0.4,1,0,1.4 l5.8,5.8l-5.8,5.8c-0.4,0.4-0.4,1,0,1.4c0.2,0.2,0.4,0.3,0.7,0.3s0.5-0.1,0.7-0.3l5.8-5.8l5.8,5.8c0.2,0.2,0.5,0.3,0.7,0.3 s0.5-0.1,0.7-0.3c0.4-0.4,0.4-1,0-1.4L13.4,12z"/> </svg> </button> <div class="search-bar search-bar--js" data-theme="blue" data-search-path="https://developer.twitter.com/en/search-results.html"> <input placeholder="Type your search here" type="search" autocomplete="off" class="search-bar__input" name="q"/> <button id="u04-search__button" class="u04-search__button" aria-label="Search"> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewbox="0 0 24 24" aria-hidden="true" focusable="false" role="none" class="u04-search__button-icon twtr-icon--mega twtr-color-fill--white-neutral"> <path opacity="0" d="M0 0h24v24H0z"/> <path d="M22.06 19.94l-3.73-3.73C19.38 14.737 20 12.942 20 11c0-4.97-4.03-9-9-9s-9 4.03-9 9 4.03 9 9 9c1.943 0 3.738-.622 5.21-1.67l3.73 3.73c.292.294.676.44 1.06.44s.768-.146 1.06-.44c.586-.585.586-1.535 0-2.12zM11 17c-3.308 0-6-2.692-6-6s2.692-6 6-6 6 2.692 6 6-2.692 6-6 6z"/> </svg> </button> </div> </div> </div> </div> </div> </div> <main class="twtr-color-bg--white-neutral" id="twtr-main"> <div class="page-wrapper documentation-page twtr-color-bg--white-neutral"> <div class="u07 is-hidden" aria-hidden="true"> <div class="u07__item u07__bg-color--neutral"> <div class="u07__item-content"> <div class="u07__notification twtr-type--bold-200 chirp--bold-200 twtr-color--gray-900"> </div> <div class="u07__close"> <button type="button" class="u07__close-btn"> <svg xmlns="http://www.w3.org/2000/svg" width="46" height="72" viewbox="0 0 46 72" aria-hidden="true" focusable="false" role="none" class="twtr-icon"> <path d="M27.243 36l14.879-14.879a2.998 2.998 0 0 0 0-4.242 2.998 2.998 0 0 0-4.242 0L23 31.758 8.122 16.879a2.998 2.998 0 0 0-4.242 0 2.998 2.998 0 0 0 0 4.242L18.758 36 3.879 50.879A2.998 2.998 0 0 0 6.001 56a2.99 2.99 0 0 0 2.121-.879L23 40.242l14.879 14.879A2.991 2.991 0 0 0 40 56a2.998 2.998 0 0 0 2.121-5.121L27.243 36z"/> </svg> </button> </div> </div> </div> </div> <div class="page-content twtr-container-wide left-rail-container"> <div class="sidebar-content docs-side-nav"> <div class="sidebar-content__wrapper"> <span class="docs-side-nav__close"> <svg xmlns="http://www.w3.org/2000/svg" width="46" height="72" viewbox="0 0 46 72" aria-hidden="true" focusable="false"> <path d="M27.243 36l14.879-14.879a2.998 2.998 0 0 0 0-4.242 2.998 2.998 0 0 0-4.242 0L23 31.758 8.122 16.879a2.998 2.998 0 0 0-4.242 0 2.998 2.998 0 0 0 0 4.242L18.758 36 3.879 50.879A2.998 2.998 0 0 0 6.001 56a2.99 2.99 0 0 0 2.121-.879L23 40.242l14.879 14.879A2.991 2.991 0 0 0 40 56a2.998 2.998 0 0 0 2.121-5.121L27.243 36z"> </path> </svg> </span> <div class="d08-navigation-sidebar" data-sidenav-json="{"navigationTitle":"Documentation","rootPageUrl":"/content/developer-twitter/en/docs.html","navigationGroups":[{"groupName":"","navItems":[{"title":"Getting started","url":"/content/developer-twitter/en/docs/platform-overview"},{"childNavItems":[{"title":"Developer Apps","url":"/content/developer-twitter/en/docs/apps"},{"title":"Projects","url":"/content/developer-twitter/en/docs/projects"},{"title":"Developer portal","url":"/content/developer-twitter/en/docs/developer-portal"},{"title":"Authentication","url":"/content/developer-twitter/en/docs/authentication"},{"title":"Counting characters","url":"/content/developer-twitter/en/docs/counting-characters"},{"title":"Rate limits","url":"/content/developer-twitter/en/docs/rate-limits"},{"title":"Twitter IDs","url":"/content/developer-twitter/en/docs/twitter-ids"},{"title":"Security","url":"/content/developer-twitter/en/docs/security"}],"title":"Fundamentals","url":"#"},{"title":"Tools and libraries","url":"/content/developer-twitter/en/docs/tools-and-libraries"},{"title":"Tutorials","url":"/content/developer-twitter/en/docs/tutorials"},{"title":"API reference index","url":"/content/developer-twitter/en/docs/api-reference-index"}],"groupUrl":"#"},{"groupName":"Twitter API","navItems":[{"childNavItems":[{"title":"About the Twitter API","url":"/content/developer-twitter/en/docs/twitter-api/getting-started/about-twitter-api"},{"title":"Getting access","url":"/content/developer-twitter/en/docs/twitter-api/getting-started/getting-access-to-the-twitter-api"},{"title":"Make your first request","url":"/content/developer-twitter/en/docs/twitter-api/getting-started/make-your-first-request"},{"title":"Important resources","url":"/content/developer-twitter/en/docs/twitter-api/getting-started/important-resources"}],"title":"Getting started","url":"#"},{"childNavItems":[{"title":"SDKs","url":"/content/developer-twitter/en/docs/twitter-api/tools-and-libraries/sdks"}],"title":"Tools and libraries","url":"/content/developer-twitter/en/docs/twitter-api/tools-and-libraries"},{"title":"What to build","url":"/content/developer-twitter/en/docs/twitter-api/what-to-build"},{"childNavItems":[{"title":"Overview","url":"/content/developer-twitter/en/docs/twitter-api/migrate/overview"},{"title":"Data format migration","url":"/content/developer-twitter/en/docs/twitter-api/migrate/data-formats"},{"title":"Twitter API endpoint map","url":"/content/developer-twitter/en/docs/twitter-api/migrate/twitter-api-endpoint-map"}],"title":"Migrate","url":"/content/developer-twitter/en/docs/twitter-api/migrate"},{"childNavItems":[{"grandChildNavItems":[{"title":"Data dictionary","url":"/content/developer-twitter/en/docs/twitter-api/data-dictionary"},{"title":"Fields","url":"/content/developer-twitter/en/docs/twitter-api/fields"},{"title":"Expansions","url":"/content/developer-twitter/en/docs/twitter-api/expansions"},{"title":"Tweet annotations","url":"/content/developer-twitter/en/docs/twitter-api/annotations"},{"title":"Metrics","url":"/content/developer-twitter/en/docs/twitter-api/metrics"},{"title":"Conversation ID","url":"/content/developer-twitter/en/docs/twitter-api/conversation-id"},{"title":"Pagination","url":"/content/developer-twitter/en/docs/twitter-api/pagination"},{"title":"Versioning","url":"/content/developer-twitter/en/docs/twitter-api/versioning"},{"title":"Consistency","url":"/content/developer-twitter/en/docs/twitter-api/consistency"},{"title":"Rate limits","url":"/content/developer-twitter/en/docs/twitter-api/rate-limits"},{"title":"Tweet cap","url":"/content/developer-twitter/en/docs/twitter-api/tweet-caps"},{"title":"Edit Tweets","url":"/content/developer-twitter/en/docs/twitter-api/edit-tweets"}],"title":"Fundamentals","url":"#"},{"grandChildNavItems":[{"title":"Tweets lookup","url":"/content/developer-twitter/en/docs/twitter-api/tweets/lookup"},{"title":"Manage Tweets","url":"/content/developer-twitter/en/docs/twitter-api/tweets/manage-tweets"},{"title":"Timelines","url":"/content/developer-twitter/en/docs/twitter-api/tweets/timelines"},{"title":"Search Tweets","url":"/content/developer-twitter/en/docs/twitter-api/tweets/search"},{"title":"Tweet counts","url":"/content/developer-twitter/en/docs/twitter-api/tweets/counts"},{"title":"Filtered stream","url":"/content/developer-twitter/en/docs/twitter-api/tweets/filtered-stream"},{"title":"Volume streams","url":"/content/developer-twitter/en/docs/twitter-api/tweets/volume-streams"},{"title":"Retweets","url":"/content/developer-twitter/en/docs/twitter-api/tweets/retweets"},{"title":"Quote Tweets","url":"/content/developer-twitter/en/docs/twitter-api/tweets/quote-tweets"},{"title":"Likes","url":"/content/developer-twitter/en/docs/twitter-api/tweets/likes"},{"title":"Bookmarks","url":"/content/developer-twitter/en/docs/twitter-api/tweets/bookmarks"},{"title":"Hide replies","url":"/content/developer-twitter/en/docs/twitter-api/tweets/hide-replies"},{"title":"COVID-19 stream","url":"/content/developer-twitter/en/docs/twitter-api/tweets/covid-19-stream"}],"title":"Tweets","url":"#"},{"grandChildNavItems":[{"title":"Users lookup","url":"/content/developer-twitter/en/docs/twitter-api/users/lookup"},{"title":"Follows","url":"/content/developer-twitter/en/docs/twitter-api/users/follows"},{"title":"Blocks","url":"/content/developer-twitter/en/docs/twitter-api/users/blocks"},{"title":"Mutes","url":"/content/developer-twitter/en/docs/twitter-api/users/mutes"}],"title":"Users","url":"#"},{"grandChildNavItems":[{"title":"Overview","url":"/content/developer-twitter/en/docs/twitter-api/spaces/overview"},{"title":"Spaces lookup","url":"/content/developer-twitter/en/docs/twitter-api/spaces/lookup"},{"title":"Search Spaces","url":"/content/developer-twitter/en/docs/twitter-api/spaces/search"}],"title":"Spaces","url":"#"},{"grandChildNavItems":[{"title":"Direct Messages lookup","url":"/content/developer-twitter/en/docs/twitter-api/direct-messages/lookup"},{"title":"Manage Direct Messages","url":"/content/developer-twitter/en/docs/twitter-api/direct-messages/manage"}],"title":"Direct Messages","url":"#"},{"grandChildNavItems":[{"title":"Lists lookup","url":"/content/developer-twitter/en/docs/twitter-api/lists/list-lookup"},{"title":"Manage lists","url":"/content/developer-twitter/en/docs/twitter-api/lists/manage-lists"},{"title":"List Tweets lookup","url":"/content/developer-twitter/en/docs/twitter-api/lists/list-tweets"},{"title":"List members","url":"/content/developer-twitter/en/docs/twitter-api/lists/list-members"},{"title":"Pinned Lists","url":"/content/developer-twitter/en/docs/twitter-api/lists/pinned-lists"}],"title":"Lists","url":"#"},{"grandChildNavItems":[{"title":"Batch compliance","url":"/content/developer-twitter/en/docs/twitter-api/compliance/batch-compliance/"},{"title":"Compliance streams","url":"/content/developer-twitter/en/docs/twitter-api/compliance/streams/"}],"title":"Compliance","url":"#"}],"title":"Twitter API v2","url":""},{"childNavItems":[{"grandChildNavItems":[{"title":"Gnip Console","url":"/content/developer-twitter/en/docs/twitter-api/enterprise/console"},{"title":"Data dictionary","url":"/content/developer-twitter/en/docs/twitter-api/enterprise/data-dictionary"},{"title":"Data enrichments","url":"/content/developer-twitter/en/docs/twitter-api/enterprise/enrichments"},{"title":"Rules and filtering","url":"/content/developer-twitter/en/docs/twitter-api/enterprise/rules-and-filtering"},{"title":"Rate limits","url":"/content/developer-twitter/en/docs/twitter-api/enterprise/rate-limits"},{"title":"Edit Tweets","url":"/content/developer-twitter/en/docs/twitter-api/enterprise/edit-tweets"}],"title":"Fundamentals","url":"#"},{"title":"PowerTrack API","url":"/content/developer-twitter/en/docs/twitter-api/enterprise/powertrack-api"},{"title":"Decahose API","url":"/content/developer-twitter/en/docs/twitter-api/enterprise/decahose-api"},{"title":"Account Activity API","url":"/content/developer-twitter/en/docs/twitter-api/enterprise/account-activity-api"},{"title":"Search API","url":"/content/developer-twitter/en/docs/twitter-api/enterprise/search-api"},{"title":"Engagement API","url":"/content/developer-twitter/en/docs/twitter-api/enterprise/engagement-api"},{"title":"Compliance Firehose API","url":"/content/developer-twitter/en/docs/twitter-api/enterprise/compliance-firehose-api"},{"title":"Usage API","url":"/content/developer-twitter/en/docs/twitter-api/enterprise/usage-api"}],"calloutLabel":"Gnip 2.0","title":"Enterprise - Gnip 2.0","url":"/content/developer-twitter/en/docs/twitter-api/enterprise"},{"childNavItems":[{"grandChildNavItems":[{"title":"Data dictionary","url":"/content/developer-twitter/en/docs/twitter-api/premium/data-dictionary"},{"title":"Data enrichments","url":"/content/developer-twitter/en/docs/twitter-api/premium/enrichments"},{"title":"Rules and filtering","url":"/content/developer-twitter/en/docs/twitter-api/premium/rules-and-filtering"},{"title":"Rate limits","url":"/content/developer-twitter/en/docs/twitter-api/premium/rate-limits"},{"title":"Edit Tweets","url":"/content/developer-twitter/en/docs/twitter-api/premium/edit-tweets"}],"title":"Fundamentals","url":"#"},{"title":"Search API","url":"/content/developer-twitter/en/docs/twitter-api/premium/search-api"},{"title":"Account Activity API","url":"/content/developer-twitter/en/docs/twitter-api/premium/account-activity-api"}],"calloutLabel":"v1.1","title":"Premium v1.1","url":"/content/developer-twitter/en/docs/twitter-api/premium"},{"childNavItems":[{"grandChildNavItems":[{"title":"Data dictionary","url":"/content/developer-twitter/en/docs/twitter-api/v1/data-dictionary"},{"title":"Rate limits","url":"/content/developer-twitter/en/docs/twitter-api/v1/rate-limits"},{"title":"Edit Tweets","url":"/content/developer-twitter/en/docs/twitter-api/v1/edit-tweets"}],"title":"Fundamentals","url":"#"},{"grandChildNavItems":[{"title":"Search Tweets","url":"/content/developer-twitter/en/docs/twitter-api/v1/tweets/search"},{"title":"Post, retrieve, and engage with Tweets","url":"/content/developer-twitter/en/docs/twitter-api/v1/tweets/post-and-engage"},{"title":"Get Tweet timelines","url":"/content/developer-twitter/en/docs/twitter-api/v1/tweets/timelines"},{"title":"Filter realtime Tweets","url":"/content/developer-twitter/en/docs/twitter-api/v1/tweets/filter-realtime"},{"title":"Sample realtime Tweets","url":"/content/developer-twitter/en/docs/twitter-api/v1/tweets/sample-realtime"},{"title":"Curate a collection of Tweets","url":"/content/developer-twitter/en/docs/twitter-api/v1/tweets/curate-a-collection"}],"title":"Tweets","url":"#"},{"grandChildNavItems":[{"title":"Manage account settings and profile","url":"/content/developer-twitter/en/docs/twitter-api/v1/accounts-and-users/manage-account-settings"},{"title":"Mute, block, and report users","url":"/content/developer-twitter/en/docs/twitter-api/v1/accounts-and-users/mute-block-report-users"},{"title":"Follow, search, and get users","url":"/content/developer-twitter/en/docs/twitter-api/v1/accounts-and-users/follow-search-get-users"},{"title":"Create and manage lists","url":"/content/developer-twitter/en/docs/twitter-api/v1/accounts-and-users/create-manage-lists"},{"title":"User profile images and banners","url":"/content/developer-twitter/en/docs/twitter-api/v1/accounts-and-users/user-profile-images-and-banners"}],"title":"Users","url":"#"},{"grandChildNavItems":[{"title":"Direct Message features","url":"/content/developer-twitter/en/docs/twitter-api/v1/direct-messages/api-features"},{"title":"Sending and receiving events","url":"/content/developer-twitter/en/docs/twitter-api/v1/direct-messages/sending-and-receiving"},{"title":"Welcome messages","url":"/content/developer-twitter/en/docs/twitter-api/v1/direct-messages/welcome-messages"},{"title":"Message attachments","url":"/content/developer-twitter/en/docs/twitter-api/v1/direct-messages/message-attachments"},{"title":"Quick replies","url":"/content/developer-twitter/en/docs/twitter-api/v1/direct-messages/quick-replies"},{"title":"Buttons","url":"/content/developer-twitter/en/docs/twitter-api/v1/direct-messages/buttons"},{"title":"Typing indicators and read receipts","url":"/content/developer-twitter/en/docs/twitter-api/v1/direct-messages/typing-indicator-and-read-receipts"},{"title":"Conversation management","url":"/content/developer-twitter/en/docs/twitter-api/v1/direct-messages/conversation-management"},{"title":"Custom profiles","url":"/content/developer-twitter/en/docs/twitter-api/v1/direct-messages/custom-profiles"},{"title":"Customer feedback cards","url":"/content/developer-twitter/en/docs/twitter-api/v1/direct-messages/customer-feedback"}],"title":"Direct Messages","url":"#"},{"grandChildNavItems":[{"title":"Upload media","url":"/content/developer-twitter/en/docs/twitter-api/v1/media/upload-media"}],"title":"Media","url":"#"},{"grandChildNavItems":[{"title":"Get trends near a location","url":"/content/developer-twitter/en/docs/twitter-api/v1/trends/trends-for-location"},{"title":"Get locations with trending topics","url":"/content/developer-twitter/en/docs/twitter-api/v1/trends/locations-with-trending-topics"}],"title":"Trends","url":"#"},{"grandChildNavItems":[{"title":"Get information about a place","url":"/content/developer-twitter/en/docs/twitter-api/v1/geo/place-information"},{"title":"Get places near a location","url":"/content/developer-twitter/en/docs/twitter-api/v1/geo/places-near-location"}],"title":"Geo","url":"#"},{"grandChildNavItems":[{"title":"Get app rate limit status","url":"/content/developer-twitter/en/docs/twitter-api/v1/developer-utilities/rate-limit-status"},{"title":"Get Twitter supported languages","url":"/content/developer-twitter/en/docs/twitter-api/v1/developer-utilities/supported-languages"}],"title":"Developer utilities","url":"#"}],"calloutLabel":"v1.1","title":"Standard v1.1","url":"/content/developer-twitter/en/docs/twitter-api/v1"}],"groupUrl":"/content/developer-twitter/en/docs/twitter-api"},{"groupName":"Twitter Ads API","navItems":[{"childNavItems":[{"title":"Step by step guide","url":"/content/developer-twitter/en/docs/twitter-ads-api/getting-started"},{"title":"Increasing access","url":"/content/developer-twitter/en/docs/twitter-ads-api/increasing-access"},{"title":"Subscribe for updates","url":"/content/developer-twitter/en/docs/twitter-ads-api/newsletter"}],"title":"Getting started","url":""},{"childNavItems":[{"title":"Hierarchy and terminology","url":"/content/developer-twitter/en/docs/twitter-ads-api/hierarchy-terminology"},{"title":"Accessing Ads accounts","url":"/content/developer-twitter/en/docs/twitter-ads-api/obtaining-ads-account-access"},{"title":"Making authenticated requests","url":"/content/developer-twitter/en/docs/twitter-ads-api/making-authenticated-requests"},{"title":"Error codes and responses","url":"/content/developer-twitter/en/docs/twitter-ads-api/response-codes"},{"title":"Rate limiting","url":"/content/developer-twitter/en/docs/twitter-ads-api/rate-limiting"},{"title":"Pagination","url":"/content/developer-twitter/en/docs/twitter-ads-api/pagination"},{"title":"Sorting","url":"/content/developer-twitter/en/docs/twitter-ads-api/sorting"},{"title":"Versioning","url":"/content/developer-twitter/en/docs/twitter-ads-api/versioning"},{"title":"Timezones","url":"/content/developer-twitter/en/docs/twitter-ads-api/timezones"},{"title":"Currency","url":"/content/developer-twitter/en/docs/twitter-ads-api/currency"},{"title":"Sandbox","url":"/content/developer-twitter/en/docs/twitter-ads-api/ads-api-sandbox"}],"title":"Fundamentals","url":""},{"childNavItems":[],"title":"Tools and libraries","url":"/content/developer-twitter/en/docs/twitter-ads-api/tools-and-libraries"},{"childNavItems":[],"title":"Analytics","url":"/content/developer-twitter/en/docs/twitter-ads-api/analytics"},{"childNavItems":[],"title":"Audiences","url":"/content/developer-twitter/en/docs/twitter-ads-api/audiences"},{"childNavItems":[],"title":"Campaign management","url":"/content/developer-twitter/en/docs/twitter-ads-api/campaign-management"},{"childNavItems":[],"title":"Catalog management","url":"/content/developer-twitter/en/docs/twitter-ads-api/catalog-management"},{"childNavItems":[],"title":"Creatives","url":"/content/developer-twitter/en/docs/twitter-ads-api/creatives"},{"childNavItems":[{"title":"Mobile Conversions","url":"/content/developer-twitter/en/docs/twitter-ads-api/measurement/mobile-conversions/overview"},{"title":"Web Conversions","url":"/content/developer-twitter/en/docs/twitter-ads-api/measurement/web-conversions/overview"},{"title":"AB testing","url":"/content/developer-twitter/en/docs/twitter-ads-api/measurement/ab-testing/overview"}],"title":"Measurement","url":""}],"groupUrl":"/content/developer-twitter/en/docs/twitter-ads-api"},{"groupName":"Twitter for Websites","navItems":[{"childNavItems":[{"title":"Webpage properties","url":"/content/developer-twitter/en/docs/twitter-for-websites/webpage-properties"},{"title":"Javascript API","url":"/content/developer-twitter/en/docs/twitter-for-websites/javascript-api"},{"title":"Supported languages and browsers","url":"/content/developer-twitter/en/docs/twitter-for-websites/supported-languages"},{"title":"Privacy","url":"/content/developer-twitter/en/docs/twitter-for-websites/privacy"}],"title":"Fundamentals","url":""},{"childNavItems":[],"title":"Tools and libraries","url":"/content/developer-twitter/en/docs/twitter-for-websites/tools-and-libraries"},{"childNavItems":[],"title":"Embedded Tweets","url":"/content/developer-twitter/en/docs/twitter-for-websites/embedded-tweets"},{"childNavItems":[],"title":"Embedded timelines","url":"/content/developer-twitter/en/docs/twitter-for-websites/timelines"},{"childNavItems":[{"title":"Tweets","url":"/content/developer-twitter/en/docs/twitter-for-websites/tweet-button"},{"title":"Follow","url":"/content/developer-twitter/en/docs/twitter-for-websites/follow-button"},{"title":"Direct Message","url":"/content/developer-twitter/en/docs/twitter-for-websites/direct-message-button"}],"title":"Embedded buttons","url":""},{"childNavItems":[],"title":"Web intents","url":"/content/developer-twitter/en/docs/twitter-for-websites/web-intents"},{"childNavItems":[],"title":"oEmbed API","url":"/content/developer-twitter/en/docs/twitter-for-websites/oembed-api"},{"childNavItems":[],"title":"Log in with Twitter","url":"/content/developer-twitter/en/docs/twitter-for-websites/log-in-with-twitter"},{"childNavItems":[],"title":"Optimize Tweets with Twitter Cards","url":"/content/developer-twitter/en/docs/twitter-for-websites/cards"},{"childNavItems":[],"title":"Publish faster articles with AMP","url":"/content/developer-twitter/en/docs/twitter-for-websites/amp"},{"childNavItems":[],"title":"Integrate Twitter with your CMS","url":"/content/developer-twitter/en/docs/twitter-for-websites/cms"}],"groupUrl":"/content/developer-twitter/en/docs/twitter-for-websites"}]}" data-search-path="https://developer.twitter.com/en/search-results.html" data-side-nav-v2="true"> </div> </div> </div> <div class="main-content twtr-col-lg-6"> <div class="main-content__wrapper"> <div class="dtc-docs__header main-content__header"> <span id="dtc-docs__header-title" class="dtc-docs__header-title chirp--bold-700 twtr-color--gray-900">Twitter Ads API</span> </div> <div class="ct01-columns"> <div class="ct01 twtr-padding__paragraph--top twtr-padding__block--bottom has-no-gutter "> <div class="ct01__content "> <div class="ct01__item twtr-grid "> <div class="ct01__column twtr-col-md-11 twtr-order-0-xs twtr-order-0-md none "> <div class="ct01__wrapper "> <div class="b01-headline-v3 twtr-component twtr-component--first"> <div class="b01-v3 twtr-component-space--md"> <div class="b01-v3__item"> <div class="b01-v3__copy"> <h2 class="b01-v3__headline chirp--bold-700 twtr-color--gray-900 b01-v3--align-left chirp--stepped"> Connect to the Twitter Ads platform </h2> </div> </div> </div> </div> <div class="b02-rich-text-v3 twtr-component"> <div class="b02-v3 twtr-rte-v3 twtr-scribe-clicks-within chirp--regular-100 twtr-color--black chirp--stepped twtr-component-space--md"> <p>The Twitter Ads API connects developers to Twitter's advertising platform to build solutions to meet the needs of Twitter's advertisers around the world.</p> </div> </div> <div class="b03-button-v3 twtr-component--last twtr-component"> <a class="chirp-btn twtr-spacing--mb-500 chirp-btn--primary twtr-scribe-clicks" href="https://web.archive.org/web/20230902233124/https://developer.twitter.com/en/docs/twitter-ads-api/getting-started" data-twtr-scribe-section="b03-button-v3" data-twtr-scribe-element="B1LQ" data-twtr-scribe-component="get-started" data-text="Get started"> Get started </a> </div> </div> </div> </div> </div> </div> </div> <div class="b12-horizontal-rule"> <div class=" b12 b12-thickness--base twtr-color-border--extra-light-gray-neutral twtr-margin__nested--top twtr-margin__nested--bottom"> </div> </div> <div class="ct01-columns"> <div class="ct01 twtr-padding__block--top twtr-padding__block--bottom has-no-gutter "> <div class="ct01__content "> <div class="ct01__item twtr-grid "> <div class="ct01__column twtr-col-md-5 twtr-order-0-xs twtr-order-0-md none "> <div class="ct01__wrapper "> <div class="b01-headline-v3 twtr-component twtr-component--first"> <div class="b01-v3 twtr-component-space--md"> <div class="b01-v3__item"> <div class="b01-v3__copy"> <h2 class="b01-v3__headline chirp--bold-400 twtr-color--gray-900 b01-v3--align-left chirp--stepped"> Campaign management </h2> </div> </div> </div> </div> <div class="b02-rich-text-v3 twtr-component"> <div class="b02-v3 twtr-rte-v3 twtr-scribe-clicks-within chirp--regular-100 twtr-color--black chirp--stepped twtr-component-space--md"> <p>Programmatically create, schedule, and manage ad campaigns to engage people on Twitter.</p> </div> </div> <div class="b03-button-v3 twtr-component"> <a class="chirp-btn twtr-spacing--mb-500 chirp-btn--tertiary chirp-btn--icon chirp-btn--icon-end twtr-scribe-clicks" href="https://web.archive.org/web/20230902233124/https://developer.twitter.com/en/docs/twitter-ads-api/campaign-management/overview" data-twtr-scribe-section="b03-button-v3" data-twtr-scribe-element="TBPO" data-twtr-scribe-component="learn-more" data-text="Learn more"> <div class="chirp-btn__icon"> <img class="chirp-btn__icon--img" src="https://web.archive.org/web/20230902233124im_/https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/m1_vnext/bracket_1x.svg"/> </div> Learn more </a> </div> <div class="b27-spacing twtr-component"> <div class="b27 twtr-spacing--mb-100"> </div></div> <div class="b01-headline-v3 twtr-component"> <div class="b01-v3 twtr-component-space--md"> <div class="b01-v3__item"> <div class="b01-v3__copy"> <h2 class="b01-v3__headline chirp--bold-400 twtr-color--gray-900 b01-v3--align-left chirp--stepped"> Creatives </h2> </div> </div> </div> </div> <div class="b02-rich-text-v3 twtr-component"> <div class="b02-v3 twtr-rte-v3 twtr-scribe-clicks-within chirp--regular-100 twtr-color--black chirp--stepped twtr-component-space--md"> <p>Draft and publish Tweets, extend the functionality of Tweets with Cards and manage and upload images and videos.</p> </div> </div> <div class="b03-button-v3 twtr-component--last twtr-component"> <a class="chirp-btn twtr-spacing--mb-500 chirp-btn--tertiary chirp-btn--icon chirp-btn--icon-end twtr-scribe-clicks" href="https://web.archive.org/web/20230902233124/https://developer.twitter.com/en/docs/twitter-ads-api/creatives/overview" data-twtr-scribe-section="b03-button-v3" data-twtr-scribe-element="ML68" data-twtr-scribe-component="learn-more" data-text="Learn more"> <div class="chirp-btn__icon"> <img class="chirp-btn__icon--img" src="https://web.archive.org/web/20230902233124im_/https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/m1_vnext/bracket_1x.svg"/> </div> Learn more </a> </div> </div> </div> <div class="ct01__column twtr-col-md-5 twtr-offset-1-md twtr-order-2-xs twtr-order-2-md none "> <div class="ct01__wrapper "> <div class="b01-headline-v3 twtr-component twtr-component--first"> <div class="b01-v3 twtr-component-space--md"> <div class="b01-v3__item"> <div class="b01-v3__copy"> <h2 class="b01-v3__headline chirp--bold-400 twtr-color--gray-900 b01-v3--align-left chirp--stepped"> Custom audiences </h2> </div> </div> </div> </div> <div class="b02-rich-text-v3 twtr-component"> <div class="b02-v3 twtr-rte-v3 twtr-scribe-clicks-within chirp--regular-100 twtr-color--black chirp--stepped twtr-component-space--md"> <p>Create and manage Tailored Audiences using Twitter, web or mobile data you provide.</p> </div> </div> <div class="b03-button-v3 twtr-component"> <a class="chirp-btn twtr-spacing--mb-500 chirp-btn--tertiary chirp-btn--icon chirp-btn--icon-end twtr-scribe-clicks" href="https://web.archive.org/web/20230902233124/https://developer.twitter.com/en/docs/twitter-ads-api/audiences/overview" data-twtr-scribe-section="b03-button-v3" data-twtr-scribe-element="W3YR" data-twtr-scribe-component="learn-more" data-text="Learn more"> <div class="chirp-btn__icon"> <img class="chirp-btn__icon--img" src="https://web.archive.org/web/20230902233124im_/https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/m1_vnext/bracket_1x.svg"/> </div> Learn more </a> </div> <div class="b27-spacing twtr-component"> <div class="b27 twtr-spacing--mb-100"> </div></div> <div class="b01-headline-v3 twtr-component"> <div class="b01-v3 twtr-component-space--md"> <div class="b01-v3__item"> <div class="b01-v3__copy"> <h2 class="b01-v3__headline chirp--bold-400 twtr-color--gray-900 b01-v3--align-left chirp--stepped"> Advertising analytics </h2> </div> </div> </div> </div> <div class="b02-rich-text-v3 twtr-component"> <div class="b02-v3 twtr-rte-v3 twtr-scribe-clicks-within chirp--regular-100 twtr-color--black chirp--stepped twtr-component-space--md"> <p>Use async and synchronous API endpoints to retrieve granular insights of ad campaigns by a full range of metrics.</p> </div> </div> <div class="b03-button-v3 twtr-component--last twtr-component"> <a class="chirp-btn twtr-spacing--mb-500 chirp-btn--tertiary chirp-btn--icon chirp-btn--icon-end twtr-scribe-clicks" href="https://web.archive.org/web/20230902233124/https://developer.twitter.com/en/docs/twitter-ads-api/analytics/overview" data-twtr-scribe-section="b03-button-v3" data-twtr-scribe-element="DE44" data-twtr-scribe-component="learn-more" data-text="Learn more"> <div class="chirp-btn__icon"> <img class="chirp-btn__icon--img" src="https://web.archive.org/web/20230902233124im_/https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/m1_vnext/bracket_1x.svg"/> </div> Learn more </a> </div> </div> </div> </div> </div> </div> </div> <div class="b12-horizontal-rule"> <div class=" b12 b12-thickness--base twtr-color-border--extra-light-gray-neutral twtr-margin__nested--top twtr-margin__nested--bottom"> </div> </div> <div class="ct01-columns"> <div class="ct01 twtr-padding__block--top twtr-padding__nested--bottom has-no-gutter "> <div class="ct01__content "> <div class="ct01__item twtr-grid "> <div class="ct01__column twtr-col-md-12 twtr-order-0-xs twtr-order-0-md none "> <div class="ct01__wrapper "> <div class="b01-headline-v3 twtr-component twtr-component--first"> <div class="b01-v3 twtr-component-space--md"> <div class="b01-v3__item"> <div class="b01-v3__copy"> <h2 class="b01-v3__headline chirp--bold-600 twtr-color--gray-900 b01-v3--align-left chirp--stepped"> Tools to get you started </h2> </div> </div> </div> </div> <div class="b02-rich-text-v3 twtr-component--last twtr-component"> <div class="b02-v3 twtr-rte-v3 twtr-scribe-clicks-within chirp--regular-100 twtr-color--black chirp--stepped twtr-component-space--md"> <p>Go from zero to "Hello World" with the help of these resources, tools, and libraries.</p> </div> </div> </div> </div> </div> </div> </div> </div> <div class="ct01-columns"> <div class="ct01 twtr-padding__block--top twtr-padding__block--bottom has-no-gutter "> <div class="ct01__content "> <div class="ct01__item twtr-grid "> <div class="ct01__column twtr-col-md-4 none "> <div class="ct01__wrapper "> <div class="b01-headline-v3 twtr-component twtr-component--first"> <div class="b01-v3 twtr-component-space--md"> <div class="b01-v3__item"> <div class="b01-v3__copy"> <h2 class="b01-v3__headline chirp--bold-400 twtr-color--gray-900 b01-v3--align-left chirp--stepped"> Client libraries </h2> </div> </div> </div> </div> <div class="b02-rich-text-v3 twtr-component"> <div class="b02-v3 twtr-rte-v3 twtr-scribe-clicks-within chirp--regular-100 twtr-color--black chirp--stepped twtr-component-space--md"> <p>Check out our curated selection of Twitter-built and community-supported client libraries.</p> </div> </div> <div class="b03-button-v3 twtr-component--last twtr-component"> <a class="chirp-btn twtr-spacing--mb-500 chirp-btn--tertiary chirp-btn--icon chirp-btn--icon-end twtr-scribe-clicks" href="https://web.archive.org/web/20230902233124/https://developer.twitter.com/en/docs/twitter-ads-api/tools-and-libraries" data-twtr-scribe-section="b03-button-v3" data-twtr-scribe-element="127X" data-twtr-scribe-component="learn-more" data-text="Learn more"> <div class="chirp-btn__icon"> <img class="chirp-btn__icon--img" src="https://web.archive.org/web/20230902233124im_/https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/m1_vnext/bracket_1x.svg"/> </div> Learn more </a> </div> </div> </div> <div class="ct01__column twtr-col-md-4 none "> <div class="ct01__wrapper "> <div class="b01-headline-v3 twtr-component twtr-component--first"> <div class="b01-v3 twtr-component-space--md"> <div class="b01-v3__item"> <div class="b01-v3__copy"> <h2 class="b01-v3__headline chirp--bold-400 twtr-color--gray-900 b01-v3--align-left chirp--stepped"> Postman collection </h2> </div> </div> </div> </div> <div class="b02-rich-text-v3 twtr-component"> <div class="b02-v3 twtr-rte-v3 twtr-scribe-clicks-within chirp--regular-100 twtr-color--black chirp--stepped twtr-component-space--md"> <p>We have built out a Postman collection for our v2 endpoints to help you explore the API using their visual client!</p> </div> </div> <div class="b03-button-v3 twtr-component--last twtr-component"> <a class="chirp-btn twtr-spacing--mb-500 chirp-btn--tertiary chirp-btn--icon chirp-btn--icon-end twtr-scribe-clicks" href="https://web.archive.org/web/20230902233124/https://documenter.getpostman.com/view/7379786/SzRw1WTU" target="_blank" rel="noopener noreferrer" data-twtr-scribe-section="b03-button-v3" data-twtr-scribe-element="ODGI" data-twtr-scribe-component="learn-more" data-text="Learn more"> <div class="chirp-btn__icon"> <img class="chirp-btn__icon--img" src="https://web.archive.org/web/20230902233124im_/https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/m1_vnext/bracket_1x.svg"/> </div> Learn more </a> </div> </div> </div> <div class="ct01__column twtr-col-md-4 none "> <div class="ct01__wrapper "> <div class="b01-headline-v3 twtr-component twtr-component--first"> <div class="b01-v3 twtr-component-space--md"> <div class="b01-v3__item"> <div class="b01-v3__copy"> <h2 class="b01-v3__headline chirp--bold-400 twtr-color--gray-900 b01-v3--align-left chirp--stepped"> Command line tool </h2> </div> </div> </div> </div> <div class="b02-rich-text-v3 twtr-component"> <div class="b02-v3 twtr-rte-v3 twtr-scribe-clicks-within chirp--regular-100 twtr-color--black chirp--stepped twtr-component-space--md"> <p>If you would rather work with our endpoints using a command line tool, twurl is built for you!</p> </div> </div> <div class="b03-button-v3 twtr-component--last twtr-component"> <a class="chirp-btn twtr-spacing--mb-500 chirp-btn--tertiary chirp-btn--icon chirp-btn--icon-end twtr-scribe-clicks" href="https://web.archive.org/web/20230902233124/https://github.com/twitter/twurl" target="_blank" rel="noopener noreferrer" data-twtr-scribe-section="b03-button-v3" data-twtr-scribe-element="Q8U7" data-twtr-scribe-component="learn-more" data-text="Learn more"> <div class="chirp-btn__icon"> <img class="chirp-btn__icon--img" src="https://web.archive.org/web/20230902233124im_/https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/m1_vnext/bracket_1x.svg"/> </div> Learn more </a> </div> </div> </div> </div> </div> </div> </div> <div class="ct01-columns"> <div class="ct01 twtr-padding__paragraph--top twtr-padding__section--bottom has-no-gutter "> <div class="ct01__content "> <div class="ct01__item twtr-grid "> <div class="ct01__column twtr-col-md-12 none "> <div class="ct01__wrapper "> <div class="b01-headline-v3 twtr-component twtr-component--first"> <div class="b01-v3 twtr-component-space--md"> <div class="b01-v3__item"> <div class="b01-v3__copy"> <h2 class="b01-v3__headline chirp--bold-600 twtr-color--gray-900 b01-v3--align-left chirp--stepped"> Need help? </h2> </div> </div> </div> </div> <div class="b02-rich-text-v3 twtr-component"> <div class="b02-v3 twtr-rte-v3 twtr-scribe-clicks-within chirp--regular-100 twtr-color--black chirp--stepped twtr-component-space--md"> <p>Visit our support section, where you can find troubleshooting tips, contact details, live API status monitor, and other helpful information that can help you understand how to overcome any obstacle.</p> </div> </div> <div class="b03-button-v3 twtr-component--last twtr-component"> <a class="chirp-btn twtr-spacing--mb-500 chirp-btn--secondary twtr-scribe-clicks" href="https://web.archive.org/web/20230902233124/https://developer.twitter.com/en/support/twitter-ads-api" data-twtr-scribe-section="b03-button-v3" data-twtr-scribe-element="9OYB" data-twtr-scribe-component="visit-the-ads-api-support-section" data-text="Visit the Ads API support section"> Visit the Ads API support section </a> </div> </div> </div> </div> </div> </div> </div> <div class="cr02-responsive-visibility"> <div class="cr02"> <div class="cr02__item twtr-hidden--sm twtr-hidden--xs "> <div class="ct01-columns twtr-component--last twtr-component twtr-component--first"> <div class="ct01 twtr-padding__paragraph--top twtr-padding__paragraph--bottom twtr-background--gray-900 has-no-gutter "> <div class="ct01__content "> <div class="ct01__item twtr-grid "> <div class="ct01__column twtr-col-md-12 twtr-order-0-xs twtr-order-0-md "> <div class="ct01__wrapper is-vertically-centered "> <div class="b27-spacing twtr-component twtr-component--first"> <div class="b27 twtr-spacing--mbr-200"> </div></div> <div class="b02-rich-text-v3 twtr-component--last twtr-component"> <div class="b02-v3 twtr-rte-v3 twtr-scribe-clicks-within chirp--regular-200 twtr-color--gray-900 chirp--stepped "> <p style="text-align: center;"><span class="twtr-color--white">Help us build the next generation of the Twitter API: <a href="https://web.archive.org/web/20230902233124/https://twitterdevfeedback.uservoice.com/forums/930250-twitter-api" target="_blank" rel="nofollow noopener noreferrer"><b>Give us your product feedback ></b></a><br/> </span><br/> </p> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> <div class="cr02-responsive-visibility"> <div class="cr02"> <div class="cr02__item twtr-hidden--md twtr-hidden--lg twtr-hidden--xl "> <div class="ct01-columns twtr-component--last twtr-component twtr-component--first"> <div class="ct01 twtr-padding__group--top twtr-padding__group--bottom twtr-background--gray-900 "> <div class="ct01__content twtr-container "> <div class="ct01__item twtr-grid "> <div class="ct01__column twtr-col-md-12 twtr-order-0-xs twtr-order-0-md "> <div class="ct01__wrapper is-horizontally-centered"> <div class="b27-spacing twtr-component twtr-component--first"> <div class="b27 twtr-spacing--mbr-400"> </div></div> <div class="ct09-justify-content twtr-component--last twtr-component"> <div class="ct09 " style="--ct09-fixed-height: ;"> <div class="ct09__item"> <div class="ct09__wrapper is-direction--row is-justified-center is-aligned-center twtr-spacing--pb-0"> <div class="b02-rich-text-v3 twtr-component--last twtr-component twtr-component--first"> <div class="b02-v3 twtr-rte-v3 twtr-scribe-clicks-within chirp--regular-200 twtr-color--gray-900 chirp--stepped "> <p style="text-align: center;"><span class="twtr-color--white">Help us build the next generation of the Twitter API: <br/> <a href="https://web.archive.org/web/20230902233124/https://twitterdevfeedback.uservoice.com/forums/930250-twitter-api" target="_blank" rel="nofollow noopener noreferrer"><b><br/> Give us your product feedback ></b></a><br/> </span><br/> </p> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> <div id="twtr-article-embedded-survey" class="b32"></div> </div> </div> <div class="sidebar-content docs-right-side-nav twtr-col-lg-3"> <div class="dtc05-navigation-right" data-header-title="Twitter Ads API" data-sidenav-json="[]" data-icon-chevron-down="<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewbox="0 0 24 24" aria-hidden="true" focusable="false" role="none" class="twtr-icon"> <path opacity="0" d="M0 0h24v24H0z" /> <path d="M20.207 7.043c-.39-.39-1.023-.39-1.414 0L12 13.836 5.207 7.043c-.39-.39-1.023-.39-1.414 0s-.39 1.023 0 1.414l7.5 7.5c.195.195.45.293.707.293s.512-.098.707-.293l7.5-7.5c.39-.39.39-1.023 0-1.414z" /> </svg>"> </div> </div> </div> </div> </main> <div> <footer class="u02fs twtr-background--blue-extra-light twtr-background--gray-0"> <div class="twtr-container"> <div class="twtr-grid"> <div class="u02fs__footer-link-col twtr-col-12 twtr-col-md-4"> <a href="/web/20230902233124/https://developer.twitter.com/en1/more/developer-terms" title="Developer policy and terms" target="_blank" class="u02fs__footer-link twtr-type--roman-50 twtr-color--gray-900"> Developer policy and terms </a> </div> <div class="u02fs__footer-link-col twtr-col-12 twtr-col-md-4"> <a href="https://web.archive.org/web/20230902233124/http://x.com/xdevelopers" title="Follow @XDevelopers" target="_blank" class="u02fs__footer-link twtr-type--roman-50 twtr-color--gray-900"> Follow @XDevelopers </a> </div> <div class="u02fs__footer-link-col twtr-col-12 twtr-col-md-4 u02fs__subscribe-button-col"> <a class="b03__button twtr-btn twtr-btn--secondary twtr-btn--size-default twtr-btn-color--secondary-blue u02fs__button twtr-btn__icon-- twtr-scribe-clicks" href="/web/20230902233124/https://developer.twitter.com/en/twitterdev-news-subscription" rel="noopener noreferrer" target="_blank" data-twtr-scribe-section="b03-button" data-twtr-scribe-element="VC7R" data-twtr-scribe-component="subscribe-to-developer-news" data-text="Subscribe to developer news"> <!--/* Button text --> Subscribe to developer news </a> </div> </div> </div> </footer> </div> <div> <footer class="u02 twtr-color-bg--black-neutral"> <div class="twtr-container"> <div class="u02__wrapper"> <div class="u02__row u02__network-map"> <div class="twtr-grid u02__twtr-grid"> <div class="js-accordion u02__column"> <h4 class="u02__column__parent twtr-type--bold-14 twtr-color--gray-0 is-opaque"> X platform <span class="u02__icon twtr-dtc-fill--extra-light-gray twtr-hidden--md twtr-hidden--lg twtr-hidden--xl"> <svg xmlns="http://www.w3.org/2000/svg" width="17" height="9.5" viewbox="0 0 17 9.5" aria-hidden="true" focusable="false" role="none" class="twtr-icon--sm"> <path d="M16.707.293c-.39-.39-1.023-.39-1.414 0L8.5 7.086 1.707.293c-.39-.39-1.023-.39-1.414 0s-.39 1.023 0 1.414l7.5 7.5c.195.195.45.293.707.293s.512-.098.707-.293l7.5-7.5c.39-.39.39-1.023 0-1.414z"/> </svg> </span> </h4> <ul class="u02__column__list"> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://x.com/" title="X.com" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> X.com </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://status.twitterstat.us/" title="Status" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Status </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://help.twitter.com/resources/accessibility" title="Accessibility" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Accessibility </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://publish.twitter.com/" title="Embed a post" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Embed a post </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://privacy.twitter.com/" title="Privacy Center" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Privacy Center </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://transparency.twitter.com/" title="Transparency Center" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Transparency Center </a> </li> </ul> </div> <div class="js-accordion u02__column"> <h4 class="u02__column__parent twtr-type--bold-14 twtr-color--gray-0 is-opaque"> X Corp. <span class="u02__icon twtr-dtc-fill--extra-light-gray twtr-hidden--md twtr-hidden--lg twtr-hidden--xl"> <svg xmlns="http://www.w3.org/2000/svg" width="17" height="9.5" viewbox="0 0 17 9.5" aria-hidden="true" focusable="false" role="none" class="twtr-icon--sm"> <path d="M16.707.293c-.39-.39-1.023-.39-1.414 0L8.5 7.086 1.707.293c-.39-.39-1.023-.39-1.414 0s-.39 1.023 0 1.414l7.5 7.5c.195.195.45.293.707.293s.512-.098.707-.293l7.5-7.5c.39-.39.39-1.023 0-1.414z"/> </svg> </span> </h4> <ul class="u02__column__list"> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://about.twitter.com/en/who-we-are/our-company.html" title="About the company" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> About the company </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://blog.twitter.com/" title="Company news" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Company news </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://about.twitter.com/en/who-we-are/brand-toolkit.html" title="Brand toolkit" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Brand toolkit </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://careers.twitter.com/" title="Jobs and internships" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Jobs and internships </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://investor.twitterinc.com/" title="Investors" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Investors </a> </li> </ul> </div> <div class="js-accordion u02__column"> <h4 class="u02__column__parent twtr-type--bold-14 twtr-color--gray-0 is-opaque"> Help <span class="u02__icon twtr-dtc-fill--extra-light-gray twtr-hidden--md twtr-hidden--lg twtr-hidden--xl"> <svg xmlns="http://www.w3.org/2000/svg" width="17" height="9.5" viewbox="0 0 17 9.5" aria-hidden="true" focusable="false" role="none" class="twtr-icon--sm"> <path d="M16.707.293c-.39-.39-1.023-.39-1.414 0L8.5 7.086 1.707.293c-.39-.39-1.023-.39-1.414 0s-.39 1.023 0 1.414l7.5 7.5c.195.195.45.293.707.293s.512-.098.707-.293l7.5-7.5c.39-.39.39-1.023 0-1.414z"/> </svg> </span> </h4> <ul class="u02__column__list"> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://help.twitter.com/" title="Help Center" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Help Center </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://help.twitter.com/en/using-twitter" title="Using X" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Using X </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://create.twitter.com/" title="X for creators" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> X for creators </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://business.twitter.com/en/help.html" title="Ads Help Center" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Ads Help Center </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://help.twitter.com/en/managing-your-account" title="Managing your account" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Managing your account </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://preferencecenter.twitter.com/" title="Email Preference Center" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Email Preference Center </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://help.twitter.com/en/rules-and-policies" title="Rules and policies" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Rules and policies </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://help.twitter.com/en/forms.html" title="Contact us" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Contact us </a> </li> </ul> </div> <div class="js-accordion u02__column"> <h4 class="u02__column__parent twtr-type--bold-14 twtr-color--gray-0 is-opaque"> Developer resources <span class="u02__icon twtr-dtc-fill--extra-light-gray twtr-hidden--md twtr-hidden--lg twtr-hidden--xl"> <svg xmlns="http://www.w3.org/2000/svg" width="17" height="9.5" viewbox="0 0 17 9.5" aria-hidden="true" focusable="false" role="none" class="twtr-icon--sm"> <path d="M16.707.293c-.39-.39-1.023-.39-1.414 0L8.5 7.086 1.707.293c-.39-.39-1.023-.39-1.414 0s-.39 1.023 0 1.414l7.5 7.5c.195.195.45.293.707.293s.512-.098.707-.293l7.5-7.5c.39-.39.39-1.023 0-1.414z"/> </svg> </span> </h4> <ul class="u02__column__list"> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://developer.twitter.com/en" title="Developer home" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Developer home </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://developer.twitter.com/en/docs" title="Documentation" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Documentation </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://twittercommunity.com/" title="Forums" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Forums </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://developer.twitter.com/en/community" title="Communities" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Communities </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://blog.twitter.com/developer/" title="Developer blog" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Developer blog </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://blog.twitter.com/engineering/en_us.html" title="Engineering blog" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Engineering blog </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://developer.twitter.com/en/more/developer-terms" title="Developer terms" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Developer terms </a> </li> </ul> </div> <div class="js-accordion u02__column"> <h4 class="u02__column__parent twtr-type--bold-14 twtr-color--gray-0 is-opaque"> Business resources <span class="u02__icon twtr-dtc-fill--extra-light-gray twtr-hidden--md twtr-hidden--lg twtr-hidden--xl"> <svg xmlns="http://www.w3.org/2000/svg" width="17" height="9.5" viewbox="0 0 17 9.5" aria-hidden="true" focusable="false" role="none" class="twtr-icon--sm"> <path d="M16.707.293c-.39-.39-1.023-.39-1.414 0L8.5 7.086 1.707.293c-.39-.39-1.023-.39-1.414 0s-.39 1.023 0 1.414l7.5 7.5c.195.195.45.293.707.293s.512-.098.707-.293l7.5-7.5c.39-.39.39-1.023 0-1.414z"/> </svg> </span> </h4> <ul class="u02__column__list"> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://business.twitter.com/en/advertising.html" title="Advertise" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Advertise </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://business.twitter.com/" title="X for business" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> X for business </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://business.twitter.com/en/resources.html" title="Resources and guides" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Resources and guides </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://marketing.twitter.com/" title="X for marketers" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> X for marketers </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://marketing.twitter.com/en/insights" title="Marketing insights" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Marketing insights </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://marketing.twitter.com/en/success-stories" title="Brand inspiration" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Brand inspiration </a> </li> <li class="u02__link-item"> <a href="https://web.archive.org/web/20230902233124/https://www.twitterflightschool.com/sl/382652bc" title="X Flight School" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> X Flight School </a> </li> </ul> </div> </div> </div> <div class="u02__row u02__legal twtr-spacing--pt-500"> <div class="twtr-grid u02__twtr-grid"> <div class="u02__column u02__column--bottom"> <span class="u02__column-footnote twtr-type--roman-14 twtr-color--gray-0 is-opaque"> © 2023 X Corp. </span> </div> <div class="u02__column u02__column--bottom"> <a href="https://web.archive.org/web/20230902233124/https://help.twitter.com/rules-and-policies/twitter-cookies" title="Cookies" target="_blank" class="u02__column-footnote twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Cookies </a> </div> <div class="u02__column u02__column--bottom"> <a href="https://web.archive.org/web/20230902233124/https://twitter.com/privacy" title="Privacy" target="_blank" class="u02__column-footnote twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Privacy </a> </div> <div class="u02__column u02__column--bottom"> <a href="https://web.archive.org/web/20230902233124/https://twitter.com/tos" title="Terms and conditions" target="_blank" class="u02__column-footnote twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Terms and conditions </a> </div> <div class="u02__column u02__column--bottom u08__language-selector"> </div> </div> </div> </div> </div> </footer> </div> <script async src="https://web.archive.org/web/20230902233124js_/https://platform.twitter.com/widgets.js"></script> <div id="page-props" data-page-title="Twitter Ads API Documentation" data-page-path="/content/developer-twitter/en/docs/twitter-ads-api"> </div> <script type="text/javascript" src="https://web.archive.org/web/20230902233124js_/https://cdn.cms-twdigitalassets.com/etc/designs/developer2-twitter/public/js/core.js.twhash.p.f.28be1a1b05a4f8af16a1ea0cada371a3.js"></script> <script type="text/javascript" src="https://web.archive.org/web/20230902233124js_/https://cdn.cms-twdigitalassets.com/etc/designs/developer2-twitter/public/js/project.js.twhash.p.f.1563a4f3032dbb4999ad165e9dada50f.js"></script> <script src="https://web.archive.org/web/20230902233124js_/https://cdn.cms-twdigitalassets.com/etc/designs/developer-twitter/clientlib-twtr-profile-adapter.min.twhash.p.cl.c3b119a4cc2249caed364b89790624a4.js"></script> <div id="u12" class="u12-data-protection-notice"> <div class="u12-data-protection-notice__item u12-data-protection-notice__item--b is-hidden"> <div class="u12b-opt-in" id="u12b" data-cname="twtr_pixel_opt_in"> <div class="u12b-opt-in__item u12-data-protection-notice__notice"> <div class="u12b-opt-in__content"> <div class="u12b-opt-in__copy"> <p class="mtc-font twtr-font"> <b>Did someone say … cookies?</b><br/><br/> Twitter and its partners use cookies to provide you with a better, safer and faster service and to support our business. Some cookies are necessary to use our services, improve our services, and make sure they work properly. <a href="https://web.archive.org/web/20230902233124/https://help.twitter.com/rules-and-policies/twitter-cookies" target="_blank">Show more about your choices</a>. </p> </div> <div class="u12b-opt-in__choice twtr-scribe-clicks-within"> <ul class="u12b-opt-in__choice-list"> <li class="u12b-opt-in__choice-list-item"> <button class="u12b-opt-in__button is-blue u12b-opt-in__button--accept mtc-font twtr-font js-accept twtr-scribe-clicks" data-twtr-scribe-section="u12-data-protection-notice" data-twtr-scribe-element="W6IN" data-twtr-scribe-component="data-protection-notice"> Accept all cookies </button> </li> <li class="u12b-opt-in__choice-list-item"> <button class="u12b-opt-in__button is-naked u12b-opt-in__button--decline mtc-font twtr-font js-decline twtr-scribe-clicks" data-twtr-scribe-section="u12-data-protection-notice" data-twtr-scribe-element="W6IN" data-twtr-scribe-component="data-protection-notice"> Refuse non-essential cookies </button> </li> </ul> </div> </div> </div> </div> </div> </div> <link rel="stylesheet" href="https://web.archive.org/web/20230902233124cs_/https://cdn.cms-twdigitalassets.com/etc/designs/common-twitter/clientlib-u12-data-protection-notice.min.twhash.p.cl.8d93205985d36dea4268f79e373e2b02.css" type="text/css"> <script src="https://web.archive.org/web/20230902233124js_/https://cdn.cms-twdigitalassets.com/etc/designs/common-twitter/clientlib-promise-polyfill.min.twhash.p.cl.678c3c47bfcf62393184734a7204fcdf.js"></script> <script src="https://web.archive.org/web/20230902233124js_/https://cdn.cms-twdigitalassets.com/etc/designs/common-twitter/clientlib-twtr-profile-adapter.min.twhash.p.cl.2f6a2e41ae41c33aba9f8a7dcf876eb6.js"></script> <script src="https://web.archive.org/web/20230902233124js_/https://cdn.cms-twdigitalassets.com/etc/designs/common-twitter/clientlib-u12-data-protection-notice.min.twhash.p.cl.bc327d8aa5370ac2d242206d30b75fca.js"></script> </div> </body> </html> <!-- FILE ARCHIVED ON 23:31:24 Sep 02, 2023 AND RETRIEVED FROM THE INTERNET ARCHIVE ON 16:32:59 Nov 26, 2024. JAVASCRIPT APPENDED BY WAYBACK MACHINE, COPYRIGHT INTERNET ARCHIVE. ALL OTHER CONTENT MAY ALSO BE PROTECTED BY COPYRIGHT (17 U.S.C. SECTION 108(a)(3)). --> <!-- playback timings (ms): captures_list: 0.704 exclusion.robots: 0.047 exclusion.robots.policy: 0.035 esindex: 0.012 cdx.remote: 14.963 LoadShardBlock: 257.088 (3) PetaboxLoader3.datanode: 203.672 (4) PetaboxLoader3.resolve: 145.739 (2) load_resource: 130.491 -->