.. include:: common.rst

Search
======

.. http:get:: /api/search.json

  Get a collection of statuses matching a specified query.

  :query str query: UTF-8 encoded query
  :query int page: (optional) the page number (starting at 1) to return
  :query int since_id: |status_since_id|
  :query int rpp: (optional) the number of notices to return per page, up to a
      max of 100
  :query str callback: if supplied when using the JSON format, the response will
      use the JSONP format with a callback of the given name

  **Example response**: a list of :ref:`status objects <status_object>`