Data Tracking for Insights – Timings, Specifics, and Process
In Swonkie, insights data is automatically collected through the social media API. To ensure that the data is always up to date, we follow a specific tracking and validation process. Below, we explain the timings, functionality, and rules applied to this collection.
- Metric: Type of data that will be collected.
- History: Amount of time or data that can be imported as historical records.
- Data Update: Frequency of data updates (the second collection will only be attempted if the first one is unsuccessful).
| Social Network | Metric | History | Data Update | |
|---|---|---|---|---|
 | General Data | 90 days | Every day at 10:00 and 18:00 | |
 | Posts | 100 posts up to 90 days | Every day at 10:30 and 18:30 | |
 | Profiles | Real-time value | Every day at 10:50 and 18:50 | |
 | General Data | 90 days (except for follower-based data, which does not return history) | Every day at 10:00 and 18:00 | |
 | Posts | 100 posts up to 90 days | Every day at 10:30 and 18:30 | |
 | Profiles | Real-time value | Every day at 10:50 and 18:50 | |
 | Meta Ads | General Data | 90 days | Every day at 10:00 and 18:00 |
 | Meta Ads | Posts | 100 posts up to 90 days | Every day at 10:30 and 18:30 |
 | Meta Ads | Profiles | Real-time value | Every day at 10:50 and 18:50 |
 | General Data | 90 days (except for follower-based data, which does not return history) | Every day at 05:00 and 13:00 | |
 | Posts | 100 posts up to 90 days | Every day at 10:30 and 18:30 | |
 | Profiles | Real-time value | Every day at 10:50 and 18:50 | |
 | Threads | General Data | 90 days (except for follower-based data, which does not return history) | Every day at 10:00 and 18:00 |
 | Threads | Posts | 100 posts up to 90 days | Every day at 10:30 and 18:30 |
 | Threads | Profiles | Real-time value | Every day at 10:50 and 18:50 |
⚙️ How Does Data Collection Work?
Data collection can occur in two ways, depending on the profile authentication status:
1. Private Execution (Valid Authentication)
If the profile has valid authentication, the data will be collected privately. The following conditions must be met:
✅ The profile has valid authentication.
✅ The last successful API access (valid token) or social network update in Swonkie occurred within the last 30 days.
If these conditions are met, the collection happens smoothly.
2. Public Execution (If No Valid Authentication)
If no valid authentication is available, Swonkie attempts to collect data publicly. We check:
✅ Does the social network allow public data collection? If not, the profile will be ignored.
✅ Is the profile associated as a competitor? If it is linked to a workspace as a competitor, it may be processed publicly.
✅ Is there a recent token (last 30 days)? If yes, the profile will be processed publicly.
If none of these conditions are met, the profile will be ignored, and no data will be collected for that day.
🚨 Error Handling and Retries
🔄 Automatic Retries: If a temporary error occurs, data collection will be retried up to 5 times.
⚠️ Cases Where Data Collection Will Not Be Retried:
- The profile has been deleted or no longer exists.
- The Instagram account does not have an associated username (public collection is not possible).
❌ If a profile fails private collection but succeeds in public collection, it will not be processed again that day.
With this process, we ensure you always have the most up-to-date data for analysis in Swonkie! 🚀