X (Twitter) Walkthrough
  • 2 Minutes to read
  • Dark
  • PDF

X (Twitter) Walkthrough

  • Dark
  • PDF

Article Summary

X API version 11 is currently supported

This page provides a general description of X and its capabilities.


X connection.

How to pull data from X using Rivery

  1. Select 'Create New River' from the top right of the Rivery console.
  2. Choose 'Data Source to Target' as your river type.
  3. In the 'General Info' tab, name your river, describe it and choose a group.
  4. Navigate to the 'Source' tab.
  5. Select X from the list of data sources (under Marketing).
  6. Under Source Connection, select the connection you created, or create a new one. 
  7. Start to build your X river by selecting your desired report - "statistics" or "entity".

Ads Statistics Report

  1. Select the accounts that you'd like to pull for the report.  Leave this input empty to pull the results for all available accounts. 
  2. Select which entity to pull. Each entity has its own related inputs.
  3. Select the desired Metric group and Placements.
  4. Select how to filter the report. Each entity has its own related filters.
  5. Select the time period of the report.
    • Instructions if selecting ‘Date Range’:
      • Select the start date and end date.
      • Leave the end date empty in to pull data until the moment the river runs.
      • After each run of the river, the start date will be updated automatically with the end date, and the end date will be updated with the empty value. This enables the next run to pull data from the end of the previous run.
      • Select the time zone offset. It will be relevant only if the end date is empty in order to find the moment of the river’s run according to the time zone.
      • Days back - use this input to tell Rivery to pull data from the given days back before the given start date.
    • Please Note:

      The Start Date won't be advanced if a River run is unsuccessful.

      If you don't want this default setting, click More Options and check the box to advance the start date even if the River run is unsuccessful (Not recommended).

    • Instructions if selecting any other value:
      • Select the timezone offset to send the correct dates that consider that offset.
      • Note: A maximum time range (end_time - start_time) of 90 days is allowed for non-segmented queries. For segmented queries, the maximum time range is 45 days.
    • Time resolution - Select how the results will be grouped.
      1. Each record in the report will contain the metrics of the selected time resolution.
        For example: Running a report for dates 1.1.20-10.1.20 and a Daily Time Resolution will return records for each day in this time period (multiple rows because each day might have many ads/campaigns etc.). Weekly time resolution will return records for the first week and second week in that time period.

Note: Statistics and Campaigns rows do not appear if there is no data on the chosen day.

Ads Entity Report

  1. Select which entity to pull. Each entity has its own related inputs.
  2. Select the accounts of the chosen entity.  Leave this input empty to pull the results for all the available accounts.
  3. Select between trimming users or not. When set to 'True' each Tweet returned in a timeline will include a user object including only the status author's numerical ID. When set to 'False' the complete user object is returned. 

Was this article helpful?