itpints beta

Search

Itpints API

The itpints API allows developers to access and integrate itpints search services into their applications. The API is available to anyone to use without any kind of limitation, however we could limit the use in the future without advising.

The API provides a single stream of real-time search data aggregated from numerous social media properties.

Search API

Base URL prefix:

http://itpints.com/api/search

REST Parameters:

Parameter Condition Description
q required Url encoded query terms.
It can include operators (eg: AND, OR)
and exception (eg: "iphone apps -blackberry")
search_on[] optional Search on a specific media type, add another parameter name for each value

Parameter Values
  • blogs
  • news
  • bookmark
  • status
  • video
  • image

NOTICE: This parameter is temporally disabled. Will be enabled soon.

Example:

http://itpints.com/api/search?q="van+hunt"&search_on[]=video&search_on[]=image

Response Properties

The search API will return the following properties in JSON format. Not all meta data is available for every item.

  • apiMethod - the method called
  • query - the search query used in the request
  • error - if true, there will be a error message
  • errorString - description of the error
  • resultCount - number of results
  • results - result items (array)
    • title
    • description
    • url
    • timestamp
    • thumbnail - story or media image
    • author - author's username
    • avatar - author's profile image
    • authorlink - author's profile url
    • source - the original source's name