Get one post - Reputably

Get one post

curl --request GET \
  --url https://app.reputably.net/api/entities/Post/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.reputably.net/api/entities/Post/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.reputably.net/api/entities/Post/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.reputably.net/api/entities/Post/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.reputably.net/api/entities/Post/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "workspace_id": "<string>",
  "business_location_id": "<string>",
  "platform": "gbp",
  "post_type": "update",
  "status": "draft",
  "scheduled_at": "<string>",
  "content": {},
  "external_post_id": "<string>",
  "published_at": "<string>",
  "error_message": "<string>",
  "error_count": 123,
  "ai_generated": true,
  "ai_chat_session_id": "<string>",
  "is_active": true
}

GET

/

api

/

entities

/

Post

/

{id}

Get one post

curl --request GET \
  --url https://app.reputably.net/api/entities/Post/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.reputably.net/api/entities/Post/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.reputably.net/api/entities/Post/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.reputably.net/api/entities/Post/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.reputably.net/api/entities/Post/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "workspace_id": "<string>",
  "business_location_id": "<string>",
  "platform": "gbp",
  "post_type": "update",
  "status": "draft",
  "scheduled_at": "<string>",
  "content": {},
  "external_post_id": "<string>",
  "published_at": "<string>",
  "error_message": "<string>",
  "error_count": 123,
  "ai_generated": true,
  "ai_chat_session_id": "<string>",
  "is_active": true
}

Authorizations

Authorization

string

header

required

An agent key (rpk_...) created in Settings → API & MCP, sent as Authorization: Bearer rpk_.... Bearer only: a cookie session can never drive this API. An OAuth 2.1 access token obtained from the same host works identically and lands on the same ceiling.

Headers

X-Workspace-Id

string

Which workspace to read. Omit it and you get the account’s home workspace, which on an agency account is often not where the live businesses are. A workspace this credential cannot read is refused with 403 rather than quietly answered from the default.

Path Parameters

id

string

required

The post id.

Response

The post.

id

string

Unique id.

workspace_id

string

business_location_id

string

platform

enum<string>

Forward-compat enum. Only 'gbp' in PR-16; future PRs add facebook/instagram/etc.

Available options:

gbp

post_type

enum<string>

Update is PR-16 only; offer/event added in PR-18.

Available options:

update,

offer,

event

status

enum<string>

PR-18 added 'scheduled' for future-dated posts the worker tick fires at scheduled_at.

Available options:

draft,

scheduled,

publishing,

published,

failed,

cancelled

scheduled_at

string

UTC timestamp. Null for immediate-publish or already-published posts.

content

object

external_post_id

string

GBP returns 'accounts/X/locations/Y/localPosts/Z'. Stored verbatim.

published_at

string

error_message

string

error_count

integer

ai_generated

boolean

ai_chat_session_id

string

is_active

boolean