Inspiration & Templates

Search inspiration library

Searches Postiv's moderated LinkedIn inspiration corpus (pipeline_status='completed', moderation_status='approved', public creators only) with an optional semantic query plus exact filters.

GET/api/public/inspiration

cURLGET /api/public/inspiration

curl "https://postiv.ai/api/public/inspiration?query=launch%20week&limit=10&sort=virality" \
  -H "Authorization: Bearer pk_postiv_..."

200Response

{
  "success": true,
  "hits": [
    {
      "hook": "I lost my biggest client...",
      "summary": "A founder shares a churn lesson.",
      "creator": "Alex Hormozi",
      "creatorHandle": "@alexhormozi",
      "engagement": {
        "likes": 4200,
        "comments": 310,
        "shares": 90
      },
      "isLeadMagnet": false,
      "score": 0.74
    }
  ]
}

Authorization

Requires an organization API key with the inspiration:read scope, sent as Authorization: Bearer or x-api-key.

Query parameters

querystring

Semantic query, 1-2000 chars. Omit for filter-only search.

limitintdefault: 8

1-20.

creator_namestring

Filter by creator name or @handle, 1-200 chars.

lead_magnet_onlyboolean

As query string 'true'/'false'.

time_rangestring

One of:1D7D30D3M12M

sortstringdefault: "virality"

One of:viralityrecenttrendinglikescomments

likes_minint

likes_maxint

Must be >= likes_min.

comments_minint

comments_maxint

Must be >= comments_min.

content_typesstring[]

Comma-separated or repeated param, e.g. text/image/video/carousel.

typesstring[]

Inspiration categories, e.g. educational/promotional/personal/current_events.

follower_minint

follower_maxint

Must be >= follower_min.

Response

Matching inspiration posts.

hits[].hookstring|null

hits[].summarystring|null

hits[].bodystring|null

Full post text.

hits[].creatorstring|null

hits[].creatorHandlestring|null

hits[].creatorHeadlinestring|null

hits[].creatorFollowerCountint|null

hits[].engagementobject

{ likes, comments, shares }

hits[].postedAttimestamp|null

hits[].linkedinUrlstring|null

UTM params stripped.

hits[].categoriesstring[]|null

hits[].contentTypestring|null

hits[].typestring|null

main_category.

hits[].isLeadMagnetboolean

hits[].scorefloat|null

Similarity score, null when query was omitted.

hits[].creatorAvatarUrlstring|null

Signed S3 URL, only for S3-hosted (creators/ prefixed) avatars.

hits[].imageUrlstring|null

Signed S3 URL of the post's first S3-hosted image, if any.

Errors

400	invalid_inspiration_filters: a _max value is less than its _min pair
429	inspiration_embedding_failed: embedding provider rate-limited (only when query is set)
503	inspiration_embedding_failed / inspiration_search_failed: embedding or DB search failure

Good to know

content_types/types accept comma-separated values within a single query param or repeated params. Selective filters (creator_name, ranges, etc.) skip the fast ANN candidate-limiting path to avoid pgvector's post-filter false-empty behavior on narrow subsets.