Engagement

List Reposters

Lists accounts that reposted a post, grouped by destination.

GET
/v1/retweets

Authorization

headerx-api-key<token>

Workspace API key, sent in the x-api-key header. Keys start with op_ and are created in the dashboard.

Query Parameters

post?string

Onepostly post id or platform-native post id. Native ids also need accountId. You can omit it when you pass destinationId.

Length1 <= length
accountId?string

Connection id. Required with a platform-native post id, and picks the destination when a Onepostly post has several.

Length1 <= length
destinationId?string

Destination id. It identifies one destination on its own, so post and accountId become optional.

Length1 <= length
limit?integer
Range1 <= value <= 100
cursor?string

Cursor from the previous response. Works only when the request points to a single destination.

Response Body

Reposters

application/json
  1. response
retweets*
Example Request
import { Configuration, EngagementApi } from "@onepostly/sdk";const engagementApi = new EngagementApi(  new Configuration({ apiKey: process.env.ONEPOSTLY_API_KEY }));const response = await engagementApi.listRetweeters({  post: "1699f415-7fb6-43f4-9d2a-c447491f32a8",  limit: 25,});console.log(response);
Example Response
{  "retweets": {    "post": "b3e1a7c2-8f4d-4e6a-9c1b-2d3e4f5a6b7c",    "subjects": [      {        "scope": "destination",        "subjectId": "d4e5f6a7-8b9c-4d0e-8f1a-2b3c4d5e6f7a",        "accountId": "a1b2c3d4-e5f6-4a7b-8c9d-e0f1a2b3c4d5",        "platform": "x",        "externalPostId": "1960956321831854280",        "status": "ready",        "actors": [          {            "id": "u1",            "username": "jane_doe",            "displayName": "Jane Doe",            "avatarUrl": "https://cdn.onepostly.com/avatars/jane.jpg"          }        ],        "nextCursor": null      }    ]  }}