Skip to main content
GET
Search viral posts (inspiration)

Authorizations

Authorization
string
header
required

Pass Authorization: Bearer scripe_sk_live_<...> (or scripe_sk_test_<...> for test keys) on every request. Keys are scoped to a single workspace and can be revoked from the Scripe dashboard.

The same header also accepts an OAuth 2.1 access token (scripe_oat_*); both credentials share one scope vocabulary and every operation below documents the scope it requires. An API key can hold every scope named on this surface except webhooks:manage, which is grantable to OAuth tokens only today — the webhook-endpoint operations answer 403 scope_missing to every API key. Operations that name no scope accept any valid token of the workspace.

Headers

Scripe-Api-Version
string

Pin the API version. Format YYYY-MM-DD. Omit to receive the currently rolling default. Unknown versions return 400 version_unsupported.

Example:

"2026-08-10"

Query Parameters

projectId
string
required
Example:

"proj_a1b2c3d4e5f6g7h8"

query
string
required

Free-text topic / theme.

Example:

"personal branding for founders"

sortBy
enum<string>
default:relevance
Available options:
relevance,
engagement,
recent
language
enum<string>
Available options:
all,
english,
german
minEngagement
integer
default:100
Required range: x >= 0
minOutlierMultiplier
number
default:2

Minimum outlier ratio — how far a post beat its OWN author's median engagement. Defaults to 2. Pass 0 to opt out of the outlier floor entirely. The stored ratio is capped at 10, so a value above 10 matches nothing.

Required range: x >= 0
mediaFormats
string

Comma-separated media shapes to keep. carousel is a swipeable deck (a document post), multi_image several photos in one post, image at most one. An unrecognised value is refused rather than ignored.

Example:

"carousel,multi_image"

publishedWithinDays
integer
default:90

How far back to search, in days.

Required range: 1 <= x <= 180
limit
integer
default:12

Page size. Default 12, max 30. Values above the max are clamped silently; only a non-integer or a value below 1 is rejected with bad_pagination.

Required range: 1 <= x <= 30

Response

Ranked viral posts.

data
object[]
required
meta
object
required