research-with-api-evangelist
Description: Deep-research an API topic with API Evangelist — the curated cross-network guide bundle plus the full research bodies behind it.
Pro tier. The guide bundle and full-content export require an API Evangelist Pro key. Discovery (search, browse, summaries) stays free. See https://developer.apievangelist.com/plans/ — or reach Kin Lane at [email protected].
When to use this skill
Use when a briefing isn’t enough — you need the depth: the curated bundle across areas, guidance, rules, policies, papers, and stories, plus the full research bodies to quote and synthesize from.
The v1 API
Base URL: https://api.apievangelist.com/v1. Send your key as x-api-key: <key>.
| Step | Call | Tier | Why |
|---|---|---|---|
| 1. Guide | GET /guide?topic=<topic> |
Pro | Curated bundle: area, guidance, rules, policies, standards, papers, stories, services. |
| 2. Full text | GET /<type>/<slug>?include=content |
Pro | The complete research body for the key items. |
| 3. Related | GET /<type>/<slug>/related |
Free | Branch out along the shared-tag relevance graph. |
MCP equivalents: guide_topic, get_post/get_paper/get_building_block with include:["content"], find_related. Or run the research_topic prompt.
Recipe
B=https://api.apievangelist.com/v1
curl -s -H "x-api-key: $AE_KEY" "$B/guide?topic=api%20governance" | jq '{area:.area.title, guidance:[.guidance[].title], rules:[.rules[].title]}'
curl -s -H "x-api-key: $AE_KEY" "$B/guidance/<slug>?include=content" | jq -r '.content' | head -40
Output format (recommended)
A research briefing:
- The state of the topic per API Evangelist’s research.
- The key guidance, rules, and policies (with links), quoting the strongest sources.
- What a team should do next — and where an API Evangelist engagement fits.
Related skills
brief-on-topic— the free, fast version.governance-starter-kit— governance specifically (Pro).map-vendor-landscape— the vendor/tooling angle (Pro).