Back to Apievangelist

Stories

api-stories.md

latest1.6 KB
Original Source

API Evangelist Network API

API Evangelist Network API

Stories

The API Evangelist blog — 5,000+ posts since 2010.


Stories

GET https://api.apievangelist.com/v1

/posts

Search or browse 5,000+ API Evangelist stories (2010–present); filter by year or tags.

Stories › query Parameters

q ​string

Free-text query over title, summary, tags, and body.

year ​string

Filter to one publication year.

tags ​string

Comma-separated tag slugs.

match ​string · enum

Tag match mode.

Enum values: any

all

Default: any

sort ​string · enum

Enum values: default

title

date

fields ​string

Comma-separated sparse field projection.

page ​integer · min: 1

Default: 1

limit ​integer · min: 1 · max: 100

Default: 25

Stories › Responses

200

Paged stories, newest first by default.

PagedEnvelope

meta ​object

dataDoc[]


Story

GET https://api.apievangelist.com/v1

/posts/{slug}

One story by slug (YYYY-MM-DD-slug); include=content adds the full markdown body.

Story › path Parameters

slug ​string · required

Story › query Parameters

include ​string · enum

Set to content to inline the full markdown body (up to 200 KB).

Enum values: content

Story › Responses

200404

The story.

Doc

type ​string

slug ​string

title ​string

summary ​string

url ​string · uri

tags ​string[]

date ​string

content ​string

Full markdown body when include=content.


OverviewAreas