Quick & Dirty Mockup of a JSON api discovery document to overlay Twitter's API

json-api.json

{
  "api_name":"Twitter API",
  "arguments":[
    {"name":"query", "value":"input"},
    {"name":"status_id", "value":"response"},
    {"name":"format",
      "value":[
        {"name":"json","description":"Javascript Object Notation (JSON)"},
        {"name":"xml","description":"Extensible Markup Language (XML)"}
      ]
    }
  ],
  "resources":[
    { "name":"search",
      "url":"http://search.twitter.com/search.{format}?q={query}",
      "data":[
        { "name":"screen_name",  "pointer":"/results/*/from_user" },
        { "name":"profile_url",  "pointer":"/results/*/profile_image_url" },
        { "name":"status_id",  "pointer":"/results/*/id" }
      ]
    },
    { "name":"status",
      "url":"https://api.twitter.com/1/statuses/{status_id}.{format}"
    }
  ]
}