get-posts-stateless Docs & Discord
by kitty4d
collecting all the stuff i can find about this API endpoint! you can jump around to the different sections here. jump, jump around.
DeSo Official Documentation |
OG DeSo Discord - Technical Talk > technical-general |
OG DeSo - Technical Talk > nodes |
DeSo Foundation Tech - DEVELOPERS > dev-support |
DeSo Foundation Tech - DEVELOPERS > dev-general
here’s code i’ve written so far for dealing with this particular method, still in-progress - i’ll be putting it up on github eventually but maybe the code will help. i am using it over on my site - Kitty4D on the B-Chain - DeSo Post Vault - so, it does work.
first i have my method that calls the API
async getPosts({ pk = this.pkey, postHashHex = null, orderBy = '', postContent = '', numToFetch = null,
fetchSubComments = false, getPostsForFollowFeed = false, getPostsForGlobalWhitelist = false,
getPostsByDESO = false, mediaRequired = false, postsByDESOMinutesLookback = null,
addGlobalFeedBool = false }) {
let url = this.apiurl + 'get-posts-stateless';
try {
let res = await fetchCache(url, {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
ReaderPublicKeyBase58Check: pk,
PostHashHex: postHashHex,
OrderBy: orderBy,
StartTstampSecs: null,
PostContent: postContent,
NumToFetch: numToFetch,
FetchSubcomments: fetchSubComments,
GetPostsForFollowFeed: getPostsForFollowFeed,
GetPostsForGlobalWhitelist: getPostsForGlobalWhitelist,
GetPostsByDESO: getPostsByDESO,
MediaRequired: mediaRequired,
PostsByDESOMinutesLookback: postsByDESOMinutesLookback,
AddGlobalFeedBool: addGlobalFeedBool
})
});
return await res;
} catch (error) {
console.log(error);
}
return null;
}then i have a little helper method that just abstracts it out a little. originally i had my ‘get-posts-all’ logic in the code that requires this module, but i thought it might be more useful to include that in here. though i’m not 100% sure that a while loop is totally cool with these promises - but it works, and i did look things up as i was writing it.
case 'get-posts':
/* for Posts, pass:
pk: reader's public key,
postHashHex: for paging, send last received post hash,
orderBy: newest|oldest|last_comment,
postContent: only return posts whose (body only?) matches the text,
numToFetch: non-zero,
fetchSubComments: return 1 level deep of comments? haven't tested yet,
getPostsForFollowFeed: follow feed for reader's pk,
getPostsForGlobalWhitelist: global posts, i guess this is node-agnostic?,
getPostsByDESO: kinda basically the hot feed i guess,
mediaRequired: false, or true but would be nice to specify image and/or video
postsByDESOMinutesLookback: must be <= 60, getPostsByDESO = true - dunno why it doesn't work for all,
addGlobalFeedBool: posts will contain a bool (but i kinda thought they already had an IsGlobal..?)
*/
try {
res = await this.getPosts({ pk: params.readerPk ? params.readerPk : undefined,
postHashHex: params.postHashHex ? params.postHashHex : undefined,
orderBy: params.orderBy ? params.orderBy : undefined,
postContent: params.postContent ? params.postContent : undefined,
numToFetch: params.numToFetch ? params.numToFetch : 10,
mediaRequired: params.mediaRequired ? params.mediaRequired : false });
res = res.PostsFound;
} catch (error) {
res = [];
}
break;
case 'get-posts-all':
/* for Posts, pass:
pk: reader's public key,
postHashHex: for paging, send last received post hash,
orderBy: newest|oldest|last_comment,
postContent: only return posts whose (body only?) matches the text,
numToFetch: non-zero,
fetchSubComments: return 1 level deep of comments? haven't tested yet,
getPostsForFollowFeed: follow feed for reader's pk,
getPostsForGlobalWhitelist: global posts, i guess this is node-agnostic?,
getPostsByDESO: kinda basically the hot feed i guess,
mediaRequired: false, or true but would be nice to specify image and/or video
postsByDESOMinutesLookback: must be <= 60, getPostsByDESO = true - dunno why it doesn't work for all,
addGlobalFeedBool: posts will contain a bool (but i kinda thought they already had an IsGlobal..?)
*/
try {
let batch = null;
let results = [];
let lastPostHash = params.postHashHex ? params.postHashHex : undefined;
while (batch === null || batch.length) {
batch = await this.getPosts({ pk: params.readerPk ? params.readerPk : undefined,
postHashHex: lastPostHash, orderBy: params.orderBy ? params.orderBy : undefined,
postContent: params.postContent ? params.postContent : undefined,
numToFetch: params.numToFetch ? params.numToFetch : 10,
mediaRequired: params.mediaRequired ? params.mediaRequired : false });
batch = batch.PostsFound;
lastPostHash = '';
if (batch.length) {
results.push(...batch);
lastPostHash = batch[batch.length - 1].PostHashHex;
}
}
res = results;
} catch (error) {
res = [];
}
break;
DeSo Documentation
- Post Endpoints, docs.deso.org - recently updated~
it would be nice if it had info about the response, but even having info about the parameters is brand new and a welcome change. these links are provided on that page, but i’ll include them here as well. these links go to the DeSo Githubs:
- The Backend Code
- Front-end Request
- Get Following Feed
- Get Posts Ordered by Time
- Get Posts from Highest Coin Users in Past Hour
not nearly as much info about this from the discords as i guess i hoped, but below is what i could find!
OG DeSo Discord - Technical Talk > technical-general
tijn
That works when not logged in ?
Yup
This is going to be nearly impossible to reverse engineer
since their api is closed source
these routes only work for posts
Likewise:
curl 'https://api.bitclout.green/get-posts-stateless' \
-H 'content-type: application/json' \
--data-raw '{"PostHashHex":"","ReaderPublicKeyBase58Check":"BC1YLhxkeyUesN6W9c8gDrXtUkhBookv727L2fWwXdvfkUcd7EWW9uf","OrderBy":"","StartTstampSecs":null,"PostContent":"","NumToFetch":50,"FetchSubcomments":false,"GetPostsForFollowFeed":false,"GetPostsForGlobalWhitelist":true,"AddGlobalFeedBool":false}' \
--compressed
(Used to fetch posts in global)
It gives all decoded data
So the tx hex is never decoded client side (It seems?)
Unless it's decoded somewhere else
And if that's the case, this just got about 1000000000 times more complex
Lemme try sum
Is there a way to use get-posts-stateless to get only posts of one publickey? I am using it and it appears to just get a general list of random posts
Jesus Christ, why can't they just give us a list of API calls with parameters, all of them are actually in this file https://github.com/bitclout/explorer/blob/main/src/app/app.component.ts
2
I think they are building their own apps on top of Bitclout API, so this is not in their interest to make life of other devs easy.
it makes me angry as hell 
or maybe their level is so low that they simply have no idea what they are doing and how to make it right
cfky
Has anyone found a way to get the bitcoin deposit address linked to a bitclout wallet?
I noticed that it is appended to the mailto link on the help, mine looks like
"mailto:[email protected]?body=The below information helps support address your case.
My public key: BC1YLimromSjtiJo8Y7C9xwL9MFf8z5BdEidjWTC4WAiUZct2VrHbr8
My BTC Address: 1P3V4joGWzbFPmNEDSZgQw6KGrrT2vSZnf"
if that's what you meant
so I'm looking for timestamps, they're returned on the get-posts API, but I don't see them on blockchain explorer EDIT found PrivateMessageTxindexMetadata, maybe its a different place for each action
btw I got blockchain explorer running locally using mitmproxy but I'm annoyed with how much code it took, if anyone knows how to set headers on mitmproxy on the command line and not in a python script lmk
1
Is there a way to use get-posts-stateless to get only posts of one publickey? I am using it and it appears to just get a general list of random posts
leonardofibonacci
@salil have you figured out how to grab posts for one particular user?
The cURL should be:
curl 'https://api.bitclout.com/get-posts-for-public-key' \
-H 'Connection: keep-alive' \
-H 'Accept: application/json, text/plain, /' \
-H 'User-Agent: Mozilla/5.0 (Macintosh; Ontel Mac OS X 11_2_3) AppleWebKit/537/36 (KHTML, like Gecko) Chrome/89.0.4389.128 Safari/537.36' \
-H 'Content-Type: application/json' \
-H 'Accept-Language: en, zh-TW;q=0.8,en-US;q=0.7' \
--data-raw '{"PublicKeyBase58Check":"BC1YLgQkRFM1P3qvW5HQ47cTCikyfB464o4oEbqRkcqJohVs3jfUPib"}' \
--compressed \
--insecure
But it is not pulling the posts. Pretty sure there is some flag that needs to be passed in the body that we don't know off yet. Method seems to be correct
1
OG DeSo - Technical Talk > nodes
I was also wondering, when you call e.g. /api/v0/get-posts-stateless you get PostEntryResponse struct as a response. It has a LikeCount field, but doesn't contain details about who liked the post. Is there any way to get that information?
petern
I was also wondering, when you call e.g. /api/v0/get-posts-stateless you get PostEntryResponse struct as a response. It has a LikeCount field, but doesn't contain details about who liked the post. Is there any way to get that information?
haven't been there, i guess you can make some modifications to the backend ?
when i needed i joined a go discord channel lol the guys helped me a lot
Crypto Fren
haven't been there, i guess you can make some modifications to the backend ?
I noticed that in UtxoView you have a LikeKeyToLikeEntry field, which is exactly what I want, but it's currently only used to count the number of likes. I was trying to code it so that the PostEntryResponse also returns the LikeEntries. @maebeam Do you think it's possible to do, or should I give up and accept we can only get like count lol?
we can do it from the v1 api data with heavy post processing
i get 4+ mb of json data back from the trasancactions api
but that's just a hack/workaround. not a long term solution
if only those ConnectTransaction errors wouldn't return instead...
my mempool tab now pops this up but seems to be working when i close it
but the posts tabs work, every other tab works. that endpoint returns stuff
just when you refresh on the admin tabs
i cannot duplicate the 502 on that endpoint
petern
I noticed that in UtxoView you have a LikeKeyToLikeEntry field, which is exactly what I want, but it's currently only used to count the number of likes. I was trying to code it so that the PostEntryResponse also returns the LikeEntries. @maebeam Do you think it's possible to do, or should I give up and accept we can only get like count lol?
it is possible, backend is nothing from the other world
and golang is not so hard as it seems
kind of a mixture between python & c
petern
I noticed that in UtxoView you have a LikeKeyToLikeEntry field, which is exactly what I want, but it's currently only used to count the number of likes. I was trying to code it so that the PostEntryResponse also returns the LikeEntries. @maebeam Do you think it's possible to do, or should I give up and accept we can only get like count lol?
this is the code you're looking for https://github.com/bitclout/core/pull/15
JustifydWarrior
my mempool tab now pops this up but seems to be working when i close it
@maebeam same here, some txn paseed then node is being rejected
Thanks, also found the backend branch. This is how I feel about you and Rph now:
curl --location --request GET https://complimentr.com/api
DeSo Foundation Tech - DEVELOPERS > dev-support
Is anyone using the "MediaRequired" flag in the get-posts-stateless call? I am getting results that have no image or video URL. I do notice that some of the results have null in the value, while others have "". Is the backend only checking for nulls?
since MediaRequired flag does not work on get-posts-stateless, I need to pull 5000 posts to get 100 videos right now. I really hope this gets resolved. Issue raised on github.
justNick
since MediaRequired flag does not work on get-posts-stateless, I need to pull 5000 posts to get 100 videos right now. I really hope this gets resolved. Issue raised on github.
What is your use case? Trying to see if I can make it work on my wrapper
I'm only interested posts that have a valid VideoURL
also.. who's idea was it to not have follower count in profile? Am I missing something?
justNick
also.. who's idea was it to not have follower count in profile? Am I missing something?
yeah it's a separate endpoint... I actually just added it to the graphql wrapper hahaha
1
How do I get the sub comments to populate in the get-single-post call?
justNick
since MediaRequired flag does not work on get-posts-stateless, I need to pull 5000 posts to get 100 videos right now. I really hope this gets resolved. Issue raised on github.
This works btw afaik
Media is also in PostExtraData
PostExtraData?
i see tons with nothing in PostExtraData and no image or video url populated
is it including a post if it has a re-post with media?
even then I see posts with media and no reposts with empty PostExtraData. no media in sight
justNick
even then I see posts with media and no reposts with empty PostExtraData. no media in sight
Can you give me an example with a request and a post that doesn't match please?
check postHashHex a7ae35e78631fd4ce10941879bfe547931d4a633891ca2d800e0d03ee5d93faa. it is returned in the response
looks to me like the flag is ignored in post.go when not using followFeed or globalFeed option
I'm confused about a post I found yesterday that instead of null imageUrl and videoUrls, populates both with [""]. Anyone seen this before? https://bitclout.com/posts/bc3b36d3f8cc7c4734c73f4fb183c664ed482428373e574d633832e81262c128
@SpunkArt
@Twinsdivisions
@Marialalart
Thank you for the diamonds!!! Much 
...
...
piratekev
I'm confused about a post I found yesterday that instead of null imageUrl and videoUrls, populates both with [""]. Anyone seen this before? https://bitclout.com/posts/bc3b36d3f8cc7c4734c73f4fb183c664ed482428373e574d633832e81262c128
Yes, I have seen something like this. I have a code somewhere to deal with all of the combinations. (there is more if I remember correctly 
)
)
Kuririn
Yes, I have seen something like this. I have a code somewhere to deal with all of the combinations. (there is more if I remember correctly )
)
I can refactor to handle this scenario but was more curious how this occurred. I haven't been able to recreated it from any node, only by directly submitting a transaction with the imageUrl set as ""
piratekev
I can refactor to handle this scenario but was more curious how this occurred. I haven't been able to recreated it from any node, only by directly submitting a transaction with the imageUrl set as ""
if it's possible like that, then it's possible and doesn't really matter what node allows it. eventually it sounds like things will be tagged with originatingNode but even then, you never really know what app/site might be interacting with its backend API unless it's closed off
piratekev
I can refactor to handle this scenario but was more curious how this occurred. I haven't been able to recreated it from any node, only by directly submitting a transaction with the imageUrl set as ""
Upload image > then remove it > post it
is there a fixed max number of posts that can get returned by get-posts-stateless? or maybe a max amount of days back it can go? i don't mean per request. i got about 1135 posts and then the next request brought back an empty array.
kitty4D
is there a fixed max number of posts that can get returned by get-posts-stateless? or maybe a max amount of days back it can go? i don't mean per request. i got about 1135 posts and then the next request brought back an empty array.
you can paginate by PostHashHex or StartTstampSecs I believe, there is also NumToFetch param
DeSo Foundation Tech - DEVELOPERS > dev-general
Is there a way to check who owns an NFT through the API? I tried https://node.deso.org/api/v0/get-single-post but that doesn't have the info https://node.deso.org/api/v0/get-posts-stateless also doesn't seem to have that info...
Ah, found it - https://node.deso.org/api/v0/get-nft-entries-for-nft-post
how do I differentiate the hidden reposts in the API? 
curl --request POST \
--url https://love4src.com/api/v0/get-reposts-for-post \
--header 'content-type: application/json' \
--data '{"PostHashHex": "b0fd77e903517ee5aa01da9b7e5b39a5c1b4fa4d2fa4585120ddff64c5416ac2","Offset": 0,"Limit": 200}'
@mubashariqbal any idea?
Also why do post replies show-up in the quote-reposts?
curl --request POST \
--url https://love4src.com/api/v0/get-quote-reposts-for-post \
--header 'content-type: application/json' \
--data '{"PostHashHex": "b0fd77e903517ee5aa01da9b7e5b39a5c1b4fa4d2fa4585120ddff64c5416ac2","Offset": 0,"Limit": 200,"ReaderPublicKeyBase58Check": "BC1YLgLGxLRfMBTLjLHcS6borhxEtqXNPq2dCR3p2ihvPHsYNV9NGY7"}'
I want a reliable way to determine the non-hidden reposts & quote-reposts. Can someone guide me?
I believe in the response there is a "IsHidden" field. This is per node, so something might be hidden on DiamondApp, but not hidden on other nodes, and vice versa.
On DiamondApp UI the repost is hidden, though in the API - it is marked as IsHidden: false
How is the UI handling this? 