SocialiQDocs
PlaygroundOpenAPIGet API key

Resources

Users

A user is a profile, creator, channel, or company. Address users by handle (preferred) or platform ID.

Get a profile

GET/v1/{platform}/users/{handle}

Fetch one normalized profile by handle.

FieldInTypeDescription
platformrequiredpathenumPlatform slug.
handlerequiredpathstringUsername / handle (without the @).

Request

curl "https://api.socialiq.dev/v1/tiktok/users/openai" \  -H "Authorization: Bearer sc_live_..."

Response

[ .JSON ]
{  "request_id": "sc_1122334455667788990a",  "data": {    "id": "user_998877",    "type": "profile",    "platform": "tiktok",    "handle": "openai",    "name": "OpenAI",    "metrics": { "followers": 1840000, "following": 12, "posts": 233 }  },  "source": { "provider": "socialcues", "endpoint": "tiktok.profile.fetch" }}
200 · profile

List a user's posts

GET/v1/{platform}/users/{handle}/posts

Page through a profile's posts in reverse-chronological order.

FieldInTypeDescription
platformrequiredpathenumPlatform slug.
handlerequiredpathstringUsername / handle.
limitdefault 20queryintegerItems per page, 1–50.
cursorquerystringPagination cursor.

Request

curl "https://api.socialiq.dev/v1/tiktok/users/openai/posts?limit=3" \  -H "Authorization: Bearer sc_live_..."

Response

[ .JSON ]
{  "request_id": "sc_2233445566778899001b",  "data": {    "items": [      { "id": "7350810998023949599", "type": "post", "text": "Latest post", "metrics": { "views": 248900 } }    ]  },  "page": { "next_cursor": "c2_eyJvIjozfQ", "has_more": true }}
200 · posts

List followers

GET/v1/{platform}/users/{handle}/followers

Page through a profile's followers. Swap to /following for the outbound list.

FieldInTypeDescription
platformrequiredpathenumPlatform slug.
handlerequiredpathstringUsername / handle.
limitdefault 20queryintegerItems per page, 1–50.
cursorquerystringPagination cursor.

Request

curl "https://api.socialiq.dev/v1/tiktok/users/openai/followers?limit=3" \  -H "Authorization: Bearer sc_live_..."

Response

[ .JSON ]
{  "request_id": "sc_3344556677889900112c",  "data": {    "items": [      { "id": "user_1", "handle": "fan_alpha", "name": "Alpha" },      { "id": "user_2", "handle": "fan_beta", "name": "Beta" }    ]  },  "page": { "next_cursor": "c2_eyJvIjozfQ", "has_more": true }}
200 · followers

Search profiles

GET/v1/{platform}/users/search

Search a platform's profiles, creators, or companies by keyword.

FieldInTypeDescription
platformrequiredpathenumPlatform slug.
qrequiredquerystringThe search query.
limitdefault 20queryintegerResults per page, 1–50.

Request

curl "https://api.socialiq.dev/v1/instagram/users/search?q=openai" \  -H "Authorization: Bearer sc_live_..."

Response

[ .JSON ]
{  "request_id": "sc_4455667788990011223d",  "data": {    "query": "openai",    "results": [      { "id": "user_998877", "handle": "openai", "name": "OpenAI", "metrics": { "followers": 1840000 } }    ]  },  "page": { "next_cursor": null, "has_more": false }}
200 · profiles