Grid
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/social/post/grid';const options = { method: 'POST', headers: { 'Wink-Version': '2.0', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: 'null'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/social/post/grid \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data nullReturns a paginated page of scheduled posts for the account driven by the supplied search/filter state.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Fetch posts for this managing entity ID
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Header Parameters
Section titled “Header Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”Search and filter criteria
Paginated search request for managed social posts, supporting filtering by status, platform, keyword, and scheduled date range.
object
Filter by target social platform
Example
WINK_LINKSFilter by post scheduled date range
object
Retrieve data range ending with and including this end date
Example
2020-12-31Retrieve data range starting with and including this start date
Example
2020-12-24Example
{ "endDate": "2020-12-31", "startDate": "2020-12-24"}Number of records to be skipped by the pager.
Example
0Descriptors used for sorting result set.
Descriptor that defines the sort direction and field for ordering a result set.
object
Descriptors used for sorting result set
Example
ascData set field to sort on
Example
hotel.nameExample
{ "dir": "asc", "field": "hotel.name"}Filter by post status (APPROVED, DRAFT, PUBLISHED, CANCELLED, etc)
Example
APPROVEDNumber of records to take.
Example
10Full-text search keyword
Example
luxury accommodationExample
{ "platform": "WINK_LINKS", "scheduledDate": { "endDate": "2020-12-31", "startDate": "2020-12-24" }, "skip": 0, "sort": [ { "dir": "asc", "field": "hotel.name" } ], "status": "APPROVED", "take": 10, "term": "luxury accommodation"}Responses
Section titled “Responses”Paginated list of managed social posts matching the search criteria
Owned pagination envelope: a page of content plus flat page metadata.
object
The elements on this page.
Lightweight projection of a scheduled social media post, used by consumers outside the managed-social module.
object
Datetime this record was first created
The post customization/template identifier used to create this post
A single entry array under most circumstances in the language the post was created for.
Foundation class for storing multi-language content (names and descriptions) with content change detection throughout the Wink Platform.
object
Whether it was user or system generated.
Longer text description
Indicate which language this description is written in.
The md5 hash of the name, description and language.
Use as title or short text description
Unique identifier for this record.
Datetime this record was last updated
A link to go with the text
object
Short caption typically showing the domain of the URL
Human-readable description of the link destination shown alongside the URL
The fully-qualified URL to link from the post
Optional geo-location
object
Platform-specific metadata for this post
object
CDN image/media assets (most platforms support up to 10 images per post)
object
Media angle
Whether image has attribution properties
object
Name of contributor
URL to contributor
Supported OTA specification PIC code. See OTA geoname data
Localized media captions to give user some context about where this media was taken.
Foundation class for storing multi-language content (names and descriptions) with content change detection throughout the Wink Platform.
object
Whether it was user or system generated.
Longer text description
Indicate which language this description is written in.
The md5 hash of the name, description and language.
Use as title or short text description
Media height in pixels.
Use this identifier to communicate with Cloudinary.
True if media width is greater or equal to height
Associate this media with a specific lifestyle type. A user searching and filtering inventory based on lifestyles can be shown relevant media first.
Document identifier
Instead of deleting the media, choose to un-publish it instead for later re-use. Could be you keep seasonal images of the property.
Sort allows you to control how you want to sort this record in a list of media records.
Currently ONLY using Cloudinary to store all image / video assets.
Whether Cloudinary media is a VIDEO or IMAGE.
Media width in pixels.
The managing entity this post belongs to
Which platform to post to.
The structural intent of this post.
Exact date and time when the post will be published (ISO 8601 format)
Status of post.
Human-readable status explanation (typically used for error messages)
IANA timezone identifier (e.g. Asia/Bangkok, America/New_York)
The language style used for this post.
Type of post.
The user ID that owns the account
Optimistic-locking version. Echo this value back as an If-Match request header on a conditional update; the server responds 409 if the record changed in the meantime. Null when this projection has no backing versioned document, in which case no conditional update is possible.
Whether this is the first page.
Whether this is the last page.
Zero-based index of this page.
Number of elements on this page.
The requested page size.
Total number of elements across all pages.
Total number of pages for the current page size.
Example
{ "content": [ { "customizationIdentifier": "d7e1b4f6-2c8a-4d2b-8f3e-6d9c7b2a0e5f", "descriptions": [ { "description": "Experience luxury living in the heart of Bangkok.", "language": "en", "name": "Discover The Siam Residences" } ], "hashTags": [ "#ThailandTravel" ], "id": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "ownerIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "platform": "FACEBOOK", "postType": "TRANSACTIONAL", "scheduledDate": "2026-03-15T18:30:00Z", "status": "APPROVED", "timezone": "Asia/Bangkok", "toneOfVoice": "NEUTRAL", "type": "MANUAL", "userIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "userTags": [ "@luxurytravel" ] } ], "first": true, "last": false, "number": 0, "numberOfElements": 20, "size": 20, "totalElements": 1234, "totalPages": 62}Bad Request — missing or invalid request parameter or body
object
object
Example
Unauthorized — authentication is required or the session has expired
object
object
Example
Forbidden — authenticated but lacking the required permission or scope
object
object
Example
Not Found — the requested resource does not exist
object
object
Example
Method Not Allowed — the HTTP verb is not supported on this endpoint
object
object
Example
Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version
object
object
Example
Unsupported Media Type — use application/json
object
object
Example
Internal Server Error — an unexpected failure occurred on the server
object
object
Example
Service Unavailable — a downstream dependency is unreachable