# ForCreaitors API Documentation
ForCreaitors is an AI-powered platform that helps content creators manage brand deals, analyze contracts, and track analytics across social platforms. This documentation covers the ForCreaitors public
---
## Overview
The ForCreaitors API is built on HTTPS and returns JSON responses. All endpoints require authentication via a Bearer token passed in the `Authorization` header.
**Base URL**
```
https://instagram-analytics-api.vercel.app
```
**Authentication**
All requests must include:
```
Authorization: Bearer YOUR_TOKEN
```
---
## Data Portability API (DTI)
ForCreaitors is applying to be a registered participant in the Data Transfer Initiative (DTI) Trust Registry. Our data portability endpoints allow creators to transfer their data from third-party platforms directly into ForCreaitors in a secure, standardized way.
---
### POST /api/dti/transfer
Receives an incoming data transfer from a DTI member platform on behalf of a creator.
**Endpoint**
```
POST https://instagram-analytics-api.vercel.app/api/dti/transfer
```
**Headers**
```
Authorization: Bearer YOUR_DTI_SHARED_SECRET
Content-Type: application/json
```
**Request Body**
```json
{
"userId": "string",
"dataType": "string",
"payload": {}
}
```
| Field | Type | Description |
|-------|------|-------------|
| userId | string | The ForCreaitors creator ID |
| dataType | string | Type of data being transferred (e.g. instagram_insights) |
| payload | object | The data payload from the source platform |
**Response**
```json
{
"status": "accepted",
"transferId": "fc_1712345678_abc123",
"message": "Transfer received successfully",
"timestamp": "2026-04-07T12:00:00.000Z"
}
```
| Field | Type | Description |
|-------|------|-------------|
| status | string | accepted or error |
| transferId | string | Unique ID to track this transfer |
| timestamp | string | ISO 8601 timestamp |
**Error Responses**
| Status | Meaning |
|--------|---------|
| 401 | Unauthorized — invalid or missing Bearer token |
| 405 | Method not allowed — only POST is accepted |
| 500 | Internal server error |
---
### POST /api/dti/auth
Validates that a creator has authorized a data transfer request.
**Endpoint**
```
POST https://instagram-analytics-api.vercel.app/api/dti/auth
```
**Headers**
```
Authorization: Bearer YOUR_DTI_SHARED_SECRET
Content-Type: application/json
```
**Request Body**
```json
{
"userId": "string",
"transferToken": "string"
}
```
| Field | Type | Description |
|-------|------|-------------|
| userId | string | The ForCreaitors creator ID |
| transferToken | string | Token issued when the creator authorized the transfer |
**Response**
```json
{
"status": "authorized",
"userId": "string",
"timestamp": "2026-04-07T12:00:00.000Z"
}
```
**Error Responses**
| Status | Meaning |
|--------|---------|
| 401 | Unauthorized — invalid or missing Bearer token |
| 403 | Forbidden — invalid transfer token |
| 405 | Method not allowed — only POST is accepted |
| 500 | Internal server error |
---
### GET /api/dti/status
Returns the current status of a data transfer by ID.
**Endpoint**
```
GET https://instagram-analytics-api.vercel.app/api/dti/status?transferId=fc_1712345678_abc123
```
**Headers**
```
Authorization: Bearer YOUR_DTI_SHARED_SECRET
```
**Query Parameters**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| transferId | string | Yes | The transfer ID returned from POST /api/dti/transfer |
**Response**
```json
{
"transferId": "fc_1712345678_abc123",
"status": "completed",
"timestamp": "2026-04-07T12:00:00.000Z"
}
```
**Transfer Statuses**
| Status | Meaning |
|--------|---------|
| accepted | Transfer received, processing queued |
| processing | Transfer is being stored |
| completed | Transfer successfully stored |
| failed | Transfer encountered an error |
**Error Responses**
| Status | Meaning |
|--------|---------|
| 400 | Bad request — transferId is required |
| 401 | Unauthorized — invalid or missing Bearer token |
| 404 | Transfer not found |
| 405 | Method not allowed — only GET is accepted |
| 500 | Internal server error |
---
## Data Handling
ForCreators is committed to responsible data handling in accordance with DTI standards.
- All data is transmitted over HTTPS
- Creator data is stored securely in MongoDB with access controls
- Creators can request deletion of their data at any time by contacting chrissy@forcreaitors.com
- Data is never sold or shared with third parties without explicit creator consent
- Access tokens are encrypted at rest
---
## Support
For API support or questions, contact us at:
- Email: chrissy@forcreators.com
- Website: https://www.forcreaitors.com
Last updated
Was this helpful?