Get API v1 posts premium

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

Request

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

Query parameters

limitinteger

Number of posts to return

Example:50
offsetinteger

Number of posts to skip

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

totalinteger required

Total number of premium posts

Example response

{
  "$schema": "https://example.com/schemas/GetAllPremiumPostsResponse.json",
  "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!"
    }
  ],
  "total": 100
}

Changes

    • ○

      added the optional property /// to the response with the status

    • ▲

      removed the required property /// from the response with the status