Inspirations

Search inspirations

Search the viral-post inspiration index. All filters are optional. With none supplied the endpoint browses recent high-performing posts using default thresholds. The days-old window (min_days_old/max_days_old) and the absolute from/to window are mutually exclusive; if both are given, the days-old window wins and from/to are ignored.

get/v1/inspirations

Request

  • Base URL: https://api.taplio.com
  • URL: https://api.taplio.com/v1/inspirations
  • Auth: HTTP bearer

Query parameters

querystring
min_likesinteger nullable
min_commentsinteger nullable
max_followersinteger
max_days_oldinteger nullable
min_days_oldinteger nullable
min_char_countinteger nullable
fromstring nullable
tostring nullable
langstring
authorstring

Only posts written by this member: their linkedin.com/in/ profile url or the handle after /in/. With it, min_likes and min_char_count default to 0 and max_followers to no cap, so a large creator is not filtered out of their own posts.

limitinteger
cursorstring

Response

Paginated list of matching inspirations.

Example response

{
  "data": [
    {
      "author": {
        "followers_count": 18742,
        "headline": "Founder @ Acme · Helping B2B teams book more meetings",
        "image": "https://media.licdn.com/dms/image/v2/janedoe.jpg",
        "name": "Jane Doe",
        "profile_url": "https://www.linkedin.com/in/janedoe"
      },
      "content": "Most cold outreach fails for one reason: it's about you, not them.\n\nFlip it. Lead with their world. The reply rate takes care of itself.",
      "language": "en",
      "metrics": {
        "comments": 87,
        "likes": 1240,
        "shares": 31
      },
      "published_at": "2026-05-04T09:36:10.587Z",
      "url": "https://www.linkedin.com/feed/update/urn:li:activity:7457000200038072320/"
    }
  ],
  "meta": {
    "api_version": "v1",
    "has_more": true,
    "next_cursor": "eyJsYXN0SWQiOiJhYmMxMjMifQ==",
    "request_id": "req_a8f3e2c1"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.