Endpoints

The socials API exposes the social accounts available in the authenticated public API context. These endpoints are read-only. The response shape is documented on the Social object page.

GET /socials

Return all social accounts accessible to the authenticated caller.

Notes

User-scoped API keys return socials owned by that user.
Workspace-scoped API keys return socials owned by that workspace.
Removed or pending socials are excluded.
Results are sorted by display_name ascending and then by id ascending.

Example request

curl --request GET \
  --url https://api.feedhive.com/socials \
  --header 'accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Response body

Field	Type	Description
success	boolean	Whether the request succeeded.
data.items	Social[]	Returned social accounts for this page.
data.total	number	Total number of social accounts accessible to the caller.
data.has_more	boolean	Whether another page of socials is available.
data.next_cursor	string \| null	Cursor for the next page, or null when there are no more results.

If no socials exist in the authenticated context, the API returns an empty items array and total: 0.

GET /socials/:id

Return a single social account by ID.

Path parameters

Field	Type	Description
id	string	Social account identifier.

Example request

curl --request GET \
  --url https://api.feedhive.com/socials/social_123 \
  --header 'accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Response body

Field	Type	Description
success	boolean	Whether the request succeeded.
data	Social	Requested social account.

Error responses

Status	Message	Description
`400`	`"Missing social ID"`	Path parameter is missing or empty.
`404`	`"Social not found"`	No supported social account exists with the given ID.
`403`	`"Access denied"`	The social exists but belongs to a different owner or context.

Social object OpenClaw