Back to Apievangelist

Media

api-media.md

latest4.0 KB
Original Source

API Evangelist Network API

API Evangelist Network API

Media

Conversations, videos, white papers, and the newsletter.


Conversations

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

/conversations

Search or browse recorded conversations with API practitioners, with guest and media metadata.

Conversations › query Parameters

q ​string

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

tags ​string

Comma-separated tag slugs.

page ​integer · min: 1

Default: 1

limit ​integer · min: 1 · max: 100

Default: 25

Conversations › Responses

200

Recorded conversations with guest and media metadata.

PagedEnvelope

meta ​object

dataDoc[]


Conversation

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

/conversations/{slug}

One conversation with guest detail and YouTube/SoundCloud links.

Conversation › path Parameters

slug ​string · required

Conversation › query Parameters

include ​string · enum

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

Enum values: content

Conversation › Responses

200404

The conversation.

Doc

type ​string

slug ​string

title ​string

summary ​string

url ​string · uri

tags ​string[]

date ​string

content ​string

Full markdown body when include=content.


Videos

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

/videos

Search or browse the video library (video.apievangelist.com) — interviews and discussions from across the API space, searchable by transcript.

Videos › query Parameters

q ​string

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

tags ​string

Comma-separated tag slugs.

page ​integer · min: 1

Default: 1

limit ​integer · min: 1 · max: 100

Default: 25

Videos › Responses

200

Videos with YouTube metadata.

PagedEnvelope

meta ​object

dataDoc[]


Video

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

/videos/{slug}

One video with its YouTube id; include=content adds the full transcript.

Video › path Parameters

slug ​string · required

Video › query Parameters

include ​string · enum

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

Enum values: content

Video › Responses

200404

The video.

Doc

type ​string

slug ​string

title ​string

summary ​string

url ​string · uri

tags ​string[]

date ​string

content ​string

Full markdown body when include=content.


Papers

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

/papers

API Evangelist white papers — deep dives distilled from sixteen years of research, with outlines.

Papers › query Parameters

q ​string

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

page ​integer · min: 1

Default: 1

limit ​integer · min: 1 · max: 100

Default: 25

Papers › Responses

200

Papers with outlines and landing URLs.

PagedEnvelope

meta ​object

dataDoc[]


Paper

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

/papers/{slug}

One paper with its full outline and landing URL.

Paper › path Parameters

slug ​string · required

Paper › Responses

200404

The paper.

Doc

type ​string

slug ​string

title ​string

summary ​string

url ​string · uri

tags ​string[]

date ​string

content ​string

Full markdown body when include=content.


Newsletter

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

/newsletters

Weekly newsletter editions.

Newsletter › query Parameters

page ​integer · min: 1

Default: 1

limit ​integer · min: 1 · max: 100

Default: 25

Newsletter › Responses

200

Weekly newsletter editions.

PagedEnvelope

meta ​object

dataDoc[]


OperationsReference