Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thinh-vu/fullstory_api
Python Client for Fullstory API
https://github.com/thinh-vu/fullstory_api
data-piplines fullstory-api raw-data-gathering
Last synced: about 2 months ago
JSON representation
Python Client for Fullstory API
- Host: GitHub
- URL: https://github.com/thinh-vu/fullstory_api
- Owner: thinh-vu
- License: mit
- Created: 2022-08-23T17:20:29.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2022-11-20T23:02:34.000Z (about 2 years ago)
- Last Synced: 2024-05-02T06:12:30.340Z (8 months ago)
- Topics: data-piplines, fullstory-api, raw-data-gathering
- Language: Python
- Homepage:
- Size: 25.4 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Fullstory API Python Client for Marketers and Data Engineers
# I. Introduction
## 📦 About FullStory
[FullStory](https://fullstory.com/) captures and replays your users' experiences so that you can build a better website or native mobile application. You can shape FullStory to your specific needs using our simple Client API and secure HTTP API.
## 😎 About this package
This Python Client allows you to control user data and export all event data captured by FullStory for external analysis with ease. All of the functions in this package use the HTTPS API endpoint from FullStory [here](https://developer.fullstory.com/introduction).
## ⚔️ Who should use this package?
- 💌 Marketers: Using a Standard API key, you can interact with FullStory in multiple ways. You can do basic data export operations such as: Exporting users' recorded events; user's visited pages, etc.
- 📝 Data Engineers / Data Analyst: Using an Admin API key, you can retrieve all kinds of data available on FullStory. You can also use this package to build your data pipeline to store FullStory in your data warehouse.
# II. References
## 2.1. How to install this package?
- Using pip to install the pre-built package on Pypip `pip install fullstory_api`
- If you want to use the latest fullstory_api version instead of the stable one, you can install it from the source with the following command:
`pip install git+https://github.com/thinh-vu/fullstory_api.git@main`
## 2.2. Available functions
There are 7 functions available in this package to interact with FullStory as follows:
### USERS
- `fs_user_export`: Export events or pages of historical data of a specific user by the userId. Reference [here](https://developer.fullstory.com/get-data-export)
- `fs_GetUser`: Get a summary of user information in a DataFrame format. Reference [here](https://developer.fullstory.com/get-user)
### SEGMENTS
- `fs_list_segment`: Get a list of all available segments on your Fullstory account. Reference [here](https://developer.fullstory.com/list-segments)
- `fs_segment_export`: Return the segment export as a DataFrame. This function combines the operation of 3 other functions at 1, including fs_schedule_segment_export, fs_operation_status, fs_export_result.
- `fs_schedule_segment_export`: Schedules an export based on the provided segment and returns the operationId. Reference [here](https://developer.fullstory.com/create-segment-export)
The progress and results of the export can be fetched from the operations API
### GET OPERATION
- `fs_operation_status`: Get details about a specific operation. Return a "searchExportId" that can be used to retrieve the export result. Reference [here](https://developer.fullstory.com/get-operation)
### SEARCH
- `fs_export_result`: Gets the results for a scheduled export. Return a link that can be used to retrieve the exported CSV gzip file. Reference [here](https://developer.fullstory.com/get-export-results)
# III. Quick tips
- Use the command dir(fullstory_api) To list down all of the available functions of this module in the Python IDE.
- Using pre-built function `fs_help(function_name)` to print the docstring helper of that function. For instance, you can type the command to the terminal with `fs_help(fs_export_result).`
- Use the command `from fullstory_api import *` to import all functions in this module to the Python Interpreter.
# IV. 🙋♂️ Contact Information
---
If you want to support my open-source projects, you can "buy me a coffee" via [Patreon](https://patreon.com/thinhvu?utm_medium=clipboard_copy&utm_source=copyLink&utm_campaign=creatorshare_creator) or Momo e-wallet (VN). Your support will help to maintain my blog hosting fee & to develop high-quality content.
