itpints beta

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:

REST Parameters:

Parameter	Condition	Description
q	required	Url encoded query terms. It can include the same operators used on the search field of the website (eg: AND, OR) and exception (eg: "iphone apps -blackberry")
page	optional	page you want to retrieve (starting from 0)
searchtoken	required when paginating	the search identifier token, used to identify the search you made when you want to paginate.

Example:

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
• searchtoken - the search identifier you need to use when paginating
• page - the current page of the search
• nextpage - url to the next page of the search
• error - if true, there will be a error message
• errorString - description of the error
• resultCount - number of results
• domains_in_page - array containing all the sources domain names of the results on the search
• results - result items (array)
  • title
  • description
  • url
  • timestamp
  • thumbnail - story or media image
  • mediaurl - if the result contains an image or a video, the link to the media is in this property
  • author - author's username
  • avatar - author's profile image
  • authorlink - author's profile url
  • source - the original source's name