Developers
Our platform was built to be flexible and intuitive for developers like you. You own all the data you collect with Tradable Bits. Our API and SDK are designed to make it easy to access your fan data, tickets and campaigns at any time, on your terms. Customize the front end of any of your campaigns with the help of our documentation, complete with examples. Our RESTful API helps you access, send or receive fan data from our system to your endpoints quickly and securely. Enrich your Fan CRM and Tickets Analytics with data from other CRM systems through our many integrations. Have any questions about our developers platform? Our support team is happy to help.
Tradable Bits Server API
Most of CRM Data can be accessed with our HTTP based API. Calls should be sent as application/x-www-form-urlencoded and will return JSON data. Authentication is handled using API Keys. The system recognises two form of keys: Public and Secret. Public is meant to be shared and can be used in insecure environments whereas Secret key is reserved for server-to-server communications and must be kept private. Api keys can be sent either in the request body as api_key and api_secret or as headers using Api-Key and Api-Secret. You can manage key under profile section once you log into Tradable Bits.
NEVER EXPOSE API SECRET IN NON SECURE ENVIRONMENT E.G. BROWSER OR MOBILE APP.
THIS KEY MUST BE KEPT SECURE ON YOUR SERVER SIDE.
This Call Requires api_secret as
additional parameter
Calls with Lock icon are meant for data exchange or called from the server side.
Each call must include api_secret as either GET or POST parameter
This Call Requires api_key as
additional parameter
Calls with UnLock icon are meant to be integrated into mobile or web applications and require
api_key as additional parameter for all requests
Introduction
Console
crm
GET /v1/crm/activity_stats
GET /v1/crm/campaigns
GET /v1/crm/activities
POST /v1/crm/activities
GET /v1/crm/activities/<page_tab_id>/leaderboard
GET /v1/crm/fan_tags
GET /v1/crm/fans
GET /v1/crm/fan_updates
GET /v1/crm/points
GET /v1/crm/tickets
GET /v1/crm/tickets/<ticket_id>
POST /v1/crm/tickets
POST /v1/crm/bulk_tickets
GET /v1/crm/tickets/events
POST /v1/crm/tickets/events
GET /v1/crm/ticket_stats
GET /v1/crm/registrations
POST /v1/crm/registrations
POST /v1/crm/fans
GET /v1/crm/fans/<fan_id>
POST /v1/crm/fans/<fan_id>
DELETE /v1/crm/fans/<fan_id>
GET /v1/crm/fans/<fan_id>/networks
POST /v1/crm/fans/<fan_id>/networks
GET /v1/crm/fans/<fan_id>/points
POST /v1/crm/fans/<fan_id>/points
POST /v1/crm/fans/<fan_id>/merge
GET /v1/crm/fans/<fan_id>/idols
POST /v1/crm/fans/<fan_id>/idols
GET /v1/crm/fans/<fan_id>/registrations
POST /v1/crm/fans/<fan_id>/registrations
GET /v1/crm/fans/<fan_id>/activities
POST /v1/crm/fans/<fan_id>/activities
GET /v1/crm/fields
GET /v1/crm/search_filters
GET /v1/crm/fan_stats
GET /v1/crm/monitored_ip_addresses
POST /v1/crm/monitored_ip_addresses
DELETE /v1/crm/monitored_ip_addresses
streams
GET /v1/streams
POST /v1/streams
GET /v1/streams/<stream_key>/records
POST /v1/streams/<stream_key>/records
GET /v1/streams/<stream_key>
GET /v1/streams/<stream_key>/<feed_record_id>
POST /v1/streams/<stream_key>/<feed_record_id>
GET /v1/streams/<stream_key>/<feed_record_id>/broken
sessions
POST /v1/sessions/wifi_fans
POST /v1/sessions/idol_fans
POST /v1/sessions/signup
POST /v1/sessions/connect
GET /v1/sessions/<session_uid>
GET /v1/sessions/<session_uid>/fan
POST /v1/sessions/<session_uid>/fan
GET /v1/sessions/<session_uid>/networks
POST /v1/sessions/<session_uid>/networks
GET /v1/sessions/<session_uid>/tickets
POST /v1/sessions/<session_uid>/tickets
GET /v1/sessions/<session_uid>/registrations
POST /v1/sessions/<session_uid>/registrations
GET /v1/sessions/<session_uid>/points
GET /v1/sessions/<session_uid>/activities
POST /v1/sessions/<session_uid>/activities
GET /v1/sessions/<session_uid>/idols
POST /v1/sessions/<session_uid>/idols
GET /v1/sessions/<session_uid>/fan_events
POST /v1/sessions/<session_uid>/fan_events
POST /v1/sessions/<session_uid>/mediastream_token
idols
POST /v1/idols
GET /v1/idols
GET /v1/idols/<idol_uid>
GET /v1/idols/<idol_uid>/rel_artists
GET /v1/idols/events
GET /v1/idols/events/<event_uid>
misc
GET /v1/trackers
GET /v1/trackers/<tracker_id>
POST /v1/trackers
GET /v1/props/<prop_name>
GET /v1/geoip
GET /v1/phone_check
GET /v1/shp_lookup
POST /v1/yinzcam_subscription
GET /v1/account_ad_stats
GET /v1/performances
GET /v1/performances/<performance_uid>
POST /v1/performances
POST /v1/performances/<performance_uid>
DELETE /v1/performances/<performance_uid>
GET /v1/template_portals
GET /v1/template_portals/<portal_uid>
POST /v1/template_portals
POST /v1/template_portals/<portal_uid>
DELETE /v1/template_portals/<portal_uid>
apps
GET /v1/apps
GET /v1/businesses
GET /v1/businesses/<business_id>
GET /v1/apps/<page_tab_id>/bundle_stats
GET /v1/apps/<page_tab_id>/stats
GET /v1/apps/<page_tab_id>/detailed_stats
GET /v1/apps/<page_tab_id>/props
GET /v1/apps/<page_tab_id>
GET /v1/apps/<page_tab_id>/total_points
GET /v1/apps/<page_tab_id>/wager_entries
GET /v1/apps/<page_tab_id>/simple_points
GET /v1/apps/<page_tab_id>/simple_activities
POST /v1/apps/<page_tab_id>/registration/checkin
fanxp
GET /v1/fanxp/<page_tab_id>
GET /v1/fanxp/<page_tab_id>/ip_address
GET /v1/fanxp/<page_tab_id>/chat_messages
GET /v1/fanxp/<page_tab_id>/fan_friends
POST /v1/fanxp/<page_tab_id>/fan_friends
GET /v1/fanxp/<page_tab_id>/fan_friend_requests
POST /v1/fanxp/<page_tab_id>/fan_friend_requests
GET /v1/fanxp/<page_tab_id>/chat_history
POST /v1/fanxp/<page_tab_id>/clicker
POST /v1/fanxp/<page_tab_id>/points
POST /v1/fanxp/<page_tab_id>/report_chat
POST /v1/fanxp/<page_tab_id>/answer
GET /v1/fanxp/<page_tab_id>/answer
GET /v1/fanxp/<page_tab_id>/leaderboard
GET /v1/fanxp/<page_tab_id>/event_stats
GET /v1/fanxp/<page_tab_id>/player_stats
GET /v1/fanxp/<page_tab_id>/vod
GET /v1/fanxp/<page_tab_id>/live_endpoints
GET /v1/fanxp/<page_tab_id>/chat_room
POST /v1/fanxp/<page_tab_id>/chat_room
GET /v1/fanxp/<page_tab_id>/fan_lookup
API Console
API Access allows you to query Stream and user data using RESTful API, as well as register for push notification from our CRM system. API Reference is broken into sections by topic: Meta Apps (Campaigns) Data, Stream Data, CRM Data.
Each Request must include api_key as parameter. You can generate an API key in the Manage Centre.
You may try most of our API calls here. Your API Key will be automatically appended if available.
Crm Calls
GET /v1/crm/activity_stats
Description
Aggregate Call to obtain counters based on the custom values in fan activities
Input Parameters
| campaign_title | Name of custom campaign |
| property_name | Name of the property to track |
Result
Array of Counters
Resulting Structure
| account_id | |
| campaign_title | |
| property_name | |
| counter |
GET /v1/crm/campaigns
Description
Get a list of Campaigns on the account.
Input Parameters
| q | Text based filter to specific campaigns |
Result
Array of structures
Resulting Structure
| account_id | |
| title | |
| page_tab_id | |
| stream_key | |
| app_type | |
| is_active | |
| creation_timestamp | |
| winner_fan_id |
GET /v1/crm/activities
Description
Download incremental list of activities for the account.Paging is implemented with help of usage of max_activity_id and mix_activity_id parameters. In the first call, system will include in meta information about given IDs. Now, by supplying min_activity_id you can fetch next batch of records.
Input Parameters
| min_activity_id | Window Specifier. Will return only activities with activity_id greater than given |
| max_activity_id | Window Specifier. Will return only activities with activity_id less than given |
| limit | Optional parameter to specify max row count. Max. allowed value is 200 |
| page_tab_id | Optional Filter to participants of specific campaign |
| activity_date | Optional Filter to participants for specific date |
| include_details | Include additional details: fan, idols, connections |
Result
Structure: {'meta': { 'order':'desc/asc','min_activity_id':xxx,'max_activity_id':xxx},'data':[] }. Data is array with following elements
Resulting Structure
| activity_id | Unique Identifier for the activity |
| account_id | Tradable Bits Account ID |
| fan_id | Unique Identifier for the fan record |
| creation_date | ISO Date of activity |
| campaign_title | Title of the campaign |
| app_type | For contests - type of contest |
| page_tab_id | Contest ID reference (set for contests only) |
| opted_in_business_ids | Opted in business ids of the fan |
| is_subscribed | OptIn flag on this activity |
| creation_timestamp | ISO timestamp of activity |
| page_tab_id | Campaign ID reference |
| stream_key | If activity is tied to stream - reference for stream |
| ip_address | IP Address |
| user_key | Facebook/Spotify/etc User Key |
| name | Full Name |
| details | JSON structure of campaign details (varies by campaign) |
| fan | Fan Structure as per documentation |
| networks | List of connected networks |
| idol_names | List of connected Idols |
POST /v1/crm/activities
Description
Submit new Activity as well as Fan details for data integration
Input Parameters
| first_name | |
| last_name | |
| phone | |
| campaign_title | |
| province | |
| postal_code | |
| country_code | |
| is_subscribed | |
| is_phone_subscribed |
Result
Structure matching the input with validated fields
GET /v1/crm/activities/<page_tab_id>/leaderboard
Description
Fetch top 10 performing fans for a campaign
Input Parameters
| show_hidden | Show fans who are hidden from the public leaderboard in the campaign. Default = False |
| limit | Limit the number of fans fetched from the leaderboard. Default = 10 |
Result
An array of structures with following fields
Resulting Structure
| rank | Leaderboard rank |
| fan_id | Unique Identifier for the fan record |
| display_name | |
| is_hidden | If the fan is hidden from the public leaderboard in the campaign (If applicable) |
| activity_timestamp | Timestamp of when the fan completed the activity (If applicable) |
| points | Number of points gained in the campaign (If applicable) |
| balance | Balance within the campaign (If applicable) |
| activity_duration_ms | Length of time spent for the campaign activity in ms (If applicable) |
| correct_count | Number of questions answered correctly (If applicable) |
GET /v1/crm/fan_tags
Description
Fetch a list of existing crm fan tags for the purposes of synchronization. Request is limited to 10000 records max in a single result set.
Input Parameters
| start_date | Window Specifier. Will return only tags with creation timestamp greater than given |
| end_date | Window Specifier. Will return only tags with creation timestamp less than given |
Result
Array
Resulting Structure
| tag_name | |
| tag_id | |
| fan_id | |
| creation_timestamp | |
| first_name | |
| last_name | |
GET /v1/crm/fans
Description
Search for Fan records using CRM Search interface
Input Parameters
| name | Name or Email of the person in question |
| crm_active_days | |
| crm_inactive_days | |
| crm_start_active_date | |
| crm_end_active_date | |
| fan_youngest_age | |
| fan_oldest_age | |
| fan_incl_snapshot_uids | |
| fan_excl_snapshot_uids | |
| fan_tags | |
| fan_tag_relations | |
| fan_networks | |
| fan_is_subscribed | |
| fan_is_optout | |
| fan_is_phone_subscribed | |
| fan_postal_codes | |
| fan_provinces | |
| fan_rating | |
| fan_gender | |
| fan_metro_areas | |
| fan_start_creation_date | Format YYYY-MM-DD |
| fan_end_creation_date | Format YYYY-MM-DD |
| idol_names | |
| idol_affinity_score | |
| idol_relations | |
| ticket_event_name | |
| ticket_price_code | |
| ticket_start_purchase_date | |
| ticket_end_purchase_date | |
| ticket_venue_name | |
| ticket_venue_provinces | |
| ticket_purchased_days | |
| ticket_artist_name | |
| ticket_start_event_date | |
| ticket_end_event_date | |
| query_line | |
| ticket_seat_price_min | |
| ticket_seat_price_max | |
| ticket_seat_count_min | |
| ticket_seat_count_max | |
| ticket_sales_count_min | |
| ticket_sales_count_max | |
| ticket_is_negative | |
| search_uid | If this parameter is supplied, we will continue returning records from previous search execution |
| limit | Maximum page size. Has to be less than a 1000 |
| max_count | Maximum total number of records retrieved. Max value of 1,000,000. Default = 100,000 |
Result
Array with Meta structure as part of result
Resulting Structure
| fan_id | |
| account_id | |
| name | |
| first_name | |
| last_name | |
| province | |
| latitude | |
| longitude | |
| login_name | |
| creation_timestamp | |
| ip_address | |
| country_code | |
| city | |
| is_subscribed | |
| is_phone_subscribed | |
| rating | |
| phone | |
| birth_date | |
| metro_area | |
| postal_code | |
| fields | |
| gender | |
| tags | |
| last_page_tab_id | |
| last_campaign_name | |
| opted_in_business_ids |
GET /v1/crm/fan_updates
Description
Get the latest updated fans. The last_update_date parameter can be used to get fans which were updated after a particular date. The min_time_key can be used to fetch the next page of updated fans. Each page has a size limit of 1000.
Input Parameters
| last_update_date | Optional. yyyy-mm-dd. Gets latest fans having last update date after this date. |
| min_time_key | Optional. The time key used to fetch the next page of updated fans. The format is '<unix_time>_<milliseconds>_<fan_id>'. Use the max_fan_time_key returned in the meta structure of previous request for fetching the next page. |
Result
Structure: {'meta': { 'min_fan_time_key':'xxx', 'max_fan_time_key':xxx, 'count':xxx }, 'data':[] }. Data is array with following elements
Resulting Structure
| fan_id | |
| login_name | |
| account_id | |
| first_name | |
| last_name | |
| latitude | |
| longitude | |
| city | |
| province | |
| country_code | |
| metro_area | |
| postal_code | |
| ip_address | |
| is_optout | |
| is_subscribed | |
| is_phone_subscribed | |
| gender | |
| rating | |
| birth_date | |
| phone | |
| add_phone | |
| is_confirmed | |
| is_phone_confirmed | |
| display_name | |
| tags | |
| fields | |
| last_page_tab_id | |
| last_campaign_name | |
| fan_time_key | |
| creation_timestamp | |
| last_update_timestamp | |
| creation_timestamp_iso | ISO creation timestamp |
| last_update_timestamp_iso | ISO last update timestamp |
GET /v1/crm/points
Description
Get a fan leaderboard based on provided filters
Input Parameters
| start_date | yyyy-mm-dd |
| end_date | yyyy-mm-dd |
| point_name |
Result
Array with Meta structure as part of result
Resulting Structure
| fan_id | |
| first_name | |
| last_name | |
| fan_point_count | number of points based of filter |
| rank | rank of fan among all fans based on filter |
GET /v1/crm/tickets
Description
Download incremental list of tickets for the account. Paging is implemented with help of usage of max_ticket_id and min_ticket_id parameters. In the first call, system will include in meta information about given IDs. Now, by supplying min_ticket_id you can fetch next batch of records.
Input Parameters
| min_ticket_id | Window Specifier. Will return only tickets with ticket_id greater than given |
| max_ticket_id | Window Specifier. Will return only tickets with ticket_id less than given |
| min_purchase_date | Date filter option. Will return only tickets on or after a given date |
| max_purchase_date | Date filter option. Will return only tickets on or prior to a given date |
| min_last_update_date | Date filter option. Will return only tickets on or after a given date |
| max_last_update_date | Date filter option. Will return only tickets on or prior to a given data |
| Optionally this parameter allows you to filter tickets to specific user/email address | |
| limit | Optional parameter to specify max row count. Max. allowed value is 3000 |
| data | Additional fields to include: supported value: fan |
| include_deleted | Optional parameter. If set to true, return will include deleted tickets. |
Result
Structure: {'meta': { 'order':'desc/asc','min_ticket_id':xxx,'max_ticket_id':xxx},'data':[] }. Data is array with following elements
Resulting Structure
| ticket_id | Unique Identifier for the ticket |
| ticket_key | Remote Tickey Key |
| account_id | Tradable Bits Acount ID |
| email on the ticket | |
| network | type of remote network to fetch ticket |
| event_key | Event Key in remote system |
| event_date | ISO date of the event |
| event_name | Event Name |
| purchase_timestamp | ISO Date |
| paid_amount | Total Paid Amount |
| num_seats | Number of tickets/seats on the purchase |
| artist_name | Artist Name |
| price_code | Price Code or Level |
| venue_name | Name of Venue |
| city | City |
| province | Province or State |
| country_code | ISO country code |
| metro_area | DMA or CMA Area (Currently only for US/CA) |
| postal_code | Postal Code / ZIP |
| customer_key | ID of customer in remote system |
| is_deleted | True if ticket deleted |
| last_updated_timestamp | ISO date of last update |
GET /v1/crm/tickets/<ticket_id>
Description
Get single ticket by ticket id
Result
Single record. Data is array with following elements
Resulting Structure
| ticket_id | Unique Identifier for the ticket |
| ticket_key | Remote Tickey Key |
| account_id | Tradable Bits Acount ID |
| email on the ticket | |
| network | type of remote network to fetch ticket |
| event_key | Event Key in remote system |
| event_date | ISO date of the event |
| event_name | Event Name |
| purchase_timestamp | ISO Date |
| paid_amount | Total Paid Amount |
| num_seats | Number of tickets/seats on the purchase |
| artist_name | Artist Name |
| price_code | Price Code or Level |
| venue_name | Name of Venue |
| city | City |
| province | Province or State |
| country_code | ISO country code |
| metro_area | DMA or CMA Area (Currently only for US/CA) |
| postal_code | Postal Code / ZIP |
| customer_key | ID of customer in remote system |
| is_deleted | True if ticket deleted |
| last_updated_timestamp | ISO date of last update |
POST /v1/crm/tickets
Description
Create new ticket and Corresponding Fan Record
Input Parameters
| first_name | Required. |
| last_name | Required. |
| phone | |
| Required. | |
| customer_key | Key of the customer in the remote system |
| ticket_key | Optional. Unique identifier for the line item (i.e. unique per price code and amount). |
| purchase_timestamp | Required. YYYY-MM-DD HH:MI:SS in GMT timezone |
| paid_amount | Required. Numeric value for line item |
| num_seats | Required. Number of seats purchased |
| price_code | Optional. Price level or code of line item |
| is_subscribed | Subscribed to email |
| is_phone_subscribed | Subscribed to phone |
| city | |
| province | |
| postal_code | |
| country_code | |
| event_date | Required. ISO8601 Encoded String |
| event_name | Required. |
| artist_name | |
| venue_name | |
| event_key | |
| network | |
| order_key | |
| is_deleted | Optional. Boolean Value |
Result
Created Record. Data will be returned as it was loaded in the system. I.e. sanitized
Resulting Structure
| event_date | |
| event_key | |
| artist_name | |
| venue_name | |
| event_name | |
| ticket_id | |
| ticket_key | |
| price_code | |
| purchase_timestamp | |
| paid_amount | |
| num_seats | |
| network | |
| fan_id | |
| first_name | |
| last_name | |
| phone | |
| is_subscribed | |
| is_phone_subscribed | |
| province | |
| country_code | |
| city | |
| metro_area | |
| postal_code | |
| order_key | |
| is_deleted | |
| last_update_timestamp | |
| status | success or duplicate if ticket already exists |
POST /v1/crm/bulk_tickets
Description
Create up to 100 new tickets and Corresponding Fan Records. Takes in a list of tickets with the same structure and requirements as POST /v1/crm/tickets
Input Parameters
| first_name | |
| last_name | Required. |
| phone | |
| Required. | |
| customer_key | Key of the customer in the remote system |
| ticket_key | Optional. Unique identifier for the line item (i.e. unique per price code and amount). |
| purchase_timestamp | Required. YYYY-MM-DD HH:MI:SS in GMT timezone |
| paid_amount | Required. Numeric value for line item |
| num_seats | Required. Number of seats purchased |
| price_code | Optional. Price level or code of line item |
| is_subscribed | Subscribed to email |
| is_phone_subscribed | Subscribed to phone |
| city | |
| province | |
| postal_code | |
| country_code | |
| event_date | Required. ISO8601 Encoded String |
| event_name | Required. |
| artist_name | |
| venue_name | |
| event_key | |
| network | |
| order_key | |
| is_deleted | Optional. Boolean Value |
Result
A list of Created Records. Data will be returned as it was loaded in the system. I.e. sanitized
Resulting Structure
| ticket_id | |
| account_id | |
| ticket_key | |
| customer_dsn | |
| network | |
| purchase_timestamp | |
| paid_amount | |
| order_amount | |
| num_seats | |
| fan_id | |
| event_date | |
| event_name | |
| event_key | |
| artist_name | |
| venue_name | |
| price_code | |
| city | |
| province | |
| country_code | |
| customer_key | |
| postal_code | |
| metro_area | |
| venue_province | |
| order_key | |
| ticket_category | |
| import_uid | |
| is_deleted | |
| ticket_type | |
| ticket_type_category | |
| creation_timestamp | |
| last_update_timestamp | |
| status |
GET /v1/crm/tickets/events
Description
Get all event tickets or search by event_name, event_key, event_date or venue_name
Input Parameters
| event_name | Optional. Must be exact name |
| event_key | Optional. |
| event_date | Optional. Format YYYY-MM-DD |
| venue_name | Optional. Must be exact name |
Result
Structure: {'meta': { 'count': ### }, 'data': []}. Data is an array with the following elements
Resulting Structure
| event_uid | Unique identifier for the event |
| account_id | |
| event_key | |
| event_name | |
| venue_name | |
| artist_name | |
| event_date | |
| creation_timestamp | |
| network | |
| notes | |
| label_name | |
| event_type |
POST /v1/crm/tickets/events
Description
Create, update or delete a ticket event.
Input Parameters
| action | create / update / delete. Defaults to create |
| event_uid | Unique identifier for the event. Required for delete. Event_uid or event_key required for update |
| event_key | Event Key in remote system. Event_uid or event_key required for update |
| event_name | Required |
| venue_name | |
| artist_name | |
| event_date | Required. Format YYYY-MM-DD |
| network | Required |
| notes | |
| label_name | |
| event_type |
Result
Created Record. Data will be returned as it was loaded in the system. I.e. sanitized
Resulting Structure
| event_uid | |
| account_id | |
| event_key | |
| event_name | |
| venue_name | |
| artist_name | |
| event_date | |
| creation_timestamp | |
| network | |
| notes | |
| label_name | |
| event_type | |
| status |
GET /v1/crm/ticket_stats
Description
Get stats for tickets over a specified time range.
Input Parameters
| max_purchase_date | Format YYYY-MM-DD. |
| min_purchase_date | Format YYYY-MM-DD. |
| event_name | Optional. Must be exact name. |
| event_key | Optional |
| event_date | Optional. Format YYYY-MM-DD. |
| venue_name | Optional. Must be exact name |
| artist_name | Optional. |
| event_specific | Optional. Format 'true' or 'false'. Determines whether new/returning stats are by date only or by event as well. |
Result
Single record. Data is an object with the following elements
Resulting Structure
| returning_fans_count | |
| new_fans_count | |
| sales_count | |
| seats_count | |
| revenue |
GET /v1/crm/registrations
Description
Query Wristband/RFID registrations from the database
Input Parameters
| start_date | Date filter option. Will return only tickets on or after a given date |
| end_date | Date filter option. Will return only tickets on or prior a given date |
| Optionally this parameter allows you to filter tickets to specific user/email address | |
| limit | Optional parameter to specify max row count. If omitted, will be set to 1000 |
Result
Structure: {'meta': { 'count':xxx },'data':[] }. Data is array with following elements
Resulting Structure
| registration_key | Unique Identifier for the registration |
| order_key | Remote Ticket Key |
| account_id | Tradable Bits Account ID |
| email on the ticket | |
| event_date | ISO date of the event |
| registration_timestamp | Timestamp of registration. Unix Time |
| creation_timestamp | Timestamp of import. Unix Time |
| price_code | Price Code or Level |
POST /v1/crm/registrations
Description
Create new registration and Corresponding Fan Record
Input Parameters
| first_name | Required. |
| last_name | Required. |
| phone | |
| Required. | |
| registration_key | Unique identifier for the line item |
| registration_timestamp | Required. YYYY-MM-DD HH:MI:SS in GMT timezone |
| order_key | |
| price_code | Optional. Price level or code of line item |
| event_date | Optional. Date of the Event. ISO Date |
Result
Created Record. Data will be returned as it was loaded in the system. I.e. sanitized
Resulting Structure
| registration_key | Unique Identifier for the registration |
| order_key | Remote Ticket Key |
| account_id | Tradable Bits Account ID |
| email on the ticket | |
| event_date | ISO date of the event |
| registration_timestamp | Timestamp of registration. Unix Time |
| creation_timestamp | Timestamp of import. Unix Time |
| price_code | Price Code or Level |
POST /v1/crm/fans
Description
Create new Fan Record
Input Parameters
| first_name | |
| last_name | |
| password | |
| login_name | |
| display_name | |
| gender | Must be male, female, diverse, other, or empty. |
| is_subscribed | true/false/on/off |
| is_phone_subscribed | |
| phone | |
| birth_date | |
| ip_address | |
| latitude | |
| longitude | |
| business_<business_id> | Optional. Send business_<business_id> as the field and true/false/on/off as the value. True indicates a fan is opted in to the business, false will opt a fan out of the business. |
Result
Created Record
Resulting Structure
| fan_id | |
| account_id | |
| name | |
| first_name | |
| last_name | |
| province | |
| latitude | |
| longitude | |
| login_name | |
| creation_timestamp | |
| ip_address | |
| country_code | |
| city | |
| is_subscribed | |
| is_phone_subscribed | |
| rating | |
| phone | |
| birth_date | |
| metro_area | |
| postal_code | |
| fields | |
| gender | |
| tags |
GET /v1/crm/fans/<fan_id>
Description
Get Specific fan record via ID
Result
Following structure
Resulting Structure
| fan_id | |
| account_id | |
| name | |
| first_name | |
| last_name | |
| province | |
| latitude | |
| longitude | |
| login_name | |
| creation_timestamp | |
| ip_address | |
| country_code | |
| city | |
| is_subscribed | |
| is_phone_subscribed | |
| rating | |
| phone | |
| birth_date | |
| metro_area | |
| postal_code | |
| fields | |
| gender | |
| tags |
POST /v1/crm/fans/<fan_id>
Description
Update Fan Record
Input Parameters
| first_name | |
| last_name | |
| password | |
| login_name | |
| display_name | |
| gender | Must be male, female, diverse, other, or empty. |
| is_subscribed | true/false/on/off |
| is_phone_subscribed | |
| phone | |
| birth_date | |
| ip_address | |
| country_code | |
| province | country_code is required |
| city | country_code is required |
| postal_code | country_code is required |
| business_<business_id> | Optional. Send business_<business_id> as the field and true/false/on/off as the value. True indicates a fan is opted in to the business, false will opt a fan out of the business. |
Result
Updated Record
Resulting Structure
| fan_id | |
| account_id | |
| name | |
| first_name | |
| last_name | |
| province | |
| latitude | |
| longitude | |
| login_name | |
| creation_timestamp | |
| ip_address | |
| country_code | |
| city | |
| is_subscribed | |
| rating | |
| phone | |
| birth_date | |
| metro_area | |
| postal_code | |
| fields | |
| gender | |
| tags |
DELETE /v1/crm/fans/<fan_id>
Description
Delete Record
Result
Boolean
GET /v1/crm/fans/<fan_id>/networks
Description
Get Fan Networks
Result
JSON
Resulting Structure
| fan_id | |
| account_id | |
| name | |
| user_key | |
| network | |
| creation_timestamp | |
| last_update_timestamp | |
| props | |
| access_token | |
| access_secret |
POST /v1/crm/fans/<fan_id>/networks
Description
Create/Update/Delete Fan Networks
Input Parameters
| action | create/update/delete |
| name | |
| user_key | Required |
| network | Required. Must be "custom" for create and update |
| creation_timestamp | |
| last_update_timestamp | |
| props | |
| access_token | |
| access_secret |
Result
JSON
GET /v1/crm/fans/<fan_id>/points
Description
Get Fan points
Result
Following structure
Resulting Structure
| fan_id | |
| point_uid | |
| point_name | |
| point_count |
POST /v1/crm/fans/<fan_id>/points
Description
award a fan points
Input Parameters
| point_name | |
| point_count |
Result
[]
POST /v1/crm/fans/<fan_id>/merge
Description
Merge fan record with another fan. As a result, the source fan_id will no longer be valid.
Input Parameters
| target_fan_id | Destination Fan Record |
Result
New Fan Record
Resulting Structure
| fan_id | |
| account_id | |
| name | |
| first_name | |
| last_name | |
| province | |
| latitude | |
| longitude | |
| login_name | |
| creation_timestamp | |
| ip_address | |
| country_code | |
| city | |
| is_subscribed | |
| rating | |
| phone | |
| birth_date | |
| metro_area | |
| postal_code | |
| fields | |
| gender | |
| tags |
GET /v1/crm/fans/<fan_id>/idols
Description
Fetch list of idols for a given Fan
Input Parameters
| label_name | Limit Idols to a specific label |
Result
Array of Idols
Resulting Structure
| spotify_follower_count | |
| spotify_uid | |
| facebook_follower_count | |
| description | |
| account_id | |
| idol_uid | |
| idol_name | |
| facebook_id | |
| media_uid | |
| image_url |
POST /v1/crm/fans/<fan_id>/idols
Description
Add or remove idol association
Input Parameters
| action | add/delete |
| idol_uid | |
| idol_name | Name for a given (as alternative to UUID) |
Result
Array of current Fan Idols
Resulting Structure
| spotify_follower_count | |
| spotify_uid | |
| facebook_follower_count | |
| description | |
| account_id | |
| idol_uid | |
| idol_name | |
| facebook_id | |
| media_uid | |
| image_url |
GET /v1/crm/fans/<fan_id>/registrations
Description
Obtain a list of known registrations for the fan. Registration is tied to RFID bracelet or some form of ticket
Input Parameters
| limit | Record Limit |
Result
Array of records
Resulting Structure
| registration_timestamp | |
| account_id | |
| ticket_order_key | |
| price_code | |
| event_date | |
| barcode | |
| fan_id | |
| registration_timestamp | |
| creation_timestamp |
POST /v1/crm/fans/<fan_id>/registrations
Description
Create new Registration Record for a given Fan
Input Parameters
| registration_timestamp | |
| ticket_order_key | |
| price_code | |
| event_date | |
| barcode | |
| registration_timestamp |
Result
Array of latest registrations
Resulting Structure
| registration_timestamp | |
| account_id | |
| ticket_order_key | |
| price_code | |
| event_date | |
| barcode | |
| fan_id | |
| registration_timestamp | |
| creation_timestamp |
GET /v1/crm/fans/<fan_id>/activities
Description
Obtain a list of activities for a given Fan
Input Parameters
| limit | Record Limit |
| campaign_title | Limit results to specific campaign |
Result
Array of records
Resulting Structure
| account_id | |
| fan_id | |
| creation_date | |
| campaign_title | |
| props |
POST /v1/crm/fans/<fan_id>/activities
Description
Create new Activity Record for a given Fan
Input Parameters
| campaign_title | Name of custom campaign |
| field_* | Additional meta data as per defined custom fields |
Result
Array of latest activities
Resulting Structure
| account_id | |
| fan_id | |
| creation_date | |
| campaign_title | |
| props |
GET /v1/crm/fields
Description
Get array of defined custom fields on the account
Result
Resulting Structure
| crm_field_key | |
| account_id | |
| field_type | |
| creation_timestamp | |
| field_options | |
| is_active | |
| is_global |
GET /v1/crm/search_filters
Description
Get array of search filters
Input Parameters
| group name | Filter group name. Optional. |
| creation_start_date | String in the form 'YYYY-MM-DD'. Optional. |
| creation_end_date | String in the form 'YYYY-MM-DD'. Optional. |
Result
Array of search filters
Resulting Structure
| filter_uid | |
| filter_name | |
| account_id | |
| creation_timestamp | |
| last_search_count |
GET /v1/crm/fan_stats
Description
Get stats pertaining to fans captured by the filter provided
Input Parameters
| filter_name | Required |
Result
Fan stats object based on filter supplied
Resulting Structure
| fans | Object containing general information such as total number of fans |
| fan_demographics | Object containing gender and fan rating breakdowns |
| top_countries | Object showing fan locations by country |
| top_metro_areas | Object showing fan locations by metro area |
| top_locations | Object showing fan locations by region with further breakdowns |
| fan_metrics | Age, gender, and rating counts |
| postal_demographics | Census breakdown percentages by ethnicity, education, income, family makeup |
GET /v1/crm/monitored_ip_addresses
Description
Get list of monitored ip addresses on the account
Result
Resulting Structure
| page_tab_id | |
| ip_address | |
| is_blocked | True if the address is banned, false if it is allowed |
| creation_timestamp |
POST /v1/crm/monitored_ip_addresses
Description
Block or allow an IP address or CIDR
Input Parameters
| ip_address | IP Address or CIDR |
| is_blocked | True to ban users at this ip address, false to allow them |
| page_tab_id | If included, will ban or allow the given address for only this page tab |
Result
The created record
Resulting Structure
| page_tab_id | |
| ip_address | |
| is_blocked | True if the address is banned, false if it is allowed |
| creation_timestamp |
DELETE /v1/crm/monitored_ip_addresses
Description
Delete a blocked or allowed IP Address
Input Parameters
| ip_address | IP Address or CIDR |
| is_blocked | |
| page_tab_id |
Result
The deleted record
Resulting Structure
| page_tab_id | |
| ip_address | |
| is_blocked | True if the address is banned, false if it is allowed |
| creation_timestamp |
Streams Calls
GET /v1/streams
Description
Produce a list of currently available streams.
Result
Resulting Structure
| stream_key | |
| account_id | |
| creation_timestamp | |
| stream_name | |
| props | |
| virtual_domain | |
| css_text | |
| javascript_text | |
| record_limit | |
| trust_level | |
| media_map | |
| is_public |
POST /v1/streams
Description
Create new Stream in the system
Input Parameters
| action | create/delete |
| stream_key | |
| stream_name |
Result
Array of streams
Resulting Structure
| stream_key | |
| account_id | |
| creation_timestamp | |
| stream_name | |
| props | |
| virtual_domain | |
| css_text | |
| javascript_text | |
| record_limit | |
| trust_level | |
| media_map | |
| is_public |
GET /v1/streams/<stream_key>/records
Description
Search for approved records in the stream
Input Parameters
| networks | |
| label_key | |
| sku | |
| is_graphic | |
| min_time_key | Max and Min time keys is a way to page through results. As part of Result - system returns max_time_key/min_time_key in the data. |
| max_time_key | Max and Min time keys is a way to page through results. As part of Result - system returns max_time_key/min_time_key in the data. |
| q | |
| start_latitude | |
| end_latitude | |
| start_longitude | |
| end_longitude |
Result
{meta:{min_time_key:xx, max_time_keey:xx, row_count:xxx },data:[] }
Resulting Structure
| stream_key | |
| feed_record_id | |
| record_key | |
| props | |
| creation_timestamp | |
| image_url | |
| src_image_url | |
| video_url | |
| caption | |
| network | |
| record_url | |
| latitude | |
| longitude | |
| links | |
| link_url | |
| link_name | |
| author_id | |
| author_user_key | |
| author_screen_name | |
| author_name | |
| author_image_url | |
| author_status |
POST /v1/streams/<stream_key>/records
Description
Create new Stream Record
Input Parameters
| name | |
| image_url | |
| caption | |
| latitude | |
| longitude | |
| props_* | Ability to store any meta data as part of the record |
Result
Newly Created Record
Resulting Structure
| stream_key | |
| feed_record_id | |
| record_key | |
| props | |
| creation_timestamp | |
| image_url | |
| src_image_url | |
| video_url | |
| caption | |
| network | |
| record_url | |
| latitude | |
| longitude | |
| links | |
| link_url | |
| link_name | |
| author_id | |
| author_user_key | |
| author_screen_name | |
| author_name | |
| author_image_url | |
| author_status |
GET /v1/streams/<stream_key>
Description
Get Summary Stats on the stream
Input Parameters
| data | Comma separated list of sections: words, hashtags, labels |
| label_key | Label Filter |
| start_time | optional date filter (specified as unix time) |
| end_time | optional date filter (specified as unix time) |
Result
Summary Structure Record
Resulting Structure
| stream_key | |
| stream_name | |
| total_stored | |
| total | |
| approved_total | |
| authors | |
| reach | |
| last_record_timestamp | |
| words | |
| hashtags | |
| labels |
GET /v1/streams/<stream_key>/<feed_record_id>
Description
Get individual record
Result
Record Data
Resulting Structure
| stream_key | |
| feed_record_id | |
| record_key | |
| props | |
| creation_timestamp | |
| image_url | |
| src_image_url | |
| video_url | |
| caption | |
| network | |
| record_url | |
| links | |
| link_url | |
| link_name | |
| author_id | |
| author_user_key | |
| author_screen_name | |
| author_name | |
| author_image_url | |
| author_status |
POST /v1/streams/<stream_key>/<feed_record_id>
Description
Approve individual Record or Label it accordingly
Input Parameters
| action | approve/remove/label/unlabel |
| label_key |
Result
Update Record Data
Resulting Structure
| stream_key | |
| feed_record_id | |
| record_key | |
| props | |
| creation_timestamp | |
| image_url | |
| src_image_url | |
| video_url | |
| caption | |
| network | |
| record_url | |
| links | |
| link_url | |
| link_name | |
| author_id | |
| author_user_key | |
| author_screen_name | |
| author_name | |
| author_image_url | |
| author_status |
GET /v1/streams/<stream_key>/<feed_record_id>/broken
Description
Mark a given record as the one requiring verification (e.g. image url is not valid)
Result
Boolean Value
Sessions Calls
POST /v1/sessions/wifi_fans
Description
This endpoint enables third party apps to pass Wifi Authentication Information
Input Parameters
| network | Connected network. Network value can drive other require arguments. Supported: facebook, spotify, email |
| access_token | Mandatory for Facebook/Spotify |
| Optional for Facebook/Spotify | |
| first_name | Optional for Facebook/Spotify |
| last_name | Optional for Facebook/Spotify |
| activity_name | Reference to the Activity or Event name. |
| device_id | Hardware reference if mobile app is used |
| device_network | one of ios/android |
Result
true if call is successful, error otherwise
POST /v1/sessions/idol_fans
Description
This endpoint enables third party apps to submit artist affinity information for segmentation
Input Parameters
| network | Connected network. Network value can drive other require arguments. Supported: facebook, spotify,email |
| access_token | Mandatory for Facebook/Spotify |
| Optional for Facebook/Spotify | |
| first_name | Optional for Facebook/Spotify |
| last_name | Optional for Facebook/Spotify |
| idol_name | Reference to the artist name. Idol will be created if it doesn't exist yet |
| device_id | Hardware reference if mobile app is used |
| device_network | one of ios/android |
Result
true if call is successful, error otherwise
POST /v1/sessions/signup
Description
This endpoint enables third-party apps to push email signup or some other form of activity into our CRM.
Input Parameters
| phone | |
| first_name | |
| last_name | |
| birth_date | String in the form 'YYYY-MM-DD' |
| city | City. country_code is required if included. |
| country_code | 2 letter country code or full country name |
| postal_code | Postal Code in a given country. country_code is required if included |
| province | Province name. country_code is required if included |
| ip_address | Optional Field. Will take REMOTE_ADDR if omitted |
| device_id | Hardware reference if mobile app is used |
| device_network | one of ios/android |
| field_xxxx | Custom field value for configured custom fields |
| is_unique_activity | true/false - enforce unique participation in the campaign |
| campaign_name | Campaign Connection, if call is meant to be associated with campaign |
| page_tab_id | Campaign Connection, if call is meant to be associated with campaign. This field should be used instead of the campaign_name field if possible and will supersede it if filled |
| tag_name | CRM Tag to apply to the user. Can be specified multiple times in the payload |
| tag_names | As alternative to tag_name, tags can be supplied as comma separated list |
| business_id | Opt-in to a specific business, if applicable |
| idol_name | Idol to associate with the user |
Result
Structure as below
Resulting Structure
| fan_id | Fan ID of the records |
| activity_id | Activity ID if it was created properly |
POST /v1/sessions/connect
Description
This call allows to initialize new session and potentially create new fan Record in the system. It can be used for native and website integration and is essential for proper integration.
Input Parameters
| network | Connected network. Network value can drive other require arguments. An empty string as network value is used to create a guest session without a fan record. Most common values: facebook, spotify, yinzcam, twitter, register, email, verify_sms, verify_email, submit_verification_code |
| business_id | Required |
| page_tab_id | |
| access_token | |
| ip_address | |
| name | |
| phone | |
| password | |
| access_secret | |
| is_accepted | Flag to confirm terms acceptance. Required if terms_required is returned |
| device_id | |
| device_network |
Result
New Session Object (or structure to represent a step in login flow
Resulting Structure
| session_uid | |
| fan_id | |
| account_id | |
| props | |
| expiration_timestamp |
GET /v1/sessions/<session_uid>
Description
Get existing Session using ID
Result
Record
Resulting Structure
| session_uid | |
| fan_id | |
| account_id | |
| props | |
| expiration_timestamp |
GET /v1/sessions/<session_uid>/fan
Description
Fetch current Fan Record
Result
Following Structure
Resulting Structure
| fan_id | |
| account_id | |
| name | |
| first_name | |
| last_name | |
| province | |
| latitude | |
| longitude | |
| login_name | |
| creation_timestamp | |
| ip_address | |
| country_code | |
| city | |
| is_subscribed | |
| rating | |
| phone | |
| birth_date | |
| metro_area | |
| postal_code | |
| fields | |
| image_url | |
| gender | |
| tags |
POST /v1/sessions/<session_uid>/fan
Description
Update Current Fan Record
Input Parameters
| first_name | |
| last_name | |
| password | |
| login_name | |
| is_subscribed | true/false/on/off |
| is_phone_subscribed | true/false/on/off |
| phone | |
| birth_date | |
| ip_address | |
| props_* | update props |
| field_* | update fields |
| tag_* | update tags |
Result
Updated Record
Resulting Structure
| fan_id | |
| account_id | |
| name | |
| first_name | |
| last_name | |
| province | |
| latitude | |
| longitude | |
| login_name | |
| creation_timestamp | |
| ip_address | |
| country_code | |
| city | |
| is_subscribed | |
| is_phone_subscribed | |
| rating | |
| phone | |
| birth_date | |
| metro_area | |
| postal_code | |
| fields | |
| image_url | |
| gender | |
| tags |
GET /v1/sessions/<session_uid>/networks
Description
Get a list of connected networks for a given Fan Record
Result
Array of connected networks
Resulting Structure
| fan_id | |
| account_id | |
| name | |
| user_key | |
| network | |
| creation_timestamp | |
| last_update_timestamp | |
| profile_url | |
| follower_count | |
| props | |
| image_url | |
| access_token | |
| access_secret |
POST /v1/sessions/<session_uid>/networks
Description
Create/update/delete connected networks for a given Fan Record
Input Parameters
| action | create/update/delete |
| name | |
| user_key | Required |
| network | Required. Must be "custom" for create and update |
| creation_timestamp | |
| last_update_timestamp | |
| profile_url | |
| follower_count | |
| props | |
| image_url | |
| access_token | |
| access_secret |
Result
JSON
GET /v1/sessions/<session_uid>/tickets
Description
Obtain a list of known tickets for the fan.
Input Parameters
| limit | Record Limit |
Result
Array of records
Resulting Structure
| ticket_id | |
| account_id | |
| event_name | |
| artist_name | |
| venue_name | |
| price_code | |
| event_date | |
| paid_amount | |
| num_seats | |
| purchase_timestamp | |
| creation_timestamp |
POST /v1/sessions/<session_uid>/tickets
Description
Update one of tickets on the account
Input Parameters
| action | Currently only transfer is supported |
| ticket_id | |
| first_name | |
| last_name |
Result
Array of latest tickets
Resulting Structure
| ticket_id | |
| account_id | |
| event_name | |
| artist_name | |
| venue_name | |
| price_code | |
| event_date | |
| paid_amount | |
| num_seats | |
| purchase_timestamp | |
| creation_timestamp |
GET /v1/sessions/<session_uid>/registrations
Description
Obtain a list of known registrations for the fan. Registration is tied to RFID bracelet or some form of ticket
Input Parameters
| limit | Record Limit |
Result
Array of records
Resulting Structure
| registration_timestamp | |
| account_id | |
| ticket_order_key | |
| price_code | |
| event_date | |
| barcode | |
| fan_id | |
| registration_timestamp | |
| creation_timestamp |
POST /v1/sessions/<session_uid>/registrations
Description
Create new Registration Record for a given Fan
Input Parameters
| registration_timestamp | |
| ticket_order_key | |
| price_code | |
| event_date | |
| barcode | |
| registration_timestamp |
Result
Array of latest registrations
Resulting Structure
| registration_timestamp | |
| account_id | |
| ticket_order_key | |
| price_code | |
| event_date | |
| barcode | |
| fan_id | |
| registration_timestamp | |
| creation_timestamp |
GET /v1/sessions/<session_uid>/points
Description
Get Fan points
Result
Following structure
Resulting Structure
| fan_id | |
| point_uid | |
| point_name | |
| point_count |
GET /v1/sessions/<session_uid>/activities
Description
Fetch current Fan Activities
Input Parameters
| limit | max row count |
| campaign_title | Limit results to specific campaign |
Result
Array of last activities
Resulting Structure
| fan_id | |
| campaign_title | |
| creation_date | |
| creation_timestamp | |
| props |
POST /v1/sessions/<session_uid>/activities
Description
Create Activity record to associate with current Fan
Input Parameters
| campaign_title | Name of new Custom Campaign |
| field_* |
Result
Array of last activities
Resulting Structure
| fan_id | |
| campaign_title | |
| creation_date | |
| creation_timestamp | |
| props |
GET /v1/sessions/<session_uid>/idols
Description
Fetch a list of connected idols
Input Parameters
| label_name | Limit Idols to a specific label |
Result
Array of following structures
Resulting Structure
| spotify_follower_count | |
| spotify_uid | |
| facebook_follower_count | |
| description | |
| account_id | |
| idol_uid | |
| idol_name | |
| facebook_id | |
| media_uid | |
| image_url |
POST /v1/sessions/<session_uid>/idols
Description
Create or Delete association between current Fan and Idol
Input Parameters
| action | One of: add, delete |
| idol_uid | UUID for a given idol |
| idol_name | Name for a given (as alternative to UUID) |
Result
Array of currently connected idols
Resulting Structure
| spotify_follower_count | |
| spotify_uid | |
| facebook_follower_count | |
| description | |
| account_id | |
| idol_uid | |
| idol_name | |
| facebook_id | |
| media_uid | |
| image_url |
GET /v1/sessions/<session_uid>/fan_events
Description
Get a list of events for a session's Fan
Input Parameters
| label_name | Limit Idols to a specific label |
Result
Array of records as per following structure
Resulting Structure
| fan_id | |
| creation_timestamp | |
| event_uid |
POST /v1/sessions/<session_uid>/fan_events
Description
Create new association between event and fan or delete existing one
Input Parameters
| action | one of: add or delete |
| event_uid | UUID for a valid event |
Result
ID of event
POST /v1/sessions/<session_uid>/mediastream_token
Description
Media Stream integration: retrieve a new unique access token for a given session UID.
Input Parameters
| id | ID of the video |
Result
JSON structure with access_token as a field
Idols Calls
POST /v1/idols
Description
Create new idol in the database
Input Parameters
| idol_name | Name of the new idol |
| spotify_uid | Optional Spotify UID if it's available |
Result
idol structure
Resulting Structure
| spotify_follower_count | |
| spotify_uid | |
| facebook_follower_count | |
| description | |
| account_id | |
| idol_uid | |
| idol_name | |
| facebook_id | |
| media_uid | |
| image_url |
GET /v1/idols
Description
Search for an idols in the database
Input Parameters
| idol_name | Search Expression for an idol |
| label_name | Limit Idols to a specific label |
Result
Array of idol structures
Resulting Structure
| spotify_follower_count | |
| spotify_uid | |
| facebook_follower_count | |
| description | |
| account_id | |
| idol_uid | |
| idol_name | |
| facebook_id | |
| media_uid | |
| image_url |
GET /v1/idols/<idol_uid>
Description
Obtain an idol for a given idol_uid
Result
A structure for a given idol as follows
Resulting Structure
| spotify_follower_count | |
| spotify_uid | |
| facebook_follower_count | |
| description | |
| account_id | |
| idol_uid | |
| idol_name | |
| facebook_id | |
| media_uid | |
| image_url |
GET /v1/idols/<idol_uid>/rel_artists
Description
Obtain a list of artists related to a given Idol
Input Parameters
| label_name | Optional argument to limit idols with a given label only |
Result
Array of records as per following structure
Resulting Structure
| idol_uid | |
| idol_name | |
| artist_name | |
| facebook_id | |
| image_url |
GET /v1/idols/events
Description
Based on the search parameters return a list of Idol Events.
Input Parameters
| idol_uid | |
| venue_name | |
| q | |
| label_name | |
| start_date | |
| end_date |
Result
Array of JSON records matching the search
Resulting Structure
| event_uid | |
| account_id | |
| idol_uid | |
| start_timestamp | |
| end_timestamp | |
| venue_name | |
| city | |
| province | |
| country_code | |
| event_url | |
| ticket_url | |
| label_name | |
| idol_name | |
| facebook_id | |
| media_uid | |
| image_url |
GET /v1/idols/events/<event_uid>
Description
Get individual Scheduled Event given event_uid
Result
JSON structure with Event Details or null
Resulting Structure
| event_uid | |
| account_id | |
| idol_uid | |
| start_timestamp | |
| end_timestamp | |
| venue_name | |
| city | |
| province | |
| country_code | |
| event_url | |
| ticket_url | |
| label_name | |
| idol_name | |
| facebook_id | |
| media_uid | |
| image_url |
Reports Calls
GET /v1/reports
Description
Get all shared reports asociated with the current account.
Result
Array of JSON objects as per structure below
Resulting Structure
| report_uid | Identifier of the report |
| report_name | Name of the report |
| report_type | Type of the report. One of 'adwords_adaccount', 'app', 'bot', 'crm', 'fb_adaccount', 'idol', 'sms', 'stream', 'ticket', 'tracker' |
| start_date | Start date for the report's data |
| end_date | End date for the report's data |
| last_access_timestamp | Timestamp for when the report was last accessed |
GET /v1/reports/<report_uid>
Description
Get data for a shared report.
Result
Structure: {'<report_type>': {}}. Corresponding object to the report's type is the data for the report, whose structure depends on the report's type. Below is structure for 'fb_adaccount' stats report.
Resulting Structure
| spend | Total spending |
| conversion | Total sales value attributable to ads |
| offline_conversion | Sales value attributable to offline conversion |
| conversion_count | Number of sales |
| impressions | Total number of impressions |
| reach | Total number of unique people reached |
| frequency | Average frequency per unique person |
| cpm | Cost-per-thousand |
| cpa | Cost-per-action |
| roi | Return on investment rate |
| clicks | Total number of clicks |
| ctr | Clickthrough rate |
| cpc | Cost-per-click |
Ads Calls
POST /v1/ads/projects/<project_uid>/budget_lines
Description
Create a new budget line for an ad project
Input Parameters
| name | Name of the budget line |
| budget_amount | Monetary amount of budget line |
| notes | Budget line notes |
Result
JSON object as per structure below
Resulting Structure
| project_line_uid | |
| project_uid | |
| creation_timestamp | |
| budget_amount | |
| ip_address | |
| name | |
| notes | |
| campaign_names | |
| currency | |
| creation_timestamp_iso |
Misc Calls
GET /v1/trackers
Description
Get a list of recently created Trackers (last 500 trackers). The date range will default to searching between now and 31 days in the past if neither option is specified
Input Parameters
| min_creation_date | Optional. Minimum date to use when searching for aggregated stats for the tracker. Must be of the format "%m/%d/%y" |
| max_creation_date | Optional. Maximum date to use when searching for aggregated stats for the tracker. Must be of the format "%m/%d/%y" |
Result
Array of JSON objects as per structure below
Resulting Structure
| tracker_id | Unique identifier for tracker |
| account_id | Account id associated with the tracker |
| creation_timestamp | UNIX timestamp for creation |
| tracker_name | Name for the tracker |
| tracker_group_name | |
| target_url | |
| virtual_domain | |
| tracker_key | |
| tracker_url | |
| tracker_marketing_group_name | |
| attributed_purchase_count | |
| attributed_purchase_amount | |
| total_tracker_click_count | |
| creation_timestamp_iso | Formatted yyyy-mm-dd : hh:mm:ss timestamp |
GET /v1/trackers/<tracker_id>
Description
Get individual tracker as specified by ID. The date range will default to searching between now and 31 days in the past if neither option is specified
Input Parameters
| min_creation_date | Optional. Minimum date to use when searching for aggregated stats for the tracker. Must be of the format "%m/%d/%y" |
| max_creation_date | Optional. Maximum date to use when searching for aggregated stats for the tracker. Must be of the format "%m/%d/%y" |
Result
The following JSON structure will be returned if a tracker with the inputted ID exists for your account. Otherwise an error will be returned
Resulting Structure
| tracker_id | Unique identifier for tracker |
| account_id | Account id associated with the tracker |
| creation_timestamp | UNIX timestamp for creation |
| tracker_name | Name for the tracker |
| tracker_group_name | |
| target_url | |
| virtual_domain | |
| tracker_key | |
| tracker_url | |
| tracker_marketing_group_name | |
| attributed_purchase_count | |
| attributed_purchase_amount | |
| total_tracker_click_count | |
| creation_timestamp_iso | Formatted yyyy-mm-dd : hh:mm:ss timestamp |
POST /v1/trackers
Description
Create New Tracker for measurement of redirect performance. This call allows for the creation of Tradable Bits Trackers
Input Parameters
| virtual_domain | Domain. Must be preconfigured and setup by Tradable Bits |
| target_url | |
| tracker_name | Name for the tracker, maximum 128 characters |
| tracker_group_name | |
| network | spotify, instagram, facebook, google, X or custom. Will default to custom if not specified or not in the list of valid networks |
| tracker_key | Optional, must be alphanumeric. One will be generated if not supplied |
| tracker_marketing_group_name | Optional |
| page_tab_id | Optional |
Result
Upon Success, call will return a structure for created tracker
Resulting Structure
| tracker_id | Unique identifier for tracker |
| account_id | Account id associated with the tracker |
| creation_timestamp | UNIX timestamp for creation |
| tracker_name | Name for the tracker |
| tracker_group_name | |
| target_url | |
| virtual_domain | |
| tracker_key | |
| tracker_url | |
| tracker_marketing_group_name | |
| attributed_purchase_count | |
| attributed_purchase_amount | |
| total_tracker_click_count | |
| creation_timestamp_iso | Formatted yyyy-mm-dd : hh:mm:ss timestamp |
GET /v1/props/<prop_name>
Description
This call allows to store and retrieve back json data structure. Primary use for this call is some form of simple voting, which doesn't require any cheater or inappropriate use detection
Input Parameters
| props | Data structure to save |
Result
The value currently stored under this prop_name
GET /v1/geoip
Description
Get regional information from an IP address
Input Parameters
| ip_address | IPv4 or IPv6 address. otherwise caller ip will be used |
Result
Regional information associated with that IP address
Resulting Structure
| city | |
| region_name | |
| latitude | |
| longitude | |
| country_name | |
| postal_code |
GET /v1/phone_check
Description
Get regional information from an IP address
Input Parameters
| phone | Phone number. The more complete the number the better. |
| country_code | lower case two letter ISO code of the country |
Result
Error message or text value of validated phone
GET /v1/shp_lookup
Description
Lookup product on Shopify
Input Parameters
| query |
Result
A list of matching shopify products
POST /v1/yinzcam_subscription
Description
Part of the integration with Yinzcam for push tokens sync
Input Parameters
| user_key | |
| push_token | |
| device_network |
Result
Boolean Value of True
GET /v1/account_ad_stats
Description
Fetch ad stats for the account
Result
A list of structures with the following fields
Resulting Structure
| network | Ad platform, e.g. facebook, twitter |
| spend | |
| impressions | |
| clicks | |
| conversion_amount | |
| conversion_count | |
| offline_conversion_amount | |
| offline_conversion_count | |
| custom_conversion_count | |
| custom_conversion_amount | |
| custom_offline_conversion_count | |
| custom_offline_conversion_amount |
GET /v1/performances
Description
Get all account performances
Result
List of performance records
Resulting Structure
| performance_uid | Identifier for performance |
| account_id | |
| performance_name | |
| performance_date | |
| fb_ad_account_id | |
| metro_area | Venue metro area |
| creation_timestamp | |
| onsale_date | |
| venue_name | |
| display_venue_name | |
| artist_key | |
| artist_name | |
| additional_artist_names | |
| event_key | |
| province | Venue Province |
| country_code | Venue Country Code |
| city | Venue City |
| performance_url | |
| status | |
| announce_date | |
| buying_group | |
| notes | |
| performance_group_name | |
| venue_uid | |
| business_id | |
| fb_event_id | |
| label_name | |
| is_valid_idol | Performance is associated with a valid idol in Tbits system |
GET /v1/performances/<performance_uid>
Description
Get single performance
Result
Single performance records
Resulting Structure
| performance_uid | Identifier for performance |
| account_id | |
| performance_name | |
| performance_date | |
| fb_ad_account_id | |
| metro_area | Venue metro area |
| creation_timestamp | |
| onsale_date | |
| venue_name | |
| display_venue_name | |
| artist_key | |
| artist_name | |
| additional_artist_names | |
| event_key | |
| province | Venue Province |
| country_code | Venue Country Code |
| city | Venue City |
| performance_url | |
| status | |
| announce_date | |
| buying_group | |
| notes | |
| performance_group_name | |
| venue_uid | |
| business_id | |
| fb_event_id | |
| label_name | |
| is_valid_idol | Performance is associated with a valid idol in Tbits system |
POST /v1/performances
Description
Create new performance
Input Parameters
| performance_name | Required |
| performance_date | Required. Format YYYY-MM-DD |
| onsale_date | Format YYYY-MM-DD |
| announce_date | Format YYYY-MM-DD |
| fb_ad_account_id | |
| venue_uid | |
| artist_key | |
| artist_name | |
| event_key | |
| performance_url | Must begin with https:// |
| status | draft, ready, or archived |
| buying_group | Under 32 characters |
| notes | |
| performance_group_name | Under 128 characters |
| business_id | |
| fb_event_id | |
| label_name | |
| additional_artist_names | List of strings |
Result
New performance record
Resulting Structure
| performance_uid | Identifier for performance |
| account_id | |
| performance_name | |
| performance_date | |
| fb_ad_account_id | |
| metro_area | Venue metro area |
| creation_timestamp | |
| onsale_date | |
| venue_name | |
| display_venue_name | |
| artist_key | |
| artist_name | |
| additional_artist_names | |
| event_key | |
| province | Venue Province |
| country_code | Venue Country Code |
| city | Venue City |
| performance_url | |
| status | |
| announce_date | |
| buying_group | |
| notes | |
| performance_group_name | |
| venue_uid | |
| business_id | |
| fb_event_id | |
| label_name | |
| is_valid_idol | Performance is associated with a valid idol in Tbits system |
POST /v1/performances/<performance_uid>
Description
Update performance
Input Parameters
| performance_name | Required |
| performance_date | Required. Format YYYY-MM-DD |
| onsale_date | Format YYYY-MM-DD |
| announce_date | Format YYYY-MM-DD |
| fb_ad_account_id | |
| venue_uid | |
| artist_key | |
| artist_name | |
| event_key | |
| performance_url | Must begin with https:// |
| status | draft, ready, or archived |
| buying_group | Under 32 characters |
| notes | |
| performance_group_name | Under 128 characters |
| business_id | |
| fb_event_id | |
| label_name | |
| additional_artist_names | List of strings |
Result
Updated performance record
Resulting Structure
| performance_uid | Identifier for performance |
| account_id | |
| performance_name | |
| performance_date | |
| fb_ad_account_id | |
| metro_area | Venue metro area |
| creation_timestamp | |
| onsale_date | |
| venue_name | |
| display_venue_name | |
| artist_key | |
| artist_name | |
| additional_artist_names | |
| event_key | |
| province | Venue Province |
| country_code | Venue Country Code |
| city | Venue City |
| performance_url | |
| status | |
| announce_date | |
| buying_group | |
| notes | |
| performance_group_name | |
| venue_uid | |
| business_id | |
| fb_event_id | |
| label_name | |
| is_valid_idol | Performance is associated with a valid idol in Tbits system |
DELETE /v1/performances/<performance_uid>
Description
Delete performance
Result
Empty object
GET /v1/template_portals
Description
Get account template portals
Result
Template portal record(s)
Resulting Structure
| portal_uid | |
| account_id | |
| portal_name | |
| performance_group_name | |
| password | |
| templates_created | Number of templates created |
| creation_timestamp | |
| last_access_timestamp |
GET /v1/template_portals/<portal_uid>
Description
Get single template portal
Result
Template portal record
Resulting Structure
| portal_uid | |
| account_id | |
| portal_name | |
| performance_group_name | |
| password | |
| templates_created | Number of templates created |
| creation_timestamp | |
| last_access_timestamp |
POST /v1/template_portals
Description
Create template portal
Input Parameters
| portal_name | Required |
| performance_group_name | Required |
| password | Optional. Including will require the given password when accessing the portal |
Result
New template portal record
Resulting Structure
| portal_uid | |
| account_id | |
| portal_name | |
| performance_group_name | |
| password | |
| templates_created | Number of templates created |
| creation_timestamp | |
| last_access_timestamp |
POST /v1/template_portals/<portal_uid>
Description
Update template portal
Input Parameters
| portal_name | Required |
| performance_group_name | Required |
| password | Optional. Including will require the given password when accessing the portal |
Result
Updated template portal record
Resulting Structure
| portal_uid | |
| account_id | |
| portal_name | |
| performance_group_name | |
| password | |
| templates_created | Number of templates created |
| creation_timestamp | |
| last_access_timestamp |
DELETE /v1/template_portals/<portal_uid>
Description
Delete template portal
Result
Empty object
Apps Calls
GET /v1/apps
Description
Get a list of campaigns on the account
Input Parameters
| app_type | Limit Results to specific type |
| is_scheduled | Whether or not campaign is included into scheduler |
| business_id | Limit request to specific business |
Result
An array of structures with following fields
Resulting Structure
| page_tab_id | |
| name | |
| app_type | |
| creation_timestamp | |
| live_status | |
| business_id | |
| is_scheduled | |
| is_active | |
| media_map | |
| timezone | |
| props | |
| locale_props | |
| style_props | |
| links_map |
GET /v1/businesses
Description
Get a list of businesses on the account
Result
An array of structures with following fields
Resulting Structure
| legal_rules | |
| legal_terms | |
| legal_privacy | |
| business_id | |
| business_name | |
| media_map | |
| scheduler_props | |
| locale_props | |
| style_props |
GET /v1/businesses/<business_id>
Description
Get a specific Business record given ID
Result
structure with following fields
Resulting Structure
| legal_rules | |
| legal_terms | |
| legal_privacy | |
| business_id | |
| business_name | |
| media_map | |
| scheduler_props | |
| locale_props | |
| style_props |
GET /v1/apps/<page_tab_id>/bundle_stats
Description
Obtain statistical data for a specific bundle campaign
Input Parameters
| start_date | Optional date filter for stats |
| end_date | Optional date filter for stats |
Result
A structure with following keys
Resulting Structure
| summary | A dictionary of summary data for all campaigns included in the bundle with keys [start_date, end_date, total_views, total_shares, total_entries, total_optins] |
| bundles | A list of dictionaries representing all campaigns included in the bundle with keys [name, page_tab_id, views, shares, entries, opt_ins, max_views |
GET /v1/apps/<page_tab_id>/stats
Description
Obtain statistical data on executed campaign
Input Parameters
| start_date | Optional date filter for stats |
| end_date | Optional date filter for stats |
Result
A structure with following fields
Resulting Structure
| page_tab_id | |
| name | |
| total_entries | |
| fan_count | |
| view_count | |
| unique_view_count | |
| subscribers | Number of unique fans who subscribe to at least one of phone or email |
| phone_subscribers | Number of phone subscribers |
| email_subscribers | Number of email subscribers |
GET /v1/apps/<page_tab_id>/detailed_stats
Description
Fetch detailed stats for a campaign
Input Parameters
| target | One of leaderboard, fan_points, quiz_results, clicker_results, chat_history, overlay_timeline, feed_switching, websocket_connections,websocket_raw_connections,wager_points |
| start_timestamp | Optional date filter |
| end_timestamp | Optional date filter |
| tab_item_id | Optional filter to specific tab items |
Result
Array of objects depending on your requested target
GET /v1/apps/<page_tab_id>/props
Description
Get all props for a specific page tab
Result
A structure of campaign props with configured attributes
GET /v1/apps/<page_tab_id>
Description
Fetch configuration of existing campaign for custom visual or other purposes
Input Parameters
| include_details | Boolean value to include details like quiz questions/tab items/etc. |
Result
A structure of campaign with configured attributes
GET /v1/apps/<page_tab_id>/total_points
Description
Fetch total fan points for a campaign
Input Parameters
| start_timestamp | Optional date filter |
| end_timestamp | Optional date filter |
Result
A structure with following fields
Resulting Structure
| total_points |
GET /v1/apps/<page_tab_id>/wager_entries
Description
Fetch entries for a wager campaign
Input Parameters
| q | Query string |
| start_date | Optional date filter |
| end_date | Optional date filter |
Result
An array of Structures with following fields
Resulting Structure
| tab_item_id | |
| page_tab_id | |
| creation_date | |
| title | |
| subtitle | |
| description | |
| item_url | |
| tag_id | |
| tag_name | |
| position | |
| active_date | |
| props | |
| inventory_count | |
| item_count | |
| item_group_name | |
| activation_timestamp | |
| price | |
| media_uid | |
| items_purchased | |
| latitude | |
| longitude | |
| media_map | |
| wagers |
GET /v1/apps/<page_tab_id>/simple_points
Description
Fetch fan points for a campaign without any PII
Input Parameters
| start_timestamp | Optional date filter |
| end_timestamp | Optional date filter |
Result
A structure with following fields
Resulting Structure
| fan_id | |
| point_count | |
| creation_timestamp |
GET /v1/apps/<page_tab_id>/simple_activities
Description
Fetch fan activities for a campaign without any PII
Result
A structure with following fields
Resulting Structure
| fan_id | |
| activity_id | |
| creation_timestamp |
POST /v1/apps/<page_tab_id>/registration/checkin
Description
Check-in Event Pass for Registration campaign.
Input Parameters
| pass_code | 8 digit alphanumeric code. One of pass_code OR pass_uid required. |
| pass_uid | UUID. One of pass_code OR pass_uid required. |
Result
An Event Pass object with following structure
Resulting Structure
| pass_uid | |
| section_uid | |
| claim_fan_id | |
| fan_id | |
| transferee_email | |
| checked_in | |
| pass_code |
Fanxp Calls
GET /v1/fanxp/<page_tab_id>
Description
Verify FanXP campaign status and obtain required element to render it.
Input Parameters
| session_uid | A valid session identifier for logged in user |
Result
A Structure with following fields
Resulting Structure
| page_tab_id | |
| live_status | |
| pinned_overlays | |
| overlays | |
| shopify_products | |
| props | |
| style_props | |
| privacy | |
| terms | |
| rules | |
| links_map |
GET /v1/fanxp/<page_tab_id>/ip_address
Description
Check and return if ip address is registered in Chat moderation
Input Parameters
| ip_address | Optional ip address. REMOTE_ADDR is used otherwise |
Result
A Structure with following fields
Resulting Structure
| is_blocked | |
| ip_address |
GET /v1/fanxp/<page_tab_id>/chat_messages
Description
Fetch last 20 messages for a given channel on behalf of a user
Input Parameters
| session_uid | A valid session identifier for logged in user |
| room_name | Optional link to specific room for private messaging |
Result
An array of Structures with following fields
Resulting Structure
| chat_message_uid | |
| creation_timestamp | |
| room_name | |
| display_name | |
| message | |
| fan_id | |
| moderator_status |
GET /v1/fanxp/<page_tab_id>/fan_friends
Description
Fetch friends on behalf of a user
Input Parameters
| session_uid | A valid session identifier for logged in user |
Result
An array of Structures with following fields
Resulting Structure
| fan_id | |
| is_approved | null for a requested friend, true for an accepted friend and false for a declined friend. |
| creation_timestamp | |
| last_update_timestamp | |
| display_name | |
| is_online |
POST /v1/fanxp/<page_tab_id>/fan_friends
Description
Update friends on behalf of a user
Input Parameters
| session_uid | A valid session identifier for logged in user |
| fan_id | fan_id of the friend to modify (not the session fan) |
| action | remove is the only currently supported action |
Result
A Dictionary with the following fields
Resulting Structure
| status |
GET /v1/fanxp/<page_tab_id>/fan_friend_requests
Description
Fetch friend requests on behalf of a user
Input Parameters
| session_uid | A valid session identifier for logged in user |
Result
An dictionary of incoming and outgoing requests containing arrays of Structures with following fields
Resulting Structure
| fan_id | |
| is_approved | |
| creation_timestamp | |
| last_update_timestamp | |
| display_name |
POST /v1/fanxp/<page_tab_id>/fan_friend_requests
Description
Update friend requests on behalf of a user
Input Parameters
| session_uid | A valid session identifier for logged in user |
| fan_id | fan_id of the friend to modify (not the session fan) |
| action | one of [accept, decline, cancel, request] |
Result
A Dictionary with the following fields
Resulting Structure
| status |
GET /v1/fanxp/<page_tab_id>/chat_history
Description
Fetch detailed chat history
Input Parameters
| limit | Max # of records to return |
| q | Query string |
| min_timestamp | Only return messages sent after this timestamp, used for pagination |
| max_timestamp | Only return messages sent before this timestamp, used for pagination |
Result
A Dictionary with the following fields
Resulting Structure
| messages | An array of chat messages. See chat_messages endpoint for structure |
| min_timestamp | Earliest timestamp returned. Send this as max_timestamp in a future call to page backwards |
| max_timestamp | Latest timestamp returned. Send this as min_timestamp in a future call to page forwards |
POST /v1/fanxp/<page_tab_id>/clicker
Description
Push new clicker data.
Input Parameters
| session_uid | A valid session identifier for logged in user |
| instance_uid | Clicker instance reference |
| click_count | Click count |
Result
True
POST /v1/fanxp/<page_tab_id>/points
Description
Push new fan points data.
Input Parameters
| session_uid | A valid session identifier for logged in user |
| point_count | Value of points |
| point_name | Optional Point Name |
Result
True or False
POST /v1/fanxp/<page_tab_id>/report_chat
Description
Report a chat message
Input Parameters
| session_uid | A valid session identifier for logged in user |
| chat_message_uid | ID of the message to report |
Result
Confirmation of the save
POST /v1/fanxp/<page_tab_id>/answer
Description
Answer a question
Input Parameters
| session_uid | A valid session identifier for logged in user |
| quiz_question_id | Identifier for the question as per earlier message |
| answer_idx | Index of the answer as per websocket message |
Result
Confirmation of the save
GET /v1/fanxp/<page_tab_id>/answer
Description
Get the status of result
Input Parameters
| session_uid | A valid session identifier for logged in user |
| quiz_question_id | Identifier for the question as per earlier message |
Result
Result Line
GET /v1/fanxp/<page_tab_id>/leaderboard
Description
Get a Public Leaderboard
Input Parameters
| session_uid | A valid session identifier for logged in user |
| friends_only | Only return leaderboard info for friends of the logged in user |
Result
An array of following rows
Resulting Structure
| fan_id | |
| display_name | |
| correct_answer_count | |
| points | |
| clicker_points |
GET /v1/fanxp/<page_tab_id>/event_stats
Description
Obtain current values for team stats
Result
A Structure with following values
Resulting Structure
| page_tab_id | |
| home_team | |
| away_team | |
| home_score | |
| away_score | |
| game_period | |
| period_time_secs | |
| league_name | |
| stats |
GET /v1/fanxp/<page_tab_id>/player_stats
Description
Obtain current values for player stats
Result
A Structure with following values
Resulting Structure
| home_stats | An array with structure similar to stats in the event per player |
| away_stats | An array with structure similar to stats in the event per player |
GET /v1/fanxp/<page_tab_id>/vod
Description
Get a list of Video on Demand files.
Input Parameters
| page | What section is requested: waiting, staging or finished |
Result
An array of following structures
Resulting Structure
| option_id | |
| page_tab_id | |
| field_idx | |
| option_name | Name of the video |
| fb_photo_id | |
| fb_photo_url | |
| vimeo_video_url | Link to raw mp4 |
| vimeo_image_url | Link to raw preview |
| media_uid | Link to preview image media |
| creation_timestamp | |
| option_type | |
| description | |
| uploader_name | |
| uploader_email | |
| fan_id | |
| is_approved | |
| vote_count | |
| negative_vote_count | |
| is_correct | |
| tag_id | |
| tag_name | |
| activity_id | |
| share | |
| impressions | |
| clicks | |
| vimeo_key | This field is used to initialize embedded vimeo player |
| props |
GET /v1/fanxp/<page_tab_id>/live_endpoints
Description
Get a list of Live video endpoints.
Input Parameters
| session_uid | Session Identifier |
Result
An array of following structures
Resulting Structure
| live_feed | Primary Feed Object |
| additional_feeds | Array of additional feeds ( same format) |
| feed_name | |
| vimeo_event_key | |
| video_endpoint_uid | |
| media_uid | |
| is_gated | Whether feed is not normally public |
| location_gate_metro_areas | Feed should only be accessed by fans from these metro areas, if specified. |
GET /v1/fanxp/<page_tab_id>/chat_room
Description
Get room info including members
Input Parameters
| session_uid | A valid session identifier for logged in user |
| room_name |
Result
A Structure with following values
Resulting Structure
| room | a dictionary of data related to the requested room |
| room_members | a list of dictionaries containing info about the members of the requested room |
POST /v1/fanxp/<page_tab_id>/chat_room
Description
Join a room, leave a room, create a room, or add friends to an existing room.
Input Parameters
| session_uid | A valid session identifier for logged in user |
| room_name | A valid room name that contains only alphanumeric characters and underscores. Max character limit of 128 |
| action | join/leave/create/add |
| is_private | when using the create action, specifies if the created room should be private. Default False |
| room_members | a list of fan_ids for the create and add actions |
Result
True or False
GET /v1/fanxp/<page_tab_id>/fan_lookup
Description
Lookup a fan's friend status by fan_id or display_name
Input Parameters
| session_uid | A valid session identifier for logged in user |
| fan_id | |
| display_name |
Result
A Structure with following values
Resulting Structure
| fan_id | fan_id of the friend you want to lookup |
| display_name | display_name of the friend you want to lookup |
| friend_status | One of approved, requested, rejected, None |
