Read a post with its thread and replies
curl --request POST \
--url https://api.stophy.dev/v1/threads/post \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"post": "<string>",
"cursor": "<string>"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({post: '<string>', cursor: '<string>'})
};
fetch('https://api.stophy.dev/v1/threads/post', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.stophy.dev/v1/threads/post"
payload = {
"post": "<string>",
"cursor": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"success": true,
"data": {
"post": {
"url": "<string>",
"type": "text",
"isReply": true,
"isPinned": true,
"id": "<string>",
"code": "<string>",
"text": "<string>",
"author": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"url": "<string>",
"avatar": "<string>",
"isVerified": true
},
"createdAt": "2023-11-07T05:31:56Z",
"likes": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"shares": 0,
"images": [
{
"url": "<string>",
"caption": "<string>",
"alt": "<string>"
}
],
"videos": [
{
"url": "<string>"
}
],
"link": {
"url": "<string>",
"title": "<string>",
"description": "<string>",
"image": "<string>"
},
"replyTo": {
"id": "<string>",
"url": "<string>",
"username": "<string>"
},
"quoted": {
"url": "<string>",
"type": "text",
"isReply": true,
"isPinned": true,
"id": "<string>",
"code": "<string>",
"text": "<string>",
"author": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"url": "<string>",
"avatar": "<string>",
"isVerified": true
},
"createdAt": "2023-11-07T05:31:56Z",
"likes": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"shares": 0,
"images": [
{
"url": "<string>",
"caption": "<string>",
"alt": "<string>"
}
],
"videos": [
{
"url": "<string>"
}
],
"link": {
"url": "<string>",
"title": "<string>",
"description": "<string>",
"image": "<string>"
},
"replyTo": {
"id": "<string>",
"url": "<string>",
"username": "<string>"
}
},
"repostOf": {
"url": "<string>",
"type": "text",
"isReply": true,
"isPinned": true,
"id": "<string>",
"code": "<string>",
"text": "<string>",
"author": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"url": "<string>",
"avatar": "<string>",
"isVerified": true
},
"createdAt": "2023-11-07T05:31:56Z",
"likes": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"shares": 0,
"images": [
{
"url": "<string>",
"caption": "<string>",
"alt": "<string>"
}
],
"videos": [
{
"url": "<string>"
}
],
"link": {
"url": "<string>",
"title": "<string>",
"description": "<string>",
"image": "<string>"
},
"replyTo": {
"id": "<string>",
"url": "<string>",
"username": "<string>"
}
}
},
"thread": [
{
"url": "<string>",
"type": "text",
"isReply": true,
"isPinned": true,
"id": "<string>",
"code": "<string>",
"text": "<string>",
"author": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"url": "<string>",
"avatar": "<string>",
"isVerified": true
},
"createdAt": "2023-11-07T05:31:56Z",
"likes": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"shares": 0,
"images": [
{
"url": "<string>",
"caption": "<string>",
"alt": "<string>"
}
],
"videos": [
{
"url": "<string>"
}
],
"link": {
"url": "<string>",
"title": "<string>",
"description": "<string>",
"image": "<string>"
},
"replyTo": {
"id": "<string>",
"url": "<string>",
"username": "<string>"
},
"quoted": {
"url": "<string>",
"type": "text",
"isReply": true,
"isPinned": true,
"id": "<string>",
"code": "<string>",
"text": "<string>",
"author": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"url": "<string>",
"avatar": "<string>",
"isVerified": true
},
"createdAt": "2023-11-07T05:31:56Z",
"likes": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"shares": 0,
"images": [
{
"url": "<string>",
"caption": "<string>",
"alt": "<string>"
}
],
"videos": [
{
"url": "<string>"
}
],
"link": {
"url": "<string>",
"title": "<string>",
"description": "<string>",
"image": "<string>"
},
"replyTo": {
"id": "<string>",
"url": "<string>",
"username": "<string>"
}
},
"repostOf": {
"url": "<string>",
"type": "text",
"isReply": true,
"isPinned": true,
"id": "<string>",
"code": "<string>",
"text": "<string>",
"author": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"url": "<string>",
"avatar": "<string>",
"isVerified": true
},
"createdAt": "2023-11-07T05:31:56Z",
"likes": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"shares": 0,
"images": [
{
"url": "<string>",
"caption": "<string>",
"alt": "<string>"
}
],
"videos": [
{
"url": "<string>"
}
],
"link": {
"url": "<string>",
"title": "<string>",
"description": "<string>",
"image": "<string>"
},
"replyTo": {
"id": "<string>",
"url": "<string>",
"username": "<string>"
}
}
}
],
"replies": [
{
"url": "<string>",
"type": "text",
"isReply": true,
"isPinned": true,
"id": "<string>",
"code": "<string>",
"text": "<string>",
"author": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"url": "<string>",
"avatar": "<string>",
"isVerified": true
},
"createdAt": "2023-11-07T05:31:56Z",
"likes": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"shares": 0,
"images": [
{
"url": "<string>",
"caption": "<string>",
"alt": "<string>"
}
],
"videos": [
{
"url": "<string>"
}
],
"link": {
"url": "<string>",
"title": "<string>",
"description": "<string>",
"image": "<string>"
},
"replyTo": {
"id": "<string>",
"url": "<string>",
"username": "<string>"
},
"quoted": {
"url": "<string>",
"type": "text",
"isReply": true,
"isPinned": true,
"id": "<string>",
"code": "<string>",
"text": "<string>",
"author": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"url": "<string>",
"avatar": "<string>",
"isVerified": true
},
"createdAt": "2023-11-07T05:31:56Z",
"likes": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"shares": 0,
"images": [
{
"url": "<string>",
"caption": "<string>",
"alt": "<string>"
}
],
"videos": [
{
"url": "<string>"
}
],
"link": {
"url": "<string>",
"title": "<string>",
"description": "<string>",
"image": "<string>"
},
"replyTo": {
"id": "<string>",
"url": "<string>",
"username": "<string>"
}
},
"repostOf": {
"url": "<string>",
"type": "text",
"isReply": true,
"isPinned": true,
"id": "<string>",
"code": "<string>",
"text": "<string>",
"author": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"url": "<string>",
"avatar": "<string>",
"isVerified": true
},
"createdAt": "2023-11-07T05:31:56Z",
"likes": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"shares": 0,
"images": [
{
"url": "<string>",
"caption": "<string>",
"alt": "<string>"
}
],
"videos": [
{
"url": "<string>"
}
],
"link": {
"url": "<string>",
"title": "<string>",
"description": "<string>",
"image": "<string>"
},
"replyTo": {
"id": "<string>",
"url": "<string>",
"username": "<string>"
}
}
}
],
"cursor": "<string>"
},
"creditsUsed": 123,
"requestId": "<string>"
}{
"success": false,
"error": {
"code": "cliSessionCompleted",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"retryAfterSeconds": 123
}
}{
"success": false,
"error": {
"code": "cliSessionCompleted",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"retryAfterSeconds": 123
}
}Threads
Threads post API
Call the Threads post API to get post, thread and replies, as JSON or markdown. 1 credit.
POST
/
v1
/
threads
/
post
Read a post with its thread and replies
curl --request POST \
--url https://api.stophy.dev/v1/threads/post \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"post": "<string>",
"cursor": "<string>"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({post: '<string>', cursor: '<string>'})
};
fetch('https://api.stophy.dev/v1/threads/post', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.stophy.dev/v1/threads/post"
payload = {
"post": "<string>",
"cursor": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"success": true,
"data": {
"post": {
"url": "<string>",
"type": "text",
"isReply": true,
"isPinned": true,
"id": "<string>",
"code": "<string>",
"text": "<string>",
"author": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"url": "<string>",
"avatar": "<string>",
"isVerified": true
},
"createdAt": "2023-11-07T05:31:56Z",
"likes": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"shares": 0,
"images": [
{
"url": "<string>",
"caption": "<string>",
"alt": "<string>"
}
],
"videos": [
{
"url": "<string>"
}
],
"link": {
"url": "<string>",
"title": "<string>",
"description": "<string>",
"image": "<string>"
},
"replyTo": {
"id": "<string>",
"url": "<string>",
"username": "<string>"
},
"quoted": {
"url": "<string>",
"type": "text",
"isReply": true,
"isPinned": true,
"id": "<string>",
"code": "<string>",
"text": "<string>",
"author": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"url": "<string>",
"avatar": "<string>",
"isVerified": true
},
"createdAt": "2023-11-07T05:31:56Z",
"likes": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"shares": 0,
"images": [
{
"url": "<string>",
"caption": "<string>",
"alt": "<string>"
}
],
"videos": [
{
"url": "<string>"
}
],
"link": {
"url": "<string>",
"title": "<string>",
"description": "<string>",
"image": "<string>"
},
"replyTo": {
"id": "<string>",
"url": "<string>",
"username": "<string>"
}
},
"repostOf": {
"url": "<string>",
"type": "text",
"isReply": true,
"isPinned": true,
"id": "<string>",
"code": "<string>",
"text": "<string>",
"author": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"url": "<string>",
"avatar": "<string>",
"isVerified": true
},
"createdAt": "2023-11-07T05:31:56Z",
"likes": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"shares": 0,
"images": [
{
"url": "<string>",
"caption": "<string>",
"alt": "<string>"
}
],
"videos": [
{
"url": "<string>"
}
],
"link": {
"url": "<string>",
"title": "<string>",
"description": "<string>",
"image": "<string>"
},
"replyTo": {
"id": "<string>",
"url": "<string>",
"username": "<string>"
}
}
},
"thread": [
{
"url": "<string>",
"type": "text",
"isReply": true,
"isPinned": true,
"id": "<string>",
"code": "<string>",
"text": "<string>",
"author": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"url": "<string>",
"avatar": "<string>",
"isVerified": true
},
"createdAt": "2023-11-07T05:31:56Z",
"likes": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"shares": 0,
"images": [
{
"url": "<string>",
"caption": "<string>",
"alt": "<string>"
}
],
"videos": [
{
"url": "<string>"
}
],
"link": {
"url": "<string>",
"title": "<string>",
"description": "<string>",
"image": "<string>"
},
"replyTo": {
"id": "<string>",
"url": "<string>",
"username": "<string>"
},
"quoted": {
"url": "<string>",
"type": "text",
"isReply": true,
"isPinned": true,
"id": "<string>",
"code": "<string>",
"text": "<string>",
"author": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"url": "<string>",
"avatar": "<string>",
"isVerified": true
},
"createdAt": "2023-11-07T05:31:56Z",
"likes": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"shares": 0,
"images": [
{
"url": "<string>",
"caption": "<string>",
"alt": "<string>"
}
],
"videos": [
{
"url": "<string>"
}
],
"link": {
"url": "<string>",
"title": "<string>",
"description": "<string>",
"image": "<string>"
},
"replyTo": {
"id": "<string>",
"url": "<string>",
"username": "<string>"
}
},
"repostOf": {
"url": "<string>",
"type": "text",
"isReply": true,
"isPinned": true,
"id": "<string>",
"code": "<string>",
"text": "<string>",
"author": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"url": "<string>",
"avatar": "<string>",
"isVerified": true
},
"createdAt": "2023-11-07T05:31:56Z",
"likes": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"shares": 0,
"images": [
{
"url": "<string>",
"caption": "<string>",
"alt": "<string>"
}
],
"videos": [
{
"url": "<string>"
}
],
"link": {
"url": "<string>",
"title": "<string>",
"description": "<string>",
"image": "<string>"
},
"replyTo": {
"id": "<string>",
"url": "<string>",
"username": "<string>"
}
}
}
],
"replies": [
{
"url": "<string>",
"type": "text",
"isReply": true,
"isPinned": true,
"id": "<string>",
"code": "<string>",
"text": "<string>",
"author": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"url": "<string>",
"avatar": "<string>",
"isVerified": true
},
"createdAt": "2023-11-07T05:31:56Z",
"likes": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"shares": 0,
"images": [
{
"url": "<string>",
"caption": "<string>",
"alt": "<string>"
}
],
"videos": [
{
"url": "<string>"
}
],
"link": {
"url": "<string>",
"title": "<string>",
"description": "<string>",
"image": "<string>"
},
"replyTo": {
"id": "<string>",
"url": "<string>",
"username": "<string>"
},
"quoted": {
"url": "<string>",
"type": "text",
"isReply": true,
"isPinned": true,
"id": "<string>",
"code": "<string>",
"text": "<string>",
"author": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"url": "<string>",
"avatar": "<string>",
"isVerified": true
},
"createdAt": "2023-11-07T05:31:56Z",
"likes": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"shares": 0,
"images": [
{
"url": "<string>",
"caption": "<string>",
"alt": "<string>"
}
],
"videos": [
{
"url": "<string>"
}
],
"link": {
"url": "<string>",
"title": "<string>",
"description": "<string>",
"image": "<string>"
},
"replyTo": {
"id": "<string>",
"url": "<string>",
"username": "<string>"
}
},
"repostOf": {
"url": "<string>",
"type": "text",
"isReply": true,
"isPinned": true,
"id": "<string>",
"code": "<string>",
"text": "<string>",
"author": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"url": "<string>",
"avatar": "<string>",
"isVerified": true
},
"createdAt": "2023-11-07T05:31:56Z",
"likes": 0,
"replies": 0,
"reposts": 0,
"quotes": 0,
"shares": 0,
"images": [
{
"url": "<string>",
"caption": "<string>",
"alt": "<string>"
}
],
"videos": [
{
"url": "<string>"
}
],
"link": {
"url": "<string>",
"title": "<string>",
"description": "<string>",
"image": "<string>"
},
"replyTo": {
"id": "<string>",
"url": "<string>",
"username": "<string>"
}
}
}
],
"cursor": "<string>"
},
"creditsUsed": 123,
"requestId": "<string>"
}{
"success": false,
"error": {
"code": "cliSessionCompleted",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"retryAfterSeconds": 123
}
}{
"success": false,
"error": {
"code": "cliSessionCompleted",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"retryAfterSeconds": 123
}
}- Endpoint:
threads.post - Returns:
datahaspost,thread,replies. - Cost: 1 credit. Failed calls cost nothing.
- Paging: Yes. Send the
cursorfrom the response to get the next page. See Paging.
Example
import { Stophy } from "stophy";
const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.threads.post({ post: "https://www.threads.net/@zuck/post/C1a2B3cD4eF" });
console.log(result.data.post);
from stophy import Stophy
stophy = Stophy() # reads STOPHY_API_KEY
result = stophy.threads.post(post="https://www.threads.net/@zuck/post/C1a2B3cD4eF")
print(result["data"]["post"])
curl -X POST https://api.stophy.dev/v1/threads/post \
-H "Authorization: Bearer $STOPHY_API_KEY" \
-H "content-type: application/json" \
-d '{"post":"https://www.threads.net/@zuck/post/C1a2B3cD4eF"}'
stophy threads post https://www.threads.net/@zuck/post/C1a2B3cD4eF
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json