Uses This

API

What do people use to get the job done?

The API

Uses This provides a very simple, JSON-based API. Since it's 100% static (!), all requests are GET requests. I'd love to know if you do something interesting with it!

Interviews

Getting a list

This method returns a paginated list of all the interviews.

https://usesthis.com/api/interviews

{
  "interviews": [
    {
      "slug": "fizban.the.fabulous",
      "name": "Fizban the Fabulous",
      "url": "http://usesthis.com/interviews/fizban.the.fabulous/",
      "summary": "Wizard",
      "date": 1425970800,
      "categories": [
        "mac",
        "wizard"
      ],
      "credits": {
        "name": "Tanis Half-Elven",
        "url: "http://tanis15elf.com/"
      }
    },
    {
      "slug": "tasslehoff.burrfoot",
      "name": "Tasslehoff Burrfoot",
      "url": "http://usesthis.com/interviews/tasslehoff.burrfoot/",
      "summary": "Borrower",
      "date": 1425542400,
      "categories": [
        "linux",
        "thief"
      ],
      "credits": ""
    }
  ],
  "paging": {
    "current_page": "1",
    "item_count": "10",
    "page_count": "5",
    "next_page_url": "https://usesthis.com/api/interviews/?page=2",
    "previous_page_url": ""
  }
}
Getting an interview

This method returns a complete interview for the given slug, including gear.

https://usesthis.com/api/interviews/{slug}

{
  "interview": {
    "slug": "tasslehoff.burrfoot",
    "name": "Tasslehoff Burrfoot",
    "url": "http://usesthis.com/interviews/tasslehoff.burrfoot/",
    "summary": "Borrower",
    "date": 1425542400,
    "categories": [
      "linux",
      "thief"
    ],
    "credits": "",
    "contents": "#### Who are you, and what do you do?...",
    "gear": {
      "hardware": [
        {
          "slug": "hoopak",
          "name": "Hoopak",
          "description": "A wooden staff with a sling.",
          "url": "http://www.hoopaks-r-us.com/"
        }
      ],
      "software": [
        {
          "slug": "wanderlust",
          "name": "Wanderlust",
          "description": "A need for travel.",
          "url": "http://my-kender.net/"
        }
      ]
    }
  }
}
Getting categories

This method returns a basic list of all the interview categories.

https://usesthis.com/api/categories

{
  "categories": [
    "linux",
    "mac",
    "thief",
    "wizard"
  ]
}
Getting a category

This method returns a basic list of all the interviews for the given category.

https://usesthis.com/api/categories/{slug}

{
  "interviews": [
    {
      "slug": "fizban.the.fabulous",
      "name": "Fizban the Fabulous",
      "url": "http://usesthis.com/interviews/fizban.the.fabulous/",
      "summary": "Wizard",
      "date": 1425970800,
      "categories": [
        "mac",
        "wizard"
      ],
      "credits": {
        "name": "Tanis Half-Elven",
        "url: "http://tanis15elf.com/"
      }
    }
  ],
  "paging": {
    "current_page": "1",
    "item_count": "1",
    "page_count": "1",
    "next_page_url": "",
    "previous_page_url": ""
  }
}

Gear

Getting a list

This method returns a paginated list of all the hardware or software mentioned on the site.

https://usesthis.com/api/hardware
https://usesthis.com/api/software

{
  "gear": [
    {
      "slug": "hoopak",
      "name": "Hoopak"
    }
  ]
}
Getting an item

This method returns a single piece of hardware or software for the given slug, including related interviews.

https://usesthis.com/api/hardware/{slug}
https://usesthis.com/api/software/{slug}

{
  "gear": {
    "slug": "hoopak",
    "name": "Hoopak",
    "description": "A wooden staff with a sling.",
    "url": "http://www.hoopaks-r-us.com/",
    "interviews": [
      {
        "slug": "tasslehoff.burrfoot",
        "name": "Tasslehoff Burrfoot",
        "summary": "Borrower"
      }
    ]
  }
}

Stats

Getting general info

This method returns basic site statistics.

https://usesthis.com/api/stats

{
  "interviews": 10,
  "hardware": 42,
  "software": 69
}
Getting gear info

This method returns the top 50 hardware or software items mentioned on the site. You can also specify a given year by adding it to the URL.

https://usesthis.com/api/stats/hardware
https://usesthis.com/api/stats/software

{
  "gear": [
    {
      "slug": "hoopak",
      "name": "Hoopak",
      "description": "A wooden staff with a sling.",
      "url": "http://www.hoopaks-r-us.com/",
      "count": 1
    }
  ]
}