Built in

X Ads

X Ads accounts, campaigns and stats through SegmentStream's X application. Tokens and their secrets stay with the platform.

What the connection reaches

  • Ads accounts
  • Campaigns, line items and promoted posts
  • Account stats
Status
Built into the pipeline SDK
Connection class
XAdsConnection
Credential
X account with access to the ads accounts

Connect X Ads

Three steps, the same for every connection. The credential goes to the platform, never into the repository or pipeline code.

  1. 1

    Declare it in connections/connections.py

    connections/connections.py
    from segmentstream.connections import XAdsConnection connections = (    XAdsConnection(key="x_ads"),)
  2. 2

    Deploy

    $ segmentstream deploy
  3. 3

    Connect

    Open the connection in the console and sign in with the X account that manages your ads accounts, or authorise it from the terminal. Tokens are refreshed by the platform; pipeline code never sees them.

    $ segmentstream connection authorize x_ads --open

Use it

Code asks for the connection by its key. The platform adds the credential on the way out.

pipeline/ingestion/…
import segmentstream as s with s.get_connection("x_ads").get_http_client() as client:    response = client.get("/accounts")    response.raise_for_status()

Or ask your agent

“Connect X Ads and load daily stats by campaign.”

Part of these solutions

More in Advertising

Enterprise pilot

Want X Ads set up for you?

Our forward-deployed engineers build one solution on your data, in your own workspace, as code you own. Tell us what you run today and what you want; your note goes straight to our founder.

  • One solution, on your data, in your own workspace
  • First version live in two weeks
  • Parity proven before anything is switched off
  • Fixed scope and price, credited to your contract if you continue

Not ready for a pilot? Send the form anyway with your question. An engineer will reply, not a sales rep.

How the pilot works

Goes to our founder’s inbox. No sales queue, no newsletter.

Connect what your company runs.

Start a pilot

Our engineers build the first version on your data in two weeks, at a fixed price.

Or join the waitlist for self-serve:

We’ll email you product updates, tips and onboarding help. Unsubscribe anytime.

Self-serve opens to the waitlist first.