You are viewing a section of Superface that will be deprecated in Q4 2023. Until then, you can continue to use it as you have before but we recommend that you migrate to our latest version soon. For more details visit superface.ai/docs/migrate.

Social Media Followers

social-media/followers@1.2.0
1 provider

Get Followers

Retrieve a paginated list of followers for a social media profile.

Input
Profile ID
Page
Result
Previous page
Next page
Followers
Rate limit

1.Choose a provider

2.Use GetFollowers with mock in your code

Below instructions are for our Node.js SDK. Use OneService for other languages.
npm i @superfaceai/one-sdk

Structure details

Input (object)

profileId
Identifier of a profile to retrieve followers from. May be optional with some providers.
page
Pagination cursor (obtained from `previousPage` or `nextPage`).

Example

Result (object)

previousPage
Previous page cursor.
nextPage
Next page cursor.
followers
List of followers.
id
Profile identifier of the follower.
username
Username of the follower.
imageUrl
Follower profile image url.
followersCount
How many followers does the follower have
followingCount
How many profiles is the follower following
postsCount
How many posts has the follower published
rateLimit
Rate limit details.
bucket
Different parts of API may have different rate limits. Bucket identifies to which part of API the rate limits apply.
totalRequests
Total requests available in the time window.
remainingRequests
Remaining requests available in the time window.
remainingRequestsPercentage
Remaining requests available in the time window in percents.
resetTimestamp
Timestamp when the rate limits will reset (in Unix Timestamp format). Available only for providers without rolling rate limit window.

Example

Implementation details

Provider
mock
Use case
GetFollowers
Author
@superface
Source
Verified