Skip to Content

X

X connections give you access to your account and advertisement campaign data.

Source Setup

You will need a X App in order to create a connection with Etleap. Please perform the following steps to create the App in your X account.

Step 1. Apply for a Developer Account

If you haven’t created an app with X before, you’ll need to apply for a X Development Account. If you already have a development account, skip the first section and proceed to Step 2. Create your X App.

  1. Go to X’s developers portal app page .
  2. Complete the form and submit the application.
X Name page
  1. Verify your email address with X to create the new App.

Step 2. Create your X App

  1. Go to X’s developers portal app page .
  2. If you just created your developer account you will be prompted to create an App. Name your app and go to step 5 below.
Untitled (2).png
  1. Navigate to your developer dashboard and select Add App.

  2. Enter your App name (e.g., “MyCompany Etleap App”).

  3. Go to Products → X API V2 to check if you have Elevated Access.

  4. If you don’t, click Apply. Untitled (3).png

  5. Fill the form, describing your use-case. The application is typically automatically approved, but there are minimum character requirements. Please feel free to use similar answers as below, tailored for your use-case.

    Untitled (4).png Untitled (5).png

Create a new project (only required for API V2)

  1. On your developer dashboard click New Project.
  2. Enter a project name, description and use case.
  3. Click on the project name on your dashboard.
  4. Attach the app that you’ve created to your project.

Step 3. Apply for Ads API Access (only required for X API)

  1. Go to the Ads API Application Form .
  2. Complete the application questions listed below:
    1. Of the following, which best describes your business? Advertiser

    2. How will you use the Ads API? Analytics

    3. What do you plan to build on the Ads API? Provide access for Etleap (X app ID 17321464)

    4. Describe your unique differentiators in the Ad Tech ecosystem. Not applicable; we are not Ad Tech, only pulling our own data.

    5. Does your product currently use or plan to utilize any other X APIs? No, unless you do for reasons unrelated to Etleap.

    6. Do you license data from X’s Data APIs? No, unless you do for reasons unrelated to Etleap.

Step 4. Obtain your Credentials

  1. Access X’s developers portal app page  and go to your App Page.
  2. Under the Keys and Tokens tab, click Generate/Regenerate an API Key and Secret and an Access Token and Secret. You will need these values to create a X connection in Etleap.
Consumer Keys page
Note

Prefer using an API? Go here  and select X under the Body header to start creating your connection via API.

What Data is Available?

Warning

Update-Mode Deletes Support

Deletes are not supported for update-mode entities with this connector.

You can create X pipelines with the following entities:

EntityPipeline ModeAPIIceberg Support
Ads Account Replacev1.1/AdsBatch
Ads Campaign Replacev1.1/AdsBatch
Ads Funding Instrument Replacev1.1/AdsBatch
Ads Line Item Replacev1.1/AdsBatch
Ads Media Creative Replacev1.1/AdsBatch
Ads Promoted Tweet Replacev1.1/AdsBatch
Account Ads Report UpdateAds-
Campaign Ads Report UpdateAds-
Funding Instrument Ads Report UpdateAds-
Line Item Ads Report UpdateAds-
Media Creative Ads Report UpdateAds-
Promoted Tweet Ads Report UpdateAds-
Followers Replacev2Batch
Tweets Replacev2Batch
Tweets Likes Replacev2Batch
Retweets Replacev2Batch
Quote Tweets Replacev2Batch
Recent Mentions Replacev2Batch
Users Replacev2Batch
Note

API Access Levels

Please note that all entities under the v2 API require at least Basic  level access to the X API to create pipelines from them.