post/export

Exports posts as CSV.

Overview

Use this endpoint to export a filtered post dataset.

Authentication

Authentication is required. See Authentication.

Permissions

Authentication is required.

Endpoint

post/export

Purpose

Returns filtered posts serialized as CSV content.

Method and path

POST /post/export

Headers

Header	Required	Description
X-Api-Key or X_API_KEY	yes	API key.
Content-Type	yes	application/json.

Request body

Field	Type	Required	Description
project_id	integer	yes	Project identifier.
orderBy	string	no	Sort field. Default post_time.
orderDir	string	no	Sort direction. Default DESC.
limit	integer	no	Max rows. -1 means all matching rows.
offset	integer	no	Pagination offset.
Shared filters	mixed	no	Parsed and applied by the shared filter system.

Example request

curl -X POST "$SIGNAL_API_BASE_URL/post/export" \
  -H "X-Api-Key: $SIGNAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": 123,
    "limit": 500,
    "orderBy": "post_time",
    "orderDir": "DESC"
  }'

{
  "project_id": 123,
  "limit": 500,
  "orderBy": "post_time",
  "orderDir": "DESC"
}

Example response

"from","text","url","engagement","sentiment","time (UTC)","platform","language"
"account","post text","https://example.org/post","123","neu","2026-05-11 10:00:00","X","en"

Notes

• Response content type is text/csv.
• Backend removes line breaks and some punctuation from exported text fields.