# 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"
// First page
const response = await fetch('https://api.infinipost.co/v1/accounts?platform=tiktok&limit=10', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const data = await response.json();
// Next page
if (data.hasMore) {
const nextResponse = await fetch(`https://api.infinipost.co/v1/accounts?platform=tiktok&limit=10&cursor=${data.nextCursor}`, {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
}
import requests
response = requests.get(
'https://api.infinipost.co/v1/accounts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={'platform': 'tiktok', 'limit': 10}
)
data = response.json()
# Next page
if data['hasMore']:
next_response = requests.get(
'https://api.infinipost.co/v1/accounts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={'platform': 'tiktok', 'limit': 10, 'cursor': data['nextCursor']}
)
{
"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"
// First page
const response = await fetch('https://api.infinipost.co/v1/accounts?platform=tiktok&limit=10', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const data = await response.json();
// Next page
if (data.hasMore) {
const nextResponse = await fetch(`https://api.infinipost.co/v1/accounts?platform=tiktok&limit=10&cursor=${data.nextCursor}`, {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
}
import requests
response = requests.get(
'https://api.infinipost.co/v1/accounts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={'platform': 'tiktok', 'limit': 10}
)
data = response.json()
# Next page
if data['hasMore']:
next_response = requests.get(
'https://api.infinipost.co/v1/accounts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={'platform': 'tiktok', 'limit': 10, 'cursor': data['nextCursor']}
)
{
"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
string
Filter by platform:
tiktok or instagram.string
Filter by account status:
created_pending_warmup, warming_up, or ready.number
default:"50"
Number of accounts to return (max 100).
string
Cursor for pagination. Pass the
nextCursor value from the previous response to get the next page. Omit for the first page.Response
array
Array of account objects.
Show Account object properties
Show Account object properties
string
Unique identifier for the account.
string
ID of the phone this account belongs to.
string
Platform:
tiktok or instagram.string
Display name of the account.
string
Account username. For TikTok accounts, this is set on Day 5 of warmup and may be empty before then.
string
Account bio.
string
Current account status:
created_pending_warmup, warming_up, or ready.number
Current day of the 7-day warmup period.
0 if warmup has not started.string
ISO 8601 date when warmup started.
null if warmup has not started.string
ISO 8601 date when warmup will complete.
null if warmup has not started.string
URL of the account’s profile picture.
string
ISO 8601 timestamp of when the account was created.
boolean
Whether there are more accounts beyond this page.
string
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"
// First page
const response = await fetch('https://api.infinipost.co/v1/accounts?platform=tiktok&limit=10', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const data = await response.json();
// Next page
if (data.hasMore) {
const nextResponse = await fetch(`https://api.infinipost.co/v1/accounts?platform=tiktok&limit=10&cursor=${data.nextCursor}`, {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
}
import requests
response = requests.get(
'https://api.infinipost.co/v1/accounts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={'platform': 'tiktok', 'limit': 10}
)
data = response.json()
# Next page
if data['hasMore']:
next_response = requests.get(
'https://api.infinipost.co/v1/accounts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={'platform': 'tiktok', 'limit': 10, 'cursor': data['nextCursor']}
)
{
"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