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:
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
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
