Skip to main content
GET
/
v1
/
scrape
/
threads
/
user-posts
Posts
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/threads/user-posts \
  --header 'X-API-Key: <api-key>'
import requests

url = "https://api.sociavault.com/v1/scrape/threads/user-posts"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.sociavault.com/v1/scrape/threads/user-posts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sociavault.com/v1/scrape/threads/user-posts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sociavault.com/v1/scrape/threads/user-posts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.sociavault.com/v1/scrape/threads/user-posts")
  .header("X-API-Key", "<api-key>")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.sociavault.com/v1/scrape/threads/user-posts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body
{ "success": true, "data": { "success": true, "posts": { "0": { "id": "3828488408293886842_63069450921", "pk": "3828488408293886842", "user": { "friendship_status": null, "pk": "63069450921", "profile_pic_url": "https://instagram.fpew3-1.fna.fbcdn.net/v/t51.2885-19/358000025_988841669212235_3183384987691331022_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby40MDAuYzIifQ&_nc_ht=instagram.fpew3-1.fna.fbcdn.net&_nc_cat=111&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=YN92uiZxHdsQ7kNvwEpII6C&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&oh=00_AfvnOwXK5LWdLBCJcT3JhMfK0zwCT95TgnMg-Ap2pXweQA&oe=698F6E15&_nc_sid=d92198", "username": "trendspider", "id": "63069450921", "transparency_label": null, "transparency_product": null, "transparency_product_enabled": false, "is_verified": false, "text_post_app_is_private": false, "has_onboarded_to_text_post_app": true }, "text_post_app_info": { "show_header_follow": false, "is_markup": false, "custom_feed_preview_info": null, "link_preview_attachment": null, "linked_inline_media": null, "special_effects_enabled_str": "", "text_fragments": { "fragments": { "0": { "fragment_type": "plaintext", "link_fragment": null, "mention_fragment": null, "plaintext": "Bears about to get electrocuted. $XLE ⚡️", "tag_fragment": null, "linkified_web_url": null } } }, "reshare_count": 1, "direct_reply_count": 1, "repost_count": 1, "quote_count": 0, "share_info": { "quoted_attachment_author_attribution_allowed": true, "quoted_attachment_post_unavailable": false, "quoted_attachment_post": null, "quoted_post": null, "reposted_post": null }, "reply_to_author": null, "reply_control": "everyone", "private_reply_partner": null, "self_thread_count": 0, "tag_header": null, "root_post_author": null, "pinned_post_info": { "is_pinned_to_parent_post": false, "is_pinned_to_profile": false }, "related_trends_info": null, "is_reply": false, "is_post_unavailable": false, "post_unavailable_reason": null, "hush_info": null }, "is_paid_partnership": null, "audio": null, "caption": { "text": "Bears about to get electrocuted. $XLE ⚡️", "pk": "18124847122482968", "has_translation": null }, "caption_is_edited": false, "transcription_data": null, "carousel_media": null, "code": "DUhhexTDst6", "image_versions2": { "candidates": { "0": { "height": 790, "url": "https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=dst-jpg_e35_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AftwC9O9IUwbpyRO1tC72wA3rBRVkcRgQir0abJXO7tifA&oe=698F6A8A&_nc_sid=d92198", "width": 1079 }, "1": { "height": 527, "url": "https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=dst-jpg_e35_s720x720_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_Aft_FORzSXbDVHbLlM6xjp38uLfK_51VJoc4qothIwsYuw&oe=698F6A8A&_nc_sid=d92198", "width": 720 }, "2": { "height": 469, "url": "https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=dst-jpg_e35_s640x640_sh0.08_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AfuQxWY2Oy3Q1qrjr7-qkVwfboWGEynLv79Zb1GqiJzV4w&oe=698F6A8A&_nc_sid=d92198", "width": 640 }, "3": { "height": 351, "url": "https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=dst-jpg_e35_s480x480_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AftLIsxKm4vynot2_6n_zg0Dg7Yf-W3K4JTi8KmTRK8Uog&oe=698F6A8A&_nc_sid=d92198", "width": 480 }, "4": { "height": 234, "url": "https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=dst-jpg_e35_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_Afv83ey5vozo49h6PNh_0J4lCGSrB7Fes3zURauk_qMO6Q&oe=698F6A8A&_nc_sid=d92198", "width": 320 }, "5": { "height": 176, "url": "https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=dst-jpg_e35_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AftJe9Zb8GhkRmz98lnHHbMwyIUBsDcBiz9kp0tipweuMQ&oe=698F6A8A&_nc_sid=d92198", "width": 240 }, "6": { "height": 790, "url": "https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=c144.0.790.790a_dst-jpg_e35_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AfuNu1KkMaCH2DnW-PuVxk63ypYya1usgel8elJc-Nu1Og&oe=698F6A8A&_nc_sid=d92198", "width": 790 }, "7": { "height": 750, "url": "https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=c144.0.790.790a_dst-jpg_e35_s750x750_sh0.08_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AfuGChCxSlp0mZ8spmB7DMrHUyFtnH1fNrHBgn8Zgjx5YQ&oe=698F6A8A&_nc_sid=d92198", "width": 750 }, "8": { "height": 640, "url": "https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=c144.0.790.790a_dst-jpg_e35_s640x640_sh0.08_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AfsLboFlhH1k1nbBamO0ZxfZlGx-hFrue9Lr-JKupAQQxg&oe=698F6A8A&_nc_sid=d92198", "width": 640 }, "9": { "height": 480, "url": "https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=c144.0.790.790a_dst-jpg_e35_s480x480_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AfvQ46R_XvLms_myEqfJ2Do9D9sPWwbBNoGwQSt9Tk9ZvA&oe=698F6A8A&_nc_sid=d92198", "width": 480 }, "10": { "height": 320, "url": "https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=c144.0.790.790a_dst-jpg_e35_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AfvkfR-WeWgVGyD3KzQfS4z_UKCjuVyI-8_WRPhWcXQarw&oe=698F6A8A&_nc_sid=d92198", "width": 320 }, "11": { "height": 240, "url": "https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=c144.0.790.790a_dst-jpg_e35_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AfuujlVCNDe7BuL-Kbu6f55QX6L2mIWGUFVm_D6h89AuhA&oe=698F6A8A&_nc_sid=d92198", "width": 240 }, "12": { "height": 150, "url": "https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=c144.0.790.790a_dst-jpg_e35_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_Afs6WTaZn4G9zZeqtUw_pv8-reqbLJSTd6aOomAUb8KuMA&oe=698F6A8A&_nc_sid=d92198", "width": 150 } } }, "original_height": 790, "original_width": 1079, "accessibility_caption": "May be an image of text that says \"TrendSpider Trend Spider XLE Weekly, Candles XLE,Weekly,Candles.chart chart Neekly Weekly XLE 53.25 45.16 44.24 41 41.89 89 62020 TrendSpider 74.59\"", "video_versions": null, "has_audio": null, "media_type": 1, "caption_add_on": null, "giphy_media_info": null, "media_overlay_info": null, "sharing_friction_info": { "should_have_sharing_friction": false, "sharing_friction_payload": null }, "like_count": 19, "metaPlace": null, "meta_place": null, "gen_ai_detection_method": null, "taken_at": 1770611422, "organic_tracking_token": "eyJ2ZXJzaW9uIjo1LCJwYXlsb2FkIjp7ImlzX2FuYWx5dGljc190cmFja2VkIjp0cnVlLCJ1dWlkIjoiNjkzN2IyMGUyYzkwNGEyODg5NDU0NjZlOTkxODBiN2UzODI4NDg4NDA4MjkzODg2ODQyIn0sInNpZ25hdHVyZSI6IiJ9", "logging_info_token": null, "like_and_view_counts_disabled": false, "url": "https://www.threads.com/@trendspider/post/DUhhexTDst6" } } }, "credits_used": 1, "endpoint": "user-posts" }
💳 1 credit per request

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

​
handle
string
required

Threads username

Example:

"trendspider"

​
trim
boolean

Set to true for a trimmed down version of the response

Example:

false

Response

Successful response

Key Response Fields:

  • data.posts[n].pk: Post unique ID
  • data.posts[n].user.username: Author Threads handle
  • data.posts[n].caption.text: Post text content
  • data.posts[n].code: Short post code used in URL construction
  • data.posts[n].like_count: Number of likes
  • data.posts[n].taken_at: Unix timestamp of post
  • data.posts[n].text_post_app_info.reshare_count: Reshare count
  • data.posts[n].text_post_app_info.direct_reply_count: Reply count
  • data.posts[n].url: Full URL to the post