Find Post

Get Post by ID

Endpoint:

GET https://app.marketingblocks.co/api/v1/social-sparks/post/{post_id}

Retrieves detailed information about a specific social media post using its unique post_id. Requires the social-view-post permission.

---

Authentication

Type: Bearer Token

Authorization: Bearer <token>

---

Path Parameters

Parameter	Type	Required	Description	Example
post_id	string	yes	Unique identifier of the post to be retrieved.	1246

---

Example Request

cURL

curl --location --request GET \
'https://app.marketingblocks.co/api/v1/social-sparks/post/1246' \
--header 'Authorization: Bearer <token>'

Plain URL

GET https://app.marketingblocks.co/api/v1/social-sparks/post/1246

---

Response Structure

The response is a JSON object with the following fields:

• post (object): Contains details about the post.

• status (boolean): Indicates if the request was successful.

Post Object

Field	Type	Description
post_id	integer	The ID of the post.
channel_type	string	The type of channel (facebook, twitter, instagram, etc.).
channel_id	string	Unique identifier for the channel.
STATUS	string	The current status of the post (published, draft, failed).
permalink	string	Direct link to the post.

---

Example Response

{
  "post": {
    "post_id": 1246,
    "channel_type": "facebook",
    "channel_id": "254",
    "STATUS": "published",
    "permalink": "https://www.facebook.com/270235986170649/posts/270235986170649_122205223640252453"
  },
  "status": true
}