Sign in

Get API v1 posts premium search

Changed on
get/api/v1/posts/premium/search

Request

  • The document declares no server URL.
  • Auth: HTTP bearer

Query parameters

search_strstring

String to fuzzy search premium posts on

Example:Northeastern University
limitinteger

Cap on the number of posts to return

Example:10
offsetinteger

Number of entries to skip for pagination

Example:8

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

countinteger required

Count of search results found for given search

Example response

{
  "$schema": "https://example.com/schemas/GetSearchPremiumPostResponse.json",
  "count": 5,
  "posts": [
    {
      "$schema": "https://example.com/schemas/PremiumPostResponse.json",
      "author": {
        "bio": "My name is Suli and I'm a pro athlete",
        "division": 1,
        "email": "suli123@email.com",
        "expected_grad_year": 2027,
        "first_name": "Suli",
        "last_name": "Suli",
        "sport": "hockey",
        "username": "suliproathelete",
        "verified_athelete_status": "pending"
      },
      "college": {
        "academic_rank": 53,
        "city": "Boston",
        "division_rank": 1,
        "name": "Northeastern University",
        "state": "Massachusetts",
        "website": "https://www.northeastern.edu"
      },
      "content": "My name is Bob Joe and I am a rising senior who just got into NEU. What is the fencing program like? Are they competitive?",
      "media": {
        "media_type": "jpeg",
        "s3key": "1",
        "title": "Video of Athlete"
      },
      "media_id": "123e4567-e89b-12d3-a456-426614174000",
      "sport": {
        "name": "Women's Soccer",
        "popularity": 20000
      },
      "tags": [
        {
          "name": "Hockey",
          "type": "sports"
        }
      ],
      "title": "Looking for thoughts on NEU Fencing!"
    }
  ]
}

Changes