Search Tweets introduction | 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="https://web-static.archive.org/_static/js/bundle-playback.js?v=7YQSqjSh" charset="utf-8"></script> <script type="text/javascript" src="https://web-static.archive.org/_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="https://web-static.archive.org/_static/js/ruffle/ruffle.js"></script> <script type="text/javascript"> __wm.init("https://web.archive.org/web"); __wm.wombat("https://developer.x.com/en/docs/x-api/tweets/search/introduction","20241119073005","https://web.archive.org/","web","https://web-static.archive.org/_static/", "1732001405"); </script> <link rel="stylesheet" type="text/css" href="https://web-static.archive.org/_static/css/banner-styles.css?v=p7PEIJWi" /> <link rel="stylesheet" type="text/css" href="https://web-static.archive.org/_static/css/iconochive.css?v=3PDvdIFv" />  <meta charset="utf-8"/> <meta name="viewport" content="width=device-width, initial-scale=1"/> <title>Search Tweets introduction | Docs | Twitter Developer Platform </title> <meta name="description" content="From providing fundamental research data to near-real-time 'listening' applications, this endpoint can be used to collect Tweets related to topics of interest. "/> <link rel="canonical" href="https://web.archive.org/web/20241119073005/https://developer.x.com/en/docs/x-api/tweets/search/introduction"/> <meta property="og:url" content="https://web.archive.org/web/20241119073005/https://developer.x.com/en/docs/x-api/tweets/search/introduction"/> <meta property="og:type" content="article"/> <meta property="og:title" content="Search Tweets introduction"/> <meta property="og:description" content="From providing fundamental research data to near-real-time 'listening' applications, this endpoint can be used to collect Tweets related to topics of interest. "/> <meta property="og:image" content="https://web.archive.org/web/20241119073005im_/https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/x_sharing_card.png.twimg.768.png"/> <meta name="keywords"/> <meta name="twitter:card" content="summary_large_image"/> <link rel="alternate" hreflang="en" href="https://web.archive.org/web/20241119073005/https://developer.x.com/en/docs/x-api/tweets/search/introduction"/> <meta name="twitter:widgets:new-embed-design" content="on"/> <meta name="twitter:widgets:csp" content="on"/> <link href="https://web.archive.org/web/20241119073005im_/https://abs.twimg.com/favicons/twitter.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":"7eb24d3","pageKey":"7eb24d3-en-en","pageName":"Search Tweets introduction","pagePath":"/content/developer-twitter/en/docs/x-api/tweets/search/introduction","pageType":"documentation-page","pagePublishDate":"","language":"en","geoRegion":"en","category":{"tags":{"tagIDs":[],"tagNames":[]},"scribe":{"component":"x-api/tweets/search/introduction","section":"docs","page":"developer","element":"page"}},"attribute":{}}}</script> <link rel="preload" href="https://web.archive.org/web/20241119073005/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/20241119073005/https://fonts.twitter.com/chirp/chirp-bold-web.woff2" as="font" type="font/woff2" crossorigin/> <link rel="preload" href="https://web.archive.org/web/20241119073005/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/20241119073005/https://fonts.twitter.com/chirp/chirp-regular-web.woff2" as="font" type="font/woff2" crossorigin/> <link rel="preload" href="https://web.archive.org/web/20241119073005/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/20241119073005/https://fonts.twitter.com/chirp/chirp-extended-bold-web.woff2" as="font" type="font/woff2" crossorigin/> <link rel="stylesheet" href="https://web.archive.org/web/20241119073005cs_/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/20241119073005cs_/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/20241119073005cs_/https://cdn.cms-twdigitalassets.com/etc/designs/developer2-twitter/public/css/project.css.twhash.p.f.e4bfaad196a03b2b7ae1b47b5f7a2a8f.css" media="screen" type="text/css"/> <link rel="stylesheet" href="https://web.archive.org/web/20241119073005cs_/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="x-api/tweets/search/introduction" 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":"X API","linkDisabled":false,"title":"X API","path":"https://developer.x.com/en/products/twitter-api"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"X Ads API","linkDisabled":false,"title":"X Ads API","path":"https://developer.x.com/en/products/x-ads-api"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"X for websites","linkDisabled":false,"title":"X for websites","path":"https://developer.x.com/en/products/x-for-websites"}],"overviewTitle":"Products","linkDisabled":true,"title":"Products","path":"https://developer.x.com/en/products"},{"isActive":false,"hasActiveChild":false,"children":[{"isActive":false,"hasActiveChild":false,"children":[{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Getting Started","linkDisabled":false,"title":"Getting Started","path":"https://developer.x.com/en/docs/platform-overview"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Tutorials","linkDisabled":false,"title":"Tutorials","path":"https://developer.x.com/en/docs/tutorials"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Github","linkDisabled":false,"title":"Github","path":"https://github.com/xdevplatform"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"API reference index","linkDisabled":false,"title":"API reference index","path":"https://developer.x.com/en/docs/api-reference-index"}],"linkDisabled":true,"title":"Resources","path":"https://developer.x.com/"},{"isActive":false,"hasActiveChild":false,"children":[{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"X API home","linkDisabled":false,"title":"X API home","path":"https://developer.x.com/en/docs/x-api"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"X API getting started","linkDisabled":false,"title":"X API getting started","path":"https://developer.x.com/en/docs/x-api/getting-started/about-x-api"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"SDKs","linkDisabled":false,"title":"SDKs","path":"https://developer.x.com/en/docs/x-api/tools-and-libraries/sdks/overview"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Tools and Libraries","linkDisabled":false,"title":"Tools and Libraries","path":"https://developer.x.com/en/docs/x-api/tools-and-libraries/v2"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"v2 migration","linkDisabled":false,"title":"v2 migration","path":"https://developer.x.com/en/docs/x-api/migrate/x-api-endpoint-map"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Enterprise APIs","linkDisabled":false,"title":"Enterprise APIs","path":"https://developer.x.com/en/docs/x-api/enterprise"}],"linkDisabled":true,"title":"X API","path":"https://developer.x.com/"},{"isActive":false,"hasActiveChild":false,"children":[{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"X Ads API home","linkDisabled":false,"title":"X Ads API home","path":"https://developer.x.com/en/docs/twitter-ads-api.html"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"X Ads API getting started","linkDisabled":false,"title":"X Ads API getting started","path":"https://developer.x.com/en/docs/x-ads-api/getting-started"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Apply for access","linkDisabled":false,"title":"Apply for access","path":"https://developer.x.com/en/docs/x-ads-api/apply.html"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Tools and libraries","linkDisabled":false,"title":"Tools and libraries","path":"https://developer.x.com/en/docs/x-ads-api/tools-and-libraries"}],"linkDisabled":true,"title":"X Ads API","path":"https://developer.x.com/"},{"isActive":false,"hasActiveChild":false,"children":[{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"X for Websites home","linkDisabled":false,"title":"X for Websites home","path":"https://developer.x.com/en/docs/twitter-for-websites.html"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Embedded Posts","linkDisabled":false,"title":"Embedded Posts","path":"https://developer.x.com/en/docs/x-for-websites/embedded-tweets/overview"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Embedded Timelines","linkDisabled":false,"title":"Embedded Timelines","path":"https://developer.x.com/en/docs/x-for-websites/timelines/overview"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Embedded buttons","linkDisabled":false,"title":"Embedded buttons","path":"https://developer.x.com/en/docs/x-for-websites/tweet-button/overview"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Web intents","linkDisabled":false,"title":"Web intents","path":"https://developer.x.com/en/docs/x-for-websites/web-intents/overview"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"X cards","linkDisabled":false,"title":"X cards","path":"https://developer.x.com/en/docs/x-for-websites/cards/overview/abouts-cards"}],"linkDisabled":true,"title":"X for Websites","path":"https://developer.x.com/"}],"overviewTitle":"Docs","linkDisabled":false,"menuType":"multiCategory","title":"Docs","path":"https://developer.x.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.x.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.x.com/en/use-cases/build-for-consumers"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Do research","linkDisabled":false,"title":"Do research","path":"https://developer.x.com/en/use-cases/do-research"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Teach \u0026 learn","linkDisabled":false,"title":"Teach \u0026 learn","path":"https://developer.x.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.x.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.x.com/en/use-cases/build-for-fun"}],"overviewTitle":"Use Cases","linkDisabled":true,"title":"Use Cases","path":"https://developer.x.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.x.com/en/updates/changelog"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Blog","linkDisabled":false,"title":"Blog","path":"https://developer.x.com/en/blog"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Newsletter","linkDisabled":false,"title":"Newsletter","path":"https://developer.x.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.x.com/"},{"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.x.com/en/community/leaders"}],"linkDisabled":true,"title":"Connect","path":"https://developer.x.com/"}],"overviewTitle":"Community","linkDisabled":false,"menuType":"multiCategory","title":"Community","path":"https://developer.x.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.x.com/en/developer-terms"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Developer agreement","linkDisabled":false,"title":"Developer agreement","path":"https://developer.x.com/en/developer-terms/agreement-and-policy/source"}],"overviewTitle":"Support","linkDisabled":false,"title":"Support","path":"https://developer.x.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/20241119073005im_/https://developer.x.com/en/docs/x-api/tweets/search/introduction#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.x.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":"X IDs","url":"/content/developer-twitter/en/docs/x-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":"X API","navItems":[{"childNavItems":[{"title":"About the X API","url":"/content/developer-twitter/en/docs/x-api/getting-started/about-x-api"},{"title":"Getting access","url":"/content/developer-twitter/en/docs/x-api/getting-started/getting-access-to-the-x-api"},{"title":"Make your first request","url":"/content/developer-twitter/en/docs/x-api/getting-started/make-your-first-request"},{"title":"Important resources","url":"/content/developer-twitter/en/docs/x-api/getting-started/important-resources"}],"title":"Getting started","url":"#"},{"childNavItems":[{"title":"SDKs","url":"/content/developer-twitter/en/docs/x-api/tools-and-libraries/sdks"}],"title":"Tools and libraries","url":"/content/developer-twitter/en/docs/x-api/tools-and-libraries"},{"title":"What to build","url":"/content/developer-twitter/en/docs/x-api/what-to-build"},{"childNavItems":[{"title":"Overview","url":"/content/developer-twitter/en/docs/x-api/migrate/overview"},{"title":"Data format migration","url":"/content/developer-twitter/en/docs/x-api/migrate/data-formats"},{"title":"X API endpoint map","url":"/content/developer-twitter/en/docs/x-api/migrate/x-api-endpoint-map"}],"title":"Migrate","url":"/content/developer-twitter/en/docs/x-api/migrate"},{"childNavItems":[{"grandChildNavItems":[{"title":"Data dictionary","url":"/content/developer-twitter/en/docs/x-api/data-dictionary"},{"title":"Fields","url":"/content/developer-twitter/en/docs/x-api/fields"},{"title":"Expansions","url":"/content/developer-twitter/en/docs/x-api/expansions"},{"title":"Tweet annotations","url":"/content/developer-twitter/en/docs/x-api/annotations"},{"title":"Metrics","url":"/content/developer-twitter/en/docs/x-api/metrics"},{"title":"Conversation ID","url":"/content/developer-twitter/en/docs/x-api/conversation-id"},{"title":"Pagination","url":"/content/developer-twitter/en/docs/x-api/pagination"},{"title":"Versioning","url":"/content/developer-twitter/en/docs/x-api/versioning"},{"title":"Consistency","url":"/content/developer-twitter/en/docs/x-api/consistency"},{"title":"Rate limits","url":"/content/developer-twitter/en/docs/x-api/rate-limits"},{"title":"Tweet cap","url":"/content/developer-twitter/en/docs/x-api/tweet-caps"},{"title":"Edit Tweets","url":"/content/developer-twitter/en/docs/x-api/edit-tweets"}],"title":"Fundamentals","url":"#"},{"grandChildNavItems":[{"title":"Tweets lookup","url":"/content/developer-twitter/en/docs/x-api/tweets/lookup"},{"title":"Manage Tweets","url":"/content/developer-twitter/en/docs/x-api/tweets/manage-tweets"},{"title":"Timelines","url":"/content/developer-twitter/en/docs/x-api/tweets/timelines"},{"title":"Search Tweets","url":"/content/developer-twitter/en/docs/x-api/tweets/search"},{"title":"Tweet counts","url":"/content/developer-twitter/en/docs/x-api/tweets/counts"},{"title":"Filtered stream","url":"/content/developer-twitter/en/docs/x-api/tweets/filtered-stream"},{"title":"Volume streams","url":"/content/developer-twitter/en/docs/x-api/tweets/volume-streams"},{"title":"Retweets","url":"/content/developer-twitter/en/docs/x-api/tweets/retweets"},{"title":"Quote Tweets","url":"/content/developer-twitter/en/docs/x-api/tweets/quote-tweets"},{"title":"Likes","url":"/content/developer-twitter/en/docs/x-api/tweets/likes"},{"title":"Bookmarks","url":"/content/developer-twitter/en/docs/x-api/tweets/bookmarks"},{"title":"Hide replies","url":"/content/developer-twitter/en/docs/x-api/tweets/hide-replies"}],"title":"Tweets","url":"#"},{"grandChildNavItems":[{"title":"Users lookup","url":"/content/developer-twitter/en/docs/x-api/users/lookup"},{"title":"Follows","url":"/content/developer-twitter/en/docs/x-api/users/follows"},{"title":"Blocks","url":"/content/developer-twitter/en/docs/x-api/users/blocks"},{"title":"Mutes","url":"/content/developer-twitter/en/docs/x-api/users/mutes"},{"title":"Search","url":"/content/developer-twitter/en/docs/x-api/users/search"},{"title":"Personalized Trends","url":"/content/developer-twitter/en/docs/x-api/users/personalized-trends"}],"title":"Users","url":"#"},{"grandChildNavItems":[{"title":"Tweets","url":"/content/developer-twitter/en/docs/x-api/usage/tweets"}],"title":"Usage","url":"#"},{"title":"Trends","url":"/content/developer-twitter/en/docs/x-api/trends"},{"grandChildNavItems":[{"title":"Overview","url":"/content/developer-twitter/en/docs/x-api/spaces/overview"},{"title":"Spaces lookup","url":"/content/developer-twitter/en/docs/x-api/spaces/lookup"},{"title":"Search Spaces","url":"/content/developer-twitter/en/docs/x-api/spaces/search"}],"title":"Spaces","url":"#"},{"grandChildNavItems":[{"title":"Direct Messages lookup","url":"/content/developer-twitter/en/docs/x-api/direct-messages/lookup"},{"title":"Manage Direct Messages","url":"/content/developer-twitter/en/docs/x-api/direct-messages/manage"},{"title":"Direct Message blocks","url":"/content/developer-twitter/en/docs/x-api/direct-messages/blocks"}],"title":"Direct Messages","url":"#"},{"grandChildNavItems":[{"title":"Lists lookup","url":"/content/developer-twitter/en/docs/x-api/lists/list-lookup"},{"title":"Manage lists","url":"/content/developer-twitter/en/docs/x-api/lists/manage-lists"},{"title":"List Tweets lookup","url":"/content/developer-twitter/en/docs/x-api/lists/list-tweets"},{"title":"List members","url":"/content/developer-twitter/en/docs/x-api/lists/list-members"},{"title":"Pinned Lists","url":"/content/developer-twitter/en/docs/x-api/lists/pinned-lists"}],"title":"Lists","url":"#"},{"grandChildNavItems":[{"title":"Communities lookup","url":"/content/developer-twitter/en/docs/x-api/communities/lookup"},{"title":"Search Communities","url":"/content/developer-twitter/en/docs/x-api/communities/search"}],"title":"Communities","url":"#"},{"grandChildNavItems":[{"title":"Batch compliance","url":"/content/developer-twitter/en/docs/x-api/compliance/batch-compliance/"},{"title":"Compliance streams","url":"/content/developer-twitter/en/docs/x-api/compliance/streams/"}],"title":"Compliance","url":"#"}],"title":"X API v2","url":""},{"childNavItems":[{"grandChildNavItems":[{"title":"Gnip Console","url":"/content/developer-twitter/en/docs/x-api/enterprise/console"},{"title":"Data dictionary","url":"/content/developer-twitter/en/docs/x-api/enterprise/data-dictionary"},{"title":"Data enrichments","url":"/content/developer-twitter/en/docs/x-api/enterprise/enrichments"},{"title":"Rules and filtering","url":"/content/developer-twitter/en/docs/x-api/enterprise/rules-and-filtering"},{"title":"Rate limits","url":"/content/developer-twitter/en/docs/x-api/enterprise/rate-limits"},{"title":"Edit Tweets","url":"/content/developer-twitter/en/docs/x-api/enterprise/edit-tweets"}],"title":"Fundamentals","url":"#"},{"title":"PowerTrack API","url":"/content/developer-twitter/en/docs/x-api/enterprise/powertrack-api"},{"title":"Decahose API","url":"/content/developer-twitter/en/docs/x-api/enterprise/decahose-api"},{"title":"Account Activity API","url":"/content/developer-twitter/en/docs/x-api/enterprise/account-activity-api"},{"title":"Search API","url":"/content/developer-twitter/en/docs/x-api/enterprise/search-api"},{"title":"Engagement API","url":"/content/developer-twitter/en/docs/x-api/enterprise/engagement-api"},{"title":"Compliance Firehose API","url":"/content/developer-twitter/en/docs/x-api/enterprise/compliance-firehose-api"},{"title":"Usage API","url":"/content/developer-twitter/en/docs/x-api/enterprise/usage-api"}],"calloutLabel":"Gnip 2.0","title":"Enterprise - Gnip 2.0","url":"/content/developer-twitter/en/docs/x-api/enterprise"}],"groupUrl":"/content/developer-twitter/en/docs/x-api"},{"groupName":"X Ads API","navItems":[{"childNavItems":[{"title":"Step by step guide","url":"/content/developer-twitter/en/docs/x-ads-api/getting-started"},{"title":"Increasing access","url":"/content/developer-twitter/en/docs/x-ads-api/increasing-access"},{"title":"Subscribe for updates","url":"/content/developer-twitter/en/docs/x-ads-api/newsletter"}],"title":"Getting started","url":""},{"childNavItems":[{"title":"Hierarchy and terminology","url":"/content/developer-twitter/en/docs/x-ads-api/hierarchy-terminology"},{"title":"Accessing Ads accounts","url":"/content/developer-twitter/en/docs/x-ads-api/obtaining-ads-account-access"},{"title":"Making authenticated requests","url":"/content/developer-twitter/en/docs/x-ads-api/making-authenticated-requests"},{"title":"Error codes and responses","url":"/content/developer-twitter/en/docs/x-ads-api/response-codes"},{"title":"Rate limiting","url":"/content/developer-twitter/en/docs/x-ads-api/rate-limiting"},{"title":"Pagination","url":"/content/developer-twitter/en/docs/x-ads-api/pagination"},{"title":"Sorting","url":"/content/developer-twitter/en/docs/x-ads-api/sorting"},{"title":"Versioning","url":"/content/developer-twitter/en/docs/x-ads-api/versioning"},{"title":"Timezones","url":"/content/developer-twitter/en/docs/x-ads-api/timezones"},{"title":"Currency","url":"/content/developer-twitter/en/docs/x-ads-api/currency"},{"title":"Sandbox","url":"/content/developer-twitter/en/docs/x-ads-api/ads-api-sandbox"}],"title":"Fundamentals","url":""},{"childNavItems":[],"title":"Tools and libraries","url":"/content/developer-twitter/en/docs/x-ads-api/tools-and-libraries"},{"childNavItems":[],"title":"Analytics","url":"/content/developer-twitter/en/docs/x-ads-api/analytics"},{"childNavItems":[],"title":"Audiences","url":"/content/developer-twitter/en/docs/x-ads-api/audiences"},{"childNavItems":[],"title":"Campaign management","url":"/content/developer-twitter/en/docs/x-ads-api/campaign-management"},{"childNavItems":[],"title":"Catalog management","url":"/content/developer-twitter/en/docs/x-ads-api/catalog-management"},{"childNavItems":[],"title":"Creatives","url":"/content/developer-twitter/en/docs/x-ads-api/creatives"},{"childNavItems":[{"title":"Mobile Conversions","url":"/content/developer-twitter/en/docs/x-ads-api/measurement/mobile-conversions/overview"},{"title":"Web Conversions","url":"/content/developer-twitter/en/docs/x-ads-api/measurement/web-conversions/overview"},{"title":"AB testing","url":"/content/developer-twitter/en/docs/x-ads-api/measurement/ab-testing/overview"}],"title":"Measurement","url":""}],"groupUrl":"/content/developer-twitter/en/docs/x-ads-api"},{"groupName":"X for Websites","navItems":[{"childNavItems":[{"title":"Webpage properties","url":"/content/developer-twitter/en/docs/x-for-websites/webpage-properties"},{"title":"Javascript API","url":"/content/developer-twitter/en/docs/x-for-websites/javascript-api"},{"title":"Supported languages and browsers","url":"/content/developer-twitter/en/docs/x-for-websites/supported-languages"},{"title":"Privacy","url":"/content/developer-twitter/en/docs/x-for-websites/privacy"}],"title":"Fundamentals","url":""},{"childNavItems":[],"title":"Tools and libraries","url":"/content/developer-twitter/en/docs/x-for-websites/tools-and-libraries"},{"childNavItems":[],"title":"Embedded Tweets","url":"/content/developer-twitter/en/docs/x-for-websites/embedded-tweets"},{"childNavItems":[],"title":"Embedded timelines","url":"/content/developer-twitter/en/docs/x-for-websites/timelines"},{"childNavItems":[{"title":"Tweets","url":"/content/developer-twitter/en/docs/x-for-websites/tweet-button"},{"title":"Follow","url":"/content/developer-twitter/en/docs/x-for-websites/follow-button"},{"title":"Direct Message","url":"/content/developer-twitter/en/docs/x-for-websites/direct-message-button"}],"title":"Embedded buttons","url":""},{"childNavItems":[],"title":"Web intents","url":"/content/developer-twitter/en/docs/x-for-websites/web-intents"},{"childNavItems":[],"title":"oEmbed API","url":"/content/developer-twitter/en/docs/x-for-websites/oembed-api"},{"childNavItems":[],"title":"Log in with X","url":"/content/developer-twitter/en/docs/x-for-websites/log-in-with-twitter"},{"childNavItems":[],"title":"Optimize Tweets with X Cards","url":"/content/developer-twitter/en/docs/x-for-websites/cards"},{"childNavItems":[],"title":"Publish faster articles with AMP","url":"/content/developer-twitter/en/docs/x-for-websites/amp"},{"childNavItems":[],"title":"Integrate X with your CMS","url":"/content/developer-twitter/en/docs/x-for-websites/cms"}],"groupUrl":"/content/developer-twitter/en/docs/x-for-websites"}]}" data-search-path="https://developer.x.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">Introduction</span> </div> <div class="b27-spacing"> <div class="b27 twtr-spacing--mbf-300"> </div></div> <div class="c01-rich-text-editor"> <div class="is-table-default"> <h2>Introduction</h2> <p>Searching for Posts is an important feature used to surface X conversations about a specific topic or event. While this functionality is present in X, these endpoints provide greater flexibility and power when filtering for and ingesting Posts so you can find relevant data for your research more easily; build out near-real-time ‘listening’ applications; or generally explore, analyze, and/or act upon Posts related to a topic of interest. </p> <p>We offer two endpoints that allow you to search for Posts: Recent search and full-archive search. Both of these REST endpoints share a common design and features, including their use of a single search query to filter for Posts around a specific topic. These search queries are created with a set of operators that match on Post and user attributes, such as message keywords, hashtags, and URLs. Operators can be combined into queries with boolean logic and parentheses to help refine the queries matching behavior. </p> <p>Both the recent search and the full-archive search endpoints provide edited Post metadata. All objects for Posts created since September 29, 2022, include Post edit metadata, even if the Post was never edited. Each time a Post is edited, a new Post ID is created. A Post's edit history is documented by an array of Post IDs, starting with the original ID.</p> <p>These endpoints will always return the most recent edit, along with any edit history. Any Post collected after its 30-minute edit window will represent its final version. To learn more about Edit Post metadata, check out the <a href="/web/20241119073005/https://developer.x.com/content/developer-twitter/en/docs/twitter-api/edit-tweets">Edit Posts fundamentals</a> page.</p> <p>Once you’ve set up your query and start receiving Posts, these endpoints support navigating the results both by time and Post ID ranges. This is designed to support two common use cases: </p> <ul> <li><b>Get historical</b>: Requests are for a period of interest, with no focus on the real-time nature of the data. A single request is made, and all matching data is delivered using pagination as needed. This is the default mode for Search Posts.</li> <li><b>Polling</b> or <b>listening</b>: Requests are made in a "any new Posts since my last request?" mode. Requests are made on a continual basis, and typically there is a use case focused on near real-time 'listening' for Posts of interest.<br/> </li> </ul> <p>Many operators and query limits are exclusive to <a href="/web/20241119073005/https://developer.x.com/en/docs/twitter-api/getting-started/about-twitter-api#v2-access-level">Enterprise access</a>, meaning that you must use keys and tokens from an App within a <a href="/web/20241119073005/https://developer.x.com/en/docs/projects">Project</a> with Enterprise access to utilize the additional functionality. You can learn more about this in the endpoint sections below.</p> <p>Both the recent search and the full-archive search endpoints returned Posts contribute to the monthly <a href="/web/20241119073005/https://developer.x.com/en/docs/twitter-api/tweet-caps">Post cap</a>.</p> </div> </div> <div class="dtc09-callout-text"> <div class="dtc09-callout-text"> <div class="dtc09__item"> <div class="dtc09__color theme-bg-color--dark"></div> <div class="dtc09__text"> <div class="c01-rich-text-editor"> <div class="is-table-default"> <p><b>Account setup</b></p> <p>To access these endpoints, you will need:</p> <ul> <li>An approved <a href="/web/20241119073005/https://developer.x.com/en/portal/petition/essential/basic-info">developer account</a>.</li> <li>To authenticate using the keys and tokens from a <a href="/web/20241119073005/https://developer.x.com/en/docs/apps">developer App</a> that is located within a <a href="/web/20241119073005/https://developer.x.com/en/docs/projects">Project</a>. </li> </ul> <p>Learn more about getting access to the X API v2 endpoints in our <a href="/web/20241119073005/https://developer.x.com/en/docs/twitter-api/getting-started/getting-access-to-the-twitter-api">getting started guide</a>.</p> </div> </div> </div> </div> </div></div> <div class="c01-rich-text-editor"> <div class="is-table-default"> <h3> </h3> <h3>Recent search</h3> <p>The recent search endpoint allows you to programmatically access filtered public Posts posted over the last week, and is available to all developers who have a developer account and are using keys and tokens from an <a href="/web/20241119073005/https://developer.x.com/en/docs/apps">App</a> within a <a href="/web/20241119073005/https://developer.x.com/en/docs/projects">Project</a>.</p> <p>You can authenticate your requests with <a href="/web/20241119073005/https://developer.x.com/en/docs/authentication/oauth-1-0a">OAuth 1.0a User Context</a>, <a href="/web/20241119073005/https://developer.x.com/en/docs/authentication/oauth-2-0/application-only">OAuth 2.0 App-Only</a>, or <a href="/web/20241119073005/https://developer.x.com/en/docs/authentication/oauth-2-0/authorization-code">OAuth 2.0 Authorization Code with PKCE</a>. However, if you would like to receive private metrics, or a breakdown of organic and promoted metrics within your Post results, you will have to use OAuth 1.0a User Context or OAuth 2.0 Authorization Code with PKCE, and pass user Access Tokens that are associated with the user that published the given content. </p> <p>This endpoint can deliver up to 100 Posts per request in reverse-chronological order, and <a href="/web/20241119073005/https://developer.x.com/en/docs/twitter-api/tweets/search/integrate/paginate">pagination</a> tokens are provided for paging through large sets of matching Posts. </p> <p>When using a Project with regular access, you can use the basic set of <a href="/web/20241119073005/https://developer.x.com/en/docs/twitter-api/tweets/search/integrate/build-a-rule">operators</a> and can make queries up to 512 characters long. When using a Project with Enterprise access, you have access to additional operators. Projects with Enterprise Access can make queries up to 4096 characters long.</p> <p>Learn more about <a href="/web/20241119073005/https://developer.x.com/en/docs/twitter-api/getting-started/about-twitter-api#v2-access-level">access levels</a>.<br/> <br/> </p> <h3>Full-archive search</h3> <p>The v2 full-archive search endpoint is only available to Projects with <a title="Pro" href="https://web.archive.org/web/20241119073005/https://developer.twitter.com/en/docs/twitter-api/getting-started/about-twitter-api#v2-access-level">Pro</a> access and <a href="/web/20241119073005/https://developer.x.com/en/docs/twitter-api/getting-started/about-twitter-api#v2-access-level">Enterprise</a> access. The endpoint allows you to programmatically access public Posts from the complete archive dating back to the first Post in March 2006, based on your search query.</p> <p>You can authenticate your requests to this endpoint using <a href="/web/20241119073005/https://developer.x.com/en/docs/authentication/oauth-2-0/application-only">OAuth 2.0 App-Only</a>, and the <a href="/web/20241119073005/https://developer.x.com/en/docs/authentication/oauth-2-0/bearer-tokens">App Access Token</a> must come from an App that is within a Project that has Pro or Enterprise access. Since you cannot make a request on behalf of other users (OAuth 1.0a User Context or OAuth 2.0 Authorization Code with PKCE) with this endpoint, you will not be able to pull private <a href="/web/20241119073005/https://developer.x.com/en/docs/twitter-api/metrics">metrics</a>. </p> <p>This endpoint can deliver up to 500 Posts per request in reverse-chronological order, and <a href="/web/20241119073005/https://developer.x.com/en/docs/twitter-api/tweets/search/integrate/paginate">pagination</a> tokens are provided for paging through large sets of matching Posts.</p> <p><b>Note: </b>If requesting <a href="/web/20241119073005/https://developer.x.com/en/docs/twitter-api/annotations/overview.html" target="_self">annotations</a> through the <span class="code-inline">tweet.fields</span> parameter, the <span class="code-inline">max_results</span> parameter is currently limited to a max value of 100. This may change in the future, but please be mindful of this limitation.</p> <p>Since this endpoint is only available to those that have been approved for Pro and Enterprise access, you have access to the full set of search <a href="/web/20241119073005/https://developer.x.com/en/docs/twitter-api/tweets/search/integrate/build-a-rule">operators</a> and can make queries up to 1024 characters long.</p> <p> </p> </div> </div> <div class="ct09-justify-content"> <div class="ct09 " style="--ct09-fixed-height: ;"> <div class="ct09__item"> <div class="ct09__wrapper is-direction--row is-justified-start "> <div class="b03-button-v3 twtr-component twtr-component--first"> <a class="chirp-btn twtr-spacing--mb-500 chirp-btn--primary chirp-btn--icon chirp-btn--icon-end twtr-scribe-clicks" href="https://web.archive.org/web/20241119073005/https://developer.x.com/en/docs/twitter-api/tweets/search/quick-start.html" data-twtr-scribe-section="b03-button-v3" data-twtr-scribe-element="D4DD" data-twtr-scribe-component="quick-start" data-text="Quick start"> <div class="chirp-btn__icon"> <img class="chirp-btn__icon--img" src="https://web.archive.org/web/20241119073005im_/https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/icons/chevron_right.svg"/> </div> Quick start </a> </div> <div class="b03-button-v3 twtr-component"> <a class="chirp-btn twtr-spacing--mb-500 chirp-btn--primary chirp-btn--icon chirp-btn--icon-end twtr-scribe-clicks" href="https://web.archive.org/web/20241119073005/https://github.com/xdevplatform/Twitter-API-v2-sample-code" target="_blank" rel="noopener noreferrer" data-twtr-scribe-section="b03-button-v3" data-twtr-scribe-element="G94M" data-twtr-scribe-component="sample-code" data-text="Sample code"> <div class="chirp-btn__icon"> <img class="chirp-btn__icon--img" src="https://web.archive.org/web/20241119073005im_/https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/icons/chevron_right.svg"/> </div> Sample code </a> </div> <div class="b03-button-v3 twtr-component"> <a class="chirp-btn twtr-spacing--mb-500 chirp-btn--primary chirp-btn--icon chirp-btn--icon-end twtr-scribe-clicks" href="https://web.archive.org/web/20241119073005/https://github.com/xdevplatform/search-tweets-python" data-twtr-scribe-section="b03-button-v3" data-twtr-scribe-element="VAP5" data-twtr-scribe-component="search-posts-python-client" data-text="Search Posts Python client"> <div class="chirp-btn__icon"> <img class="chirp-btn__icon--img" src="https://web.archive.org/web/20241119073005im_/https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/icons/chevron_right.svg"/> </div> Search Posts Python client </a> </div> <div class="b03-button-v3 twtr-component"> <a class="chirp-btn twtr-spacing--mb-500 chirp-btn--primary chirp-btn--icon chirp-btn--icon-end twtr-scribe-clicks" href="https://web.archive.org/web/20241119073005/https://github.com/xdevplatform/search-tweets-ruby" data-twtr-scribe-section="b03-button-v3" data-twtr-scribe-element="A65T" data-twtr-scribe-component="search-posts-ruby-client" data-text="Search Posts Ruby client"> <div class="chirp-btn__icon"> <img class="chirp-btn__icon--img" src="https://web.archive.org/web/20241119073005im_/https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/icons/chevron_right.svg"/> </div> Search Posts Ruby client </a> </div> <div class="b03-button-v3 twtr-component"> <a class="chirp-btn twtr-spacing--mb-500 chirp-btn--primary chirp-btn--icon chirp-btn--icon-end twtr-scribe-clicks" href="https://web.archive.org/web/20241119073005/https://t.co/twitter-api-postman" data-twtr-scribe-section="b03-button-v3" data-twtr-scribe-element="D0OM" data-twtr-scribe-component="run-in-postman" data-text="Run in Postman"> <div class="chirp-btn__icon"> <img class="chirp-btn__icon--img" src="https://web.archive.org/web/20241119073005im_/https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/icons/chevron_right.svg"/> </div> Run in Postman </a> </div> <div class="b03-button-v3 twtr-component"> <a class="chirp-btn twtr-spacing--mb-500 chirp-btn--primary chirp-btn--icon chirp-btn--icon-end twtr-scribe-clicks" href="https://web.archive.org/web/20241119073005/https://developer.twitter.com/apitools/api?endpoint=/2/tweets/search/recent&method=get" target="_blank" rel="noopener noreferrer" data-twtr-scribe-section="b03-button-v3" data-twtr-scribe-element="N15A" data-twtr-scribe-component="try-with-api-explorer" data-text="Try with API Explorer"> <div class="chirp-btn__icon"> <img class="chirp-btn__icon--img" src="https://web.archive.org/web/20241119073005im_/https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/icons/chevron_right.svg"/> </div> Try with API Explorer </a> </div> <div class="b03-button-v3 twtr-component--last twtr-component"> <a class="chirp-btn twtr-spacing--mb-500 chirp-btn--primary chirp-btn--icon chirp-btn--icon-end twtr-scribe-clicks" href="https://web.archive.org/web/20241119073005/https://developer.x.com/en/docs/tutorials/developer-guide--twitter-api-toolkit-for-google-cloud" data-twtr-scribe-section="b03-button-v3" data-twtr-scribe-element="BVF7" data-twtr-scribe-component="search-and-visualize-posts-" data-text="Search and Visualize Posts "> <div class="chirp-btn__icon"> <img class="chirp-btn__icon--img" src="https://web.archive.org/web/20241119073005im_/https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/icons/chevron_right.svg"/> </div> Search and Visualize Posts </a> </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__group--top twtr-margin__group--bottom"> </div> </div> <div class="ct01-columns"> <div class="ct01 twtr-padding__paragraph--top twtr-padding__paragraph--bottom has-no-gutter "> <div class="ct01__content "> <div class="ct01__item twtr-grid "> <div class="ct01__column twtr-col-md-6 none "> <div class="ct01__wrapper "> <div class="d09-content-module twtr-component--last twtr-component twtr-component--first"> <div class="d09 d09-content-module__container"> <h2 class="d09__title twtr-type--bold-400">Supporting resources</h2> <span class="d09__title--underline twtr-color-bg--blue-dark"></span> <p class="d09__description twtr-type--roman-150"></p> <div class="d09__links"> <div class="d09__links--item"> <a href="/web/20241119073005/https://developer.x.com/en/docs/tutorials/postman-getting-started" class="d09__links--link twtr-type--roman-150 twtr-theme-color-fill--dark twtr-color-bg--blue-dark--hover" title="Learn how to use Postman to make requests"> Learn how to use Postman to make requests <svg xmlns="http://www.w3.org/2000/svg" width="28" height="72" viewbox="0 0 28 72" aria-hidden="true" focusable="false"><path d="M21.965 35L7.732 20.768a2.498 2.498 0 0 1 0-3.535 2.498 2.498 0 0 1 3.535 0l16 16a2.498 2.498 0 0 1 0 3.535l-16 16c-.487.488-1.127.732-1.767.732s-1.28-.244-1.768-.732a2.498 2.498 0 0 1 0-3.535L21.965 35z"/></svg> </a> </div> <div class="d09__links--item"> <a href="/web/20241119073005/https://developer.x.com/en/support/twitter-api" class="d09__links--link twtr-type--roman-150 twtr-theme-color-fill--dark twtr-color-bg--blue-dark--hover" title="Troubleshoot an error"> Troubleshoot an error <svg xmlns="http://www.w3.org/2000/svg" width="28" height="72" viewbox="0 0 28 72" aria-hidden="true" focusable="false"><path d="M21.965 35L7.732 20.768a2.498 2.498 0 0 1 0-3.535 2.498 2.498 0 0 1 3.535 0l16 16a2.498 2.498 0 0 1 0 3.535l-16 16c-.487.488-1.127.732-1.767.732s-1.28-.244-1.768-.732a2.498 2.498 0 0 1 0-3.535L21.965 35z"/></svg> </a> </div> <div class="d09__links--item"> <a href="/web/20241119073005/https://developer.x.com/en/docs/twitter-api/tweets/search/api-reference" class="d09__links--link twtr-type--roman-150 twtr-theme-color-fill--dark twtr-color-bg--blue-dark--hover" title="Visit the API reference page "> Visit the API reference page <svg xmlns="http://www.w3.org/2000/svg" width="28" height="72" viewbox="0 0 28 72" aria-hidden="true" focusable="false"><path d="M21.965 35L7.732 20.768a2.498 2.498 0 0 1 0-3.535 2.498 2.498 0 0 1 3.535 0l16 16a2.498 2.498 0 0 1 0 3.535l-16 16c-.487.488-1.127.732-1.767.732s-1.28-.244-1.768-.732a2.498 2.498 0 0 1 0-3.535L21.965 35z"/></svg> </a> </div> </div> </div> </div> </div> </div> <div class="ct01__column twtr-col-md-6 none "> <div class="ct01__wrapper "> <div class="d09-content-module twtr-component--last twtr-component twtr-component--first"> <div class="d09 d09-content-module__container"> <h2 class="d09__title twtr-type--bold-400">Tutorials</h2> <span class="d09__title--underline twtr-color-bg--blue-dark"></span> <p class="d09__description twtr-type--roman-150"></p> <div class="d09__links"> <div class="d09__links--item"> <a href="/web/20241119073005/https://developer.x.com/en/docs/tutorials/analyze-past-conversations" class="d09__links--link twtr-type--roman-150 twtr-theme-color-fill--dark twtr-color-bg--blue-dark--hover" title="Analyze past conversations"> Analyze past conversations <svg xmlns="http://www.w3.org/2000/svg" width="28" height="72" viewbox="0 0 28 72" aria-hidden="true" focusable="false"><path d="M21.965 35L7.732 20.768a2.498 2.498 0 0 1 0-3.535 2.498 2.498 0 0 1 3.535 0l16 16a2.498 2.498 0 0 1 0 3.535l-16 16c-.487.488-1.127.732-1.767.732s-1.28-.244-1.768-.732a2.498 2.498 0 0 1 0-3.535L21.965 35z"/></svg> </a> </div> <div class="d09__links--item"> <a href="/web/20241119073005/https://developer.x.com/en/docs/tutorials/explore-a-users-tweets" class="d09__links--link twtr-type--roman-150 twtr-theme-color-fill--dark twtr-color-bg--blue-dark--hover" title="Explore a user's Posts"> Explore a user's Posts <svg xmlns="http://www.w3.org/2000/svg" width="28" height="72" viewbox="0 0 28 72" aria-hidden="true" focusable="false"><path d="M21.965 35L7.732 20.768a2.498 2.498 0 0 1 0-3.535 2.498 2.498 0 0 1 3.535 0l16 16a2.498 2.498 0 0 1 0 3.535l-16 16c-.487.488-1.127.732-1.767.732s-1.28-.244-1.768-.732a2.498 2.498 0 0 1 0-3.535L21.965 35z"/></svg> </a> </div> <div class="d09__links--item"> <a href="/web/20241119073005/https://developer.x.com/en/docs/tutorials/building-high-quality-filters" class="d09__links--link twtr-type--roman-150 twtr-theme-color-fill--dark twtr-color-bg--blue-dark--hover" title="Building high-quality filters for getting X data"> Building high-quality filters for getting X data <svg xmlns="http://www.w3.org/2000/svg" width="28" height="72" viewbox="0 0 28 72" aria-hidden="true" focusable="false"><path d="M21.965 35L7.732 20.768a2.498 2.498 0 0 1 0-3.535 2.498 2.498 0 0 1 3.535 0l16 16a2.498 2.498 0 0 1 0 3.535l-16 16c-.487.488-1.127.732-1.767.732s-1.28-.244-1.768-.732a2.498 2.498 0 0 1 0-3.535L21.965 35z"/></svg> </a> </div> <div class="d09__links--item"> <a href="/web/20241119073005/https://developer.x.com/en/docs/tutorials/step-by-step-guide-to-making-your-first-request-to-the-twitter-api-v2" class="d09__links--link twtr-type--roman-150 twtr-theme-color-fill--dark twtr-color-bg--blue-dark--hover" title="Step-by-step guide on making a request to recent search"> Step-by-step guide on making a request to recent search <svg xmlns="http://www.w3.org/2000/svg" width="28" height="72" viewbox="0 0 28 72" aria-hidden="true" focusable="false"><path d="M21.965 35L7.732 20.768a2.498 2.498 0 0 1 0-3.535 2.498 2.498 0 0 1 3.535 0l16 16a2.498 2.498 0 0 1 0 3.535l-16 16c-.487.488-1.127.732-1.767.732s-1.28-.244-1.768-.732a2.498 2.498 0 0 1 0-3.535L21.965 35z"/></svg> </a> </div> <div class="d09__links--item"> <a href="/web/20241119073005/https://developer.x.com/en/docs/tutorials/five-ways-to-convert-a-json-object-to-csv" class="d09__links--link twtr-type--roman-150 twtr-theme-color-fill--dark twtr-color-bg--blue-dark--hover" title="Getting started with converting JSON objects to CSV"> Getting started with converting JSON objects to CSV <svg xmlns="http://www.w3.org/2000/svg" width="28" height="72" viewbox="0 0 28 72" aria-hidden="true" focusable="false"><path d="M21.965 35L7.732 20.768a2.498 2.498 0 0 1 0-3.535 2.498 2.498 0 0 1 3.535 0l16 16a2.498 2.498 0 0 1 0 3.535l-16 16c-.487.488-1.127.732-1.767.732s-1.28-.244-1.768-.732a2.498 2.498 0 0 1 0-3.535L21.965 35z"/></svg> </a> </div> <div class="d09__links--item"> <a href="/web/20241119073005/https://developer.x.com/en/docs/tutorials/getting-historical-tweets-using-the-full-archive-search-endpoint" class="d09__links--link twtr-type--roman-150 twtr-theme-color-fill--dark twtr-color-bg--blue-dark--hover" title="A guide to full-archive search, for academic researchers"> A guide to full-archive search, for academic researchers <svg xmlns="http://www.w3.org/2000/svg" width="28" height="72" viewbox="0 0 28 72" aria-hidden="true" focusable="false"><path d="M21.965 35L7.732 20.768a2.498 2.498 0 0 1 0-3.535 2.498 2.498 0 0 1 3.535 0l16 16a2.498 2.498 0 0 1 0 3.535l-16 16c-.487.488-1.127.732-1.767.732s-1.28-.244-1.768-.732a2.498 2.498 0 0 1 0-3.535L21.965 35z"/></svg> </a> </div> <div class="d09__links--item"> <a href="/web/20241119073005/https://developer.x.com/en/docs/tutorials/developer-guide--twitter-api-toolkit-for-google-cloud" class="d09__links--link twtr-type--roman-150 twtr-theme-color-fill--dark twtr-color-bg--blue-dark--hover" title="Process, analyze, and visualize Posts with Google Cloud"> Process, analyze, and visualize Posts with Google Cloud <svg xmlns="http://www.w3.org/2000/svg" width="28" height="72" viewbox="0 0 28 72" aria-hidden="true" focusable="false"><path d="M21.965 35L7.732 20.768a2.498 2.498 0 0 1 0-3.535 2.498 2.498 0 0 1 3.535 0l16 16a2.498 2.498 0 0 1 0 3.535l-16 16c-.487.488-1.127.732-1.767.732s-1.28-.244-1.768-.732a2.498 2.498 0 0 1 0-3.535L21.965 35z"/></svg> </a> </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-tab-title="Search Tweets" data-header-title="Search Tweets" data-tab-root-page="/content/developer-twitter/en/docs/x-api/tweets/search" data-sidenav-json="[{"isActive":true,"hasActiveChild":false,"children":[],"overviewTitle":"Search Tweets introduction","linkDisabled":false,"title":"Search Tweets introduction","path":"https://developer.x.com/en/docs/x-api/tweets/search/introduction"},{"isActive":false,"hasActiveChild":false,"children":[{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Recent search quick start","linkDisabled":false,"title":"Recent search quick start","path":"https://developer.x.com/en/docs/x-api/tweets/search/quick-start/recent-search"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Full-archive search quick start","linkDisabled":false,"title":"Full-archive search quick start","path":"https://developer.x.com/en/docs/x-api/tweets/search/quick-start/full-archive-search"}],"overviewTitle":"Quick start","linkDisabled":false,"title":"Quick start","path":"https://developer.x.com/en/docs/x-api/tweets/search/quick-start/recent-search"},{"isActive":false,"hasActiveChild":false,"children":[{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Search Tweets - How to build a query","linkDisabled":false,"title":"Search Tweets - How to build a query","path":"https://developer.x.com/en/docs/x-api/tweets/search/integrate/build-a-query"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Search Tweets - How to paginate","linkDisabled":false,"title":"Search Tweets - How to paginate","path":"https://developer.x.com/en/docs/x-api/tweets/search/integrate/paginate"}],"overviewTitle":"Search Tweets integration reference","linkDisabled":false,"title":"Search Tweets integration reference","path":"https://developer.x.com/en/docs/x-api/tweets/search/integrate"},{"isActive":false,"hasActiveChild":false,"children":[{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Search Tweets standard v1.1 to v2 migration guide","linkDisabled":false,"title":"Search Tweets standard v1.1 to v2 migration guide","path":"https://developer.x.com/en/docs/x-api/tweets/search/migrate/standard-to-twitter-api-v2"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"Search Tweets enterprise to v2 migration guide","linkDisabled":false,"title":"Search Tweets enterprise to v2 migration guide","path":"https://developer.x.com/en/docs/x-api/tweets/search/migrate/enterprise-to-twitter-api-v2"}],"overviewTitle":"Search Tweets version comparison","linkDisabled":false,"title":"Search Tweets version comparison","path":"https://developer.x.com/en/docs/x-api/tweets/search/migrate"},{"isActive":false,"hasActiveChild":false,"children":[{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"GET /2/tweets/search/recent","linkDisabled":false,"title":"GET /2/tweets/search/recent","path":"https://developer.x.com/en/docs/x-api/tweets/search/api-reference/get-tweets-search-recent"},{"isActive":false,"hasActiveChild":false,"children":[],"overviewTitle":"GET /2/tweets/search/all","linkDisabled":false,"title":"GET /2/tweets/search/all","path":"https://developer.x.com/en/docs/x-api/tweets/search/api-reference/get-tweets-search-all"}],"overviewTitle":"API reference","linkDisabled":false,"title":"API reference","path":"https://developer.x.com/en/docs/x-api/tweets/search/api-reference"}]" 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="https://web.archive.org/web/20241119073005/https://developer.x.com/en/more/developer-terms/agreement-and-policy" 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/20241119073005/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/20241119073005/https://developer.x.com/en/twitterdev-news-subscription" rel="noopener noreferrer" target="_blank" data-twtr-scribe-section="b03-button" data-twtr-scribe-element="088O" data-twtr-scribe-component="subscribe-to-developer-news" data-text="Subscribe to developer news">  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/20241119073005/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/20241119073005/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/20241119073005/https://help.x.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/20241119073005/https://publish.x.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/20241119073005/https://privacy.x.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/20241119073005/https://transparency.x.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> <li class="u02__link-item"> <a href="https://web.archive.org/web/20241119073005/https://help.x.com/using-x/download-the-x-app" title="Download the X app" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> Download the X app </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/20241119073005/https://about.x.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/20241119073005/https://blog.x.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/20241119073005/https://about.x.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/20241119073005/https://careers.x.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/20241119073005/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/20241119073005/https://help.x.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/20241119073005/https://help.x.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/20241119073005/https://create.x.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/20241119073005/https://business.x.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/20241119073005/https://help.x.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/20241119073005/https://preferencecenter.x.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/20241119073005/https://help.x.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/20241119073005/https://help.x.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/20241119073005/https://developer.x.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/20241119073005/https://developer.x.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/20241119073005/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/20241119073005/https://developer.x.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/20241119073005/https://blog.x.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/20241119073005/https://blog.x.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/20241119073005/https://developer.x.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/20241119073005/https://business.x.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/20241119073005/https://business.x.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/20241119073005/https://business.x.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/20241119073005/https://marketing.x.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/20241119073005/https://marketing.x.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/20241119073005/https://marketing.x.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/20241119073005/https://www.xadsacademy.com/sl/5c3e29ed" title="X Ads Academy" target="_blank" class="u02__link twtr-type--roman-14 twtr-color--gray-0 is-opaque has-hover"> X Ads Academy </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"> © 2024 X Corp. </span> </div> <div class="u02__column u02__column--bottom"> <a href="https://web.archive.org/web/20241119073005/https://help.x.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/20241119073005/https://x.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/20241119073005/https://x.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/20241119073005js_/https://platform.twitter.com/widgets.js"></script> <div id="page-props" data-page-title="Search Tweets introduction" data-page-path="/content/developer-twitter/en/docs/x-api/tweets/search/introduction"> </div> <script type="text/javascript" src="https://web.archive.org/web/20241119073005js_/https://cdn.cms-twdigitalassets.com/etc/designs/developer2-twitter/public/js/core.js.twhash.p.f.69ab45e5cc5f1ff23c02417e39e6fd30.js"></script> <script type="text/javascript" src="https://web.archive.org/web/20241119073005js_/https://cdn.cms-twdigitalassets.com/etc/designs/developer2-twitter/public/js/project.js.twhash.p.f.4b50ff616821ce2f51bb2cd7cb3aa61e.js"></script> <script src="https://web.archive.org/web/20241119073005js_/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/> X 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/20241119073005/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="JJHQ" 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="JJHQ" 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/20241119073005cs_/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/20241119073005js_/https://cdn.cms-twdigitalassets.com/etc/designs/common-twitter/clientlib-u12-data-protection-notice.min.twhash.p.cl.3734d48c62d11c8682b708637c1691ea.js"></script> </div> </body> </html>

CINXE.COM

Search Tweets introduction | Docs | Twitter Developer Platform