Get Profile Smart Engagement Posts

Get Smart Engagement Posts towards a profile.

curl --location --request GET 'https://public-api.protokols.io/api/v1/profile/protokols_io/smart-engagement-posts?sorting=&sort_direction=&cursor=&post_types=tweet&date_from&date_to' \ --header 'authorization: Bearer 99f0c8fbb6df52400c8edac910f9dbb3be93faea06ba928bba24011252409c4a'

{ "posts": [ { "id": "string", "content": "string", "post_created_at": "2019-08-24T14:15:22Z", "created_by": "string", "comment_count": 0, "like_count": 0, "retweet_count": 0, "bookmark_count": 0, "view_count": 0, "type": "tweet", "quoted_post_id": "string", "reply_to_post_id": "string", "coins": [ "string" ], "mentions": [ "string" ], "media": "string", "retweeted_post_id": "string", "links": [ "string" ], "reply_to_user_id": "string", "contract_addresses": [ "string" ], "language": "string" } ], "pagination": { "page": 0, "limit": 0, "cursor": "string" } }

Request

Path Params

UsernameOrId

string

required

Twitter username or ID

Example:

protokols_io

Query Params

sorting

enum<string>

optional

Sorting type. Acceppted values: view_count, created_at.
Defaults to view_count

Allowed value:

views_count

sort_direction

string

optional

Sorting direction. Accepted values: asc, desc.
Defaults to desc.

cursor

string | null

optional

Page Cursor

post_types

string

optional

Comma seperated list of post types.
Accepted values: tweet, quote, retweet, reply
If not provided, all will be returned.

Example:

date_from

number

optional

Posts start date represented as UNIX timestamp.
Maximum date is 3 months.
Defaults to none.

date_to

number

optional

Posts end date represented as UNIX timestamp.
Defaults to current time.

Header Params

authorization

string

optional

Default:

Bearer {{auth_token}}

Responses

🟢200Success

application/json

Body

posts

array[object (Twitter Post) {20}]

optional

string

required

Unique post identifier

content

string

required

Post text content

post_created_at

string <date-time>

required

When the post was created

created_by

string

required

User ID who created the post

comment_count

integer

required

Number of comments/replies

like_count

integer

required

Number of likes

retweet_count

integer

required

Number of retweets

bookmark_count

integer

required

Number of bookmarks

view_count

integer

required

Number of views

type

enum<string>

required

Type of post

Allowed values:

tweetretweetquotereply

quoted_post_id

string | null

required

ID of quoted post if this is a quote tweet

reply_to_post_id

string | null

required

ID of post this is replying to

coins

array[string]

required

Cryptocurrency symbols mentioned

mentions

array[string]

required

Usernames mentioned in the post

media

string | null

required

Media content (JSON string or null)

retweeted_post_id

string | null

required

ID of original post if this is a retweet

links

array[string]

required

URLs mentioned in the post

reply_to_user_id

string | null

required

User ID this post is replying to

contract_addresses

array[string]

required

Smart contract addresses mentioned

language

string | null

required

Post language code

pagination

object (Pagination Meta)

required

page

integer

required

Current page number

limit

integer

required

Number of items per page

cursor

string | null

required

Cursor for next page (null if no more pages)

🟠404Record not found

🟠400Invalid input