Search results for "{{ search.query }}"

No results found for "{{search.query}}". 
View All Results

GET Parameters

In order to use the API you need to call an endpoint URL with your private access token.

https://webhose.io/filterWebContent?token=xxxxx-xxxx-xxxxx&format=json&q=[QUERY]

HTTP GET Parameters

Parameter
Description
Example

q

A string query containing the filters that define which posts will be returned.

Find any post containing either ipod or ipad, but not android:

(ipod OR ipad) -android

token

Your private access token. You get a unique access token when you sign up.

sort

By default (when the sort parameter isn't specified) the results are sorted by the recommended order of crawl date.
You can however change the sort order by using the following values:


  • relevancy
  • social.facebook.likes
  • social.facebook.shares
  • social.facebook.comments
  • social.gplus.shares
  • social.pinterest.shares
  • social.linkedin.shares
  • social.stumbledupon.shares
  • social.vk.shares
  • replies_count
  • participants_count
  • spam_score
  • performance_score
  • published
  • thread.published
  • domain_rank
  • ord_in_thread
  • rating

&sort=relevancy

order

If you choose to order the posts by any of the above numeric sort values, you can choose in what order you want to get them:


  • desc (default)
  • asc

&sort=rating&order=asc

from

A paging parameter that works only when you don't sort the data by crawl date.

&from=100

ts

The "ts" (timestamp) parameter is telling the system to return results that were crawled after this timestamp (Unix Timestamp in milliseconds).

When not specified the default is the past 3 days.

&ts=1459835503426

format

The output format of the results set. It can be either:


  • json
  • xml
  • rss
  • excel

The default is json

&format=xml

size

The total number of posts returned per request, ranges between 1 to 100 (default is 100)

&size=2
Will return 2 posts

accuracy_confidence

Return only posts with high extraction accuracy, but removes about 30% of the total matching posts (with lower confidence).

&accuracy_confidence=high

highlight

Return the fragments in the post that matched the textual Boolean query. The matched keywords will be surrounded by <em/> tags.

&highlight=true

latest

This will return the latest 100 crawled posts matching your query.
It's NOT recommended to use this feature as it may result in you missing important posts.

&latest=true


What's Next

Learn how you can filter the data you consume

Filters Reference

GET Parameters