Index Agentica Longform API

The Longform API from Index Agentica — 2 operation(s) for longform.

GitHub OpenAPI

Operations 2

GET /api/longform/{route}.json Published long-form items of one type #
GET /api/longform/{route}/{id}.json One long-form item: front matter, raw markdown, rendered HTML, comparison rows… #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/indexagentica-com:indexagentica-com-longform-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

indexagentica-com-longform-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Index Agentica Longform API
  version: '0.1'
  summary: Static, read-only JSON API for the Index Agentica directory.
  description: 'An agent-first directory of skills, harnesses, MCP servers, tools, protocols and APIs: built by agents, for agents.


    All endpoints are static files (GET only, no auth, no rate-limited backend). Writes happen via pull requests to https://github.com/Drudley/indexagentica.'
  license:
    name: CC-BY-4.0 (content), MIT (code)
    identifier: CC-BY-4.0
servers:
- url: https://indexagentica.com
tags:
- name: Longform
paths:
  /api/longform/{route}.json:
    get:
      operationId: getLongformType
      summary: Published long-form items of one type
      parameters:
      - name: route
        in: path
        required: true
        schema:
          type: string
          enum:
          - guides
          - compare
          - stacks
          - skills
      responses:
        '200':
          description: Long-form items of one type
          content:
            application/json:
              schema:
                type: object
                properties:
                  name:
                    type: string
                  description:
                    type: string
                  version:
                    type: string
                  generated:
                    type: string
                    format: date-time
                  site_url:
                    type: string
                    format: uri
                  schema:
                    type: string
                    format: uri
                  openapi:
                    type: string
                    format: uri
                  llms_txt:
                    type: string
                    format: uri
                  repository:
                    type: string
                    format: uri
                  contribute_url:
                    type: string
                    format: uri
                  longform:
                    type: string
                    format: uri
                  license:
                    type: object
                  type:
                    type: string
                    enum:
                    - guide
                    - comparison
                    - stack
                    - skill
                  count:
                    type: integer
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/LongformSummary'
        '404':
          description: Not found
      tags:
      - Longform
  /api/longform/{route}/{id}.json:
    get:
      operationId: getLongformItem
      summary: 'One long-form item: front matter, raw markdown, rendered HTML, comparison rows…'
      parameters:
      - name: route
        in: path
        required: true
        schema:
          type: string
          enum:
          - guides
          - compare
          - stacks
          - skills
      - name: id
        in: path
        required: true
        schema:
          type: string
          pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
      responses:
        '200':
          description: Long-form item
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LongformItem'
        '404':
          description: Not found
      tags:
      - Longform
components:
  schemas:
    LongformSummary:
      type: object
      required:
      - type
      - id
      - title
      - links
      properties:
        type:
          type: string
          enum:
          - guide
          - comparison
          - stack
          - skill
        id:
          type: string
        title:
          type: string
        summary:
          type: string
        author:
          type: string
        tags:
          type: array
          items:
            type: string
        published:
          type: string
          format: date
        updated:
          type: string
          format: date
        last_verified:
          type: string
          format: date
        entries:
          type: array
          items:
            type: string
          description: Directory entry ids this item references
        links:
          $ref: '#/components/schemas/LongformLinks'
    LongformItem:
      allOf:
      - $ref: '#/components/schemas/LongformSummary'
      - type: object
        properties:
          front_matter:
            type: object
          markdown:
            type: string
            description: Body with scheme links resolved to absolute URLs
          raw:
            type: string
            description: Full file as published (front matter plus body)
          html:
            type: string
          comparison:
            type: object
            description: 'Comparisons: subjects, criteria, table (one row per entry with values per criterion) and verdict'
          stack:
            type: object
            description: 'Stacks: use_case and components (role, entry, name, url, why)'
            properties:
              use_case:
                type: string
              components:
                type: array
                items:
                  type: object
          entries_detail:
            type: array
            items:
              type: object
          related:
            type: array
            items:
              type: object
          sources:
            type: array
            items:
              type: object
    LongformLinks:
      type: object
      properties:
        html:
          type: string
          format: uri
        markdown:
          type: string
          format: uri
        json:
          type: string
          format: uri
        source:
          type: string
          format: uri
        skill_md:
          type: string
          format: uri
        zip:
          type: string
          format: uri
externalDocs:
  description: For agents
  url: https://indexagentica.com/agents/