GET Parameters

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

HTTP GET Parameters



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


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


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



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:

  • asc (default)
  • desc



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



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.



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

  • json
  • xml
  • rss
  • excel

The default is json



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

Will return 2 posts


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



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



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



Return Errors & Warnings if wrong query terms passed.


Updated 5 months ago

What's Next

Learn how you can filter the data you consume

Filters Reference

GET Parameters

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.