example-data.com
Menu
Browse docs and collections

stories

stories

Page 4 of 13.

Overview

Request

curl example

curl -sS \
  "https://example-data.com/api/v1/stories?limit=25"

JavaScript example

const res = await fetch(
  "https://example-data.com/api/v1/stories?limit=25"
);
const { data, meta } = await res.json();

TypeScript example

// Download once: mkdir -p types && curl -o types/stories.d.ts https://example-data.com/types/stories.d.ts
import type { Story, ListEnvelope } from "./types/stories";

const res = await fetch(
  "https://example-data.com/api/v1/stories?limit=25"
);
const { data, meta } = (await res.json()) as ListEnvelope<Story>;

Python example

import requests

res = requests.get(
    "https://example-data.com/api/v1/stories",
    params={"limit": 25},
)
data = res.json()

Response

{
  "data": [
    {
      "id": 73,
      "userId": 198,
      "mediaUrl": "https://api.dicebear.com/9.x/shapes/svg?seed=story-video-73",
      "mediaType": "video",
      "caption": "",
      "viewCount": 3130,
      "expiresAt": "2025-10-22T04:26:43.060Z",
      "createdAt": "2025-10-21T04:26:43.060Z"
    },
    {
      "id": 74,
      "userId": 62,
      "mediaUrl": "https://picsum.photos/seed/story-74/400/800",
      "mediaType": "image",
      "caption": "Autem amitto aggero apto creo arto.",
      "viewCount": 2878,
      "expiresAt": "2026-01-29T19:42:05.200Z",
      "createdAt": "2026-01-28T19:42:05.200Z"
    },
    {
      "id": 75,
      "userId": 200,
      "mediaUrl": "https://picsum.photos/seed/story-75/600/600",
      "mediaType": "image",
      "caption": "At cultura adhaero brevis patior totus suspendo tenuis absorbeo arceo.",
      "viewCount": 21,
      "expiresAt": "2026-01-13T22:11:52.607Z",
      "createdAt": "2026-01-12T22:11:52.607Z"
    }
  ],
  "meta": {
    "page": 4,
    "limit": 24,
    "total": 300,
    "totalPages": 13
  },
  "links": {
    "self": "/api/v1/stories?page=4&limit=24",
    "first": "/api/v1/stories?page=1&limit=24",
    "last": "/api/v1/stories?page=13&limit=24",
    "next": "/api/v1/stories?page=5&limit=24",
    "prev": "/api/v1/stories?page=3&limit=24"
  }
}