> Discover all available Postdom documentation from the machine-readable index: https://postdom.com/llms.txt

Configured tool · read-only

# `get_best_posts`

Rank one account's posts by one evidence-backed metric over a requested window.

read-only · non-destructive · closed-world

Human and agent roles

## Configured boundary

### Configured workspace

Null observations are excluded with a stated reason. They are never ranked as zero.

This reference describes the hosted server at https://api.postdom.com/mcp, which runs current source, with a workspace-scoped key created under Connected apps → For developers. The published `@postdom/mcp@0.4.0` package has 14 of these tools: it lacks list_posts, create_slideshow, account_music and the media array.

Callable schema

## Input fields

Field names match the configured tool schema. Runtime-only constraints are labeled separately from schema validation.

| Field | Type | Contract |
| --- | --- | --- |
| account_id Required | string | Connected account in this workspace The account whose published destinations are compared. |
| metric Required | metric | One normalized Postdom metric The single evidence-backed value used for ranking. |
| window Optional | 7d \| 30d | Defaults to 7d Rolling publication window ending at observation time. |

**For AI agents:** Send only fields exposed by the current tool schema.

**Known failure:** Do not invent platform settings, account IDs, media fields, or setup steps.

Synthetic values

## Example call

Identifiers and values are examples. They do not represent a connected workspace or accepted media source.

_EXAMPLE CALL · CONFIGURED TOOL SCHEMA_

```
get_best_posts({
  account_id: "acct_example_ig",
  metric: "watch_time_s",
  window: "30d"
})
```

Observed API record

## Return shape

Returns ranked posts and explicitly excluded posts for the same metric and period.

**`account_id · metric · window · period` (scope)** — Exact account, metric, rolling window, UTC bounds, and account timezone.

**`ranked` (array)** — Only posts with a non-null evidence-backed value, ordered descending.

**`ranked[].rank · metric` (evidence number)** — Value plus availability, observation time, and source.

**`excluded` (array)** — Published destinations omitted from ranking because the selected metric is null or unobserved.

**`excluded[].metric.availability.reason` (string)** — Why that post could not be ranked.

Stop conditions

## Agent handoff

`ranked`

### Report what happened

Preserve the metric, period, rank, and evidence metadata.

`excluded`

### Preserve the gap

Return each exclusion reason instead of inventing a zero.

`empty`

### Report no evidence

Do not infer a winner when no post has an available value.

 VERIFIED · 26 AUGUST 2026  **GET /v1/accounts/:id/best-posts · metric_snapshots**

Examples are synthetic. Human workspace-key creation and revocation remain in Postdom under Connected apps → For developers.