---
title: "List all posts"
url: "https://docs.unified.to/social/post/List_all_posts"
description: "API reference for List all posts. Launch multiple pre-built Post integrations today with zero maintenance — all through a single API."
---
# List all posts

 GET/social/{connection\_id}/post

## Parameters

**limit**number  default=100

**offset**number  default=0

**updated\_gte**date 

Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**sort** enum

name

updated\_at

created\_at

**order** enum

asc

desc

**query**string 

Query string to search. eg. email address or name

**profile\_id**string 

The profile ID to filter by

**fields**string array 

id

created\_at

updated\_at

profile\_id

parent\_post\_id

title

body

status

type

media

url

language

scheduled\_at

call\_to\_action

metrics

raw

Fields to return

**raw**string 

Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar

**connection\_id**string  required 

ID of the connection

## Returns

[SocialPost](/social/post/model)array

**id**string 

Unique identifier for the post

**created\_at**date 

When the post was created (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**updated\_at**date 

When the post was last updated (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**profile\_id**string 

The social profile (page/handle/listing) that owns this post

**parent\_post\_id**string 

The post this one replies to or references

**title**string 

Optional post title/headline

**body**string 

The main text content of the post

**status** enum

Valid values:

 "DRAFT" 

 "SCHEDULED" 

 "PUBLISHED" 

 "REJECTED" 

 "PROCESSING" 

Publication status of the post

**type** enum

Valid values:

 "POST" 

 "REPLY" 

 "REPOST" 

 "QUOTE" 

 "EVENT" 

The kind of post

**media** array 

Media assets attached to the post

**url**string 

Public permalink to the post

**language**string 

Language code of the post content

**scheduled\_at**date 

When the post is scheduled to publish (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**call\_to\_action**object 

Call-to-action button on the post

**metrics**object 

Engagement metrics for the post

**raw**any 

Raw data from integration

## Code Samples

### Node.js SDK

```
import { UnifiedTo } from '@unified-api/typescript-sdk';

const sdk = new UnifiedTo({
    security: {
        jwt: '<YOUR_API_KEY_HERE>',
    },
});

const connectionId = '5de520f96e439b002043d8dc';

const results = await sdk.social.listSocialPosts({ connectionId, 
    limit: 50,
    offset: 0,
    updated_gte: '2026-08-24T03:15:16.806Z',
    sort: 'updated_at',
    order: 'asc',
    query: '',
    profile_id: '',
    fields: '',
    raw: '',
 });
```

### Node.js (axios)

```
const options = {
  method: 'GET',
  url: 'https://api.unified.to/social/5de520f96e439b002043d8dc/post',
  headers: {
    authorization: 'bearer .....'
  },
  params: {
    limit: 50,
    offset: 0,
    updated_gte: '2026-08-24T03:15:16.806Z',
    sort: 'updated_at',
    order: 'asc',
    query: '',
    profile_id: '',
    fields: '',
    raw: '',
  }
};

const results = await axios.request(options);
```

### Java

```
AsyncHttpClient client = new DefaultAsyncHttpClient();

client.prepare("GET", "https://api.unified.to/social/5de520f96e439b002043d8dc/post?limit=50&offset=0&updated_gte=2026-08-24T03:15:16.806Z&sort=updated_at&order=asc&query=&profile_id=&fields=&raw=")
  .setHeader("accept", "application/json")
  .setHeader("authorization", ".....")
  .execute()
  .toCompletableFuture()
  .thenAccept(System.out::println)
  .join();

client.close();
```

### Go

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

url := `https://api.unified.to/social/5de520f96e439b002043d8dc/post?limit=50&offset=0&updated_gte=2026-08-24T03:15:16.806Z&sort=updated_at&order=asc&query=&profile_id=&fields=&raw=

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

req.Header.Add("accept", "application/json")
req.Header.Add("authorization", ".....")

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

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

### Python

```
import requests

url = "https://api.unified.to/social/5de520f96e439b002043d8dc/post?limit=50&offset=0&updated_gte=2026-08-24T03:15:16.806Z&sort=updated_at&order=asc&query=&profile_id=&fields=&raw="

headers = {
    "accept": "application/json",
    "authorization": "....."
}

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

### PHP

```
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.unified.to/social/5de520f96e439b002043d8dc/post?limit=50&offset=0&updated_gte=2026-08-24T03:15:16.806Z&sort=updated_at&order=asc&query=&profile_id=&fields=&raw=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "accept: application/json",
    "authorization: ....."
  ],
]);
```

### Ruby

```
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.unified.to/social/5de520f96e439b002043d8dc/post?limit=50&offset=0&updated_gte=2026-08-24T03:15:16.806Z&sort=updated_at&order=asc&query=&profile_id=&fields=&raw=")

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

request = Net::HTTP::Get.new(url)
request["accept"] = 'application/json'
request["authorization"] = '....'

response = http.request(request)
puts response.read_body
```

### cURL

```
curl --request GET \
  --url 'https://api.unified.to/social/5de520f96e439b002043d8dc/post?limit=50&offset=0&updated_gte=2026-08-24T03:15:16.806Z&sort=updated_at&order=asc&query=&profile_id=&fields=&raw=' \
  --header 'accept: application/json' \
  --header 'authorization: .....'
```