# First page
curl "https://api.infinipost.co/v1/accounts?platform=tiktok&limit=10" \
-H "Authorization: Bearer YOUR_API_KEY"
# Next page (using cursor from previous response)
curl "https://api.infinipost.co/v1/accounts?platform=tiktok&limit=10&cursor=cGhvbmVfYWJjMTIz" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"data": [
{
"accountId": "acc_1a2b3c4d5e",
"phoneId": "phone_abc123",
"platform": "tiktok",
"name": "Fashion Insider",
"username": "fashioninsider",
"bio": "Daily fashion tips and trends 👗",
"accountStatus": "warming_up",
"warmupDay": 3,
"warmupStartDate": "2024-04-19T10:00:00Z",
"warmupCompletionDate": "2024-04-26T10:00:00Z",
"profilePicUrl": "https://storage.googleapis.com/...",
"createdAt": "2024-04-19T10:00:00Z"
},
{
"accountId": "acc_9f8e7d6c5b",
"phoneId": "phone_def456",
"platform": "tiktok",
"name": "Tech Reviews",
"username": "techreviews2024",
"bio": "Honest tech reviews every week 📱",
"accountStatus": "ready",
"warmupDay": 7,
"warmupStartDate": "2024-04-15T14:30:00Z",
"warmupCompletionDate": "2024-04-22T14:30:00Z",
"profilePicUrl": "https://storage.googleapis.com/...",
"createdAt": "2024-04-15T14:30:00Z"
}
],
"hasMore": true,
"nextCursor": "cGhvbmVfYWJjMTIz"
}
Accounts
List Accounts
Retrieve a list of all your TikTok and Instagram accounts
GET
/
v1
/
accounts
# First page
curl "https://api.infinipost.co/v1/accounts?platform=tiktok&limit=10" \
-H "Authorization: Bearer YOUR_API_KEY"
# Next page (using cursor from previous response)
curl "https://api.infinipost.co/v1/accounts?platform=tiktok&limit=10&cursor=cGhvbmVfYWJjMTIz" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"data": [
{
"accountId": "acc_1a2b3c4d5e",
"phoneId": "phone_abc123",
"platform": "tiktok",
"name": "Fashion Insider",
"username": "fashioninsider",
"bio": "Daily fashion tips and trends 👗",
"accountStatus": "warming_up",
"warmupDay": 3,
"warmupStartDate": "2024-04-19T10:00:00Z",
"warmupCompletionDate": "2024-04-26T10:00:00Z",
"profilePicUrl": "https://storage.googleapis.com/...",
"createdAt": "2024-04-19T10:00:00Z"
},
{
"accountId": "acc_9f8e7d6c5b",
"phoneId": "phone_def456",
"platform": "tiktok",
"name": "Tech Reviews",
"username": "techreviews2024",
"bio": "Honest tech reviews every week 📱",
"accountStatus": "ready",
"warmupDay": 7,
"warmupStartDate": "2024-04-15T14:30:00Z",
"warmupCompletionDate": "2024-04-22T14:30:00Z",
"profilePicUrl": "https://storage.googleapis.com/...",
"createdAt": "2024-04-15T14:30:00Z"
}
],
"hasMore": true,
"nextCursor": "cGhvbmVfYWJjMTIz"
}
Query Parameters
Filter by platform:
tiktok or instagram.Filter by account status:
created_pending_warmup, warming_up, or ready.Number of accounts to return (max 100).
Cursor for pagination. Pass the
nextCursor value from the previous response to get the next page. Omit for the first page.Response
Array of account objects.
Show Account object properties
Show Account object properties
Unique identifier for the account.
ID of the phone this account belongs to.
Platform:
tiktok or instagram.Display name of the account.
Account username. For TikTok accounts, this is set on Day 5 of warmup and may be empty before then.
Account bio.
Current account status:
created_pending_warmup, warming_up, or ready.Current day of the 7-day warmup period.
0 if warmup has not started.ISO 8601 date when warmup started.
null if warmup has not started.ISO 8601 date when warmup will complete.
null if warmup has not started.URL of the account’s profile picture.
ISO 8601 timestamp of when the account was created.
Whether there are more accounts beyond this page.
Cursor to pass as the
cursor query parameter to retrieve the next page. null when there are no more pages.# First page
curl "https://api.infinipost.co/v1/accounts?platform=tiktok&limit=10" \
-H "Authorization: Bearer YOUR_API_KEY"
# Next page (using cursor from previous response)
curl "https://api.infinipost.co/v1/accounts?platform=tiktok&limit=10&cursor=cGhvbmVfYWJjMTIz" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"data": [
{
"accountId": "acc_1a2b3c4d5e",
"phoneId": "phone_abc123",
"platform": "tiktok",
"name": "Fashion Insider",
"username": "fashioninsider",
"bio": "Daily fashion tips and trends 👗",
"accountStatus": "warming_up",
"warmupDay": 3,
"warmupStartDate": "2024-04-19T10:00:00Z",
"warmupCompletionDate": "2024-04-26T10:00:00Z",
"profilePicUrl": "https://storage.googleapis.com/...",
"createdAt": "2024-04-19T10:00:00Z"
},
{
"accountId": "acc_9f8e7d6c5b",
"phoneId": "phone_def456",
"platform": "tiktok",
"name": "Tech Reviews",
"username": "techreviews2024",
"bio": "Honest tech reviews every week 📱",
"accountStatus": "ready",
"warmupDay": 7,
"warmupStartDate": "2024-04-15T14:30:00Z",
"warmupCompletionDate": "2024-04-22T14:30:00Z",
"profilePicUrl": "https://storage.googleapis.com/...",
"createdAt": "2024-04-15T14:30:00Z"
}
],
"hasMore": true,
"nextCursor": "cGhvbmVfYWJjMTIz"
}
Error Responses
Unauthorized
{
"error": {
"code": "unauthenticated",
"message": "Invalid or missing API key"
}
}
Invalid Platform
{
"error": {
"code": "invalid_parameter",
"message": "platform must be either 'tiktok' or 'instagram'"
}
}
Invalid Status
{
"error": {
"code": "invalid_parameter",
"message": "status must be one of: created_pending_warmup, warming_up, ready"
}
}
Invalid Cursor
{
"error": {
"code": "invalid_parameter",
"message": "Invalid cursor"
}
}
Server Error
{
"error": {
"code": "internal",
"message": "An unexpected error occurred"
}
}
⌘I