Retrieve documents from global index
Retrieve up to 500 sorted results for a given timeframe within the last 30 days.
Query Parameters
- q string required
The query to search for.
Example: cats AND dogs - offset integer
Number of results to skip (for paging). Vaule is between 0 and 500. Default value: 0.
Example: 0 - hpp integer
Number of hits per page (for paging). Allowed value is between 0 and 500. Default value: 10.
Example: 10 - sort_by string
Criteria for sorting the results. Allowed values: engagement, published, reach, facebook_shares, facebook_likes, twitter_shares, twitter_retweets, twitter_followers, youtube_likes, youtube_dislikes, youtube_views, cluster_size, comment_count, published, search_indexed, trending_score. Default value is engagement.
Example: engagement - sort_order string
Sorting order (ascending or descending). Allowed values: asc, desc Default value: desc.
Example: desc - hl boolean
Turns highlighting on or off. Allowed values: true or false. Default value: true.
Example: true - pretty boolean
Formatted json for testing. Allowed values: true or false. Default value: false.
Example: false
- 200
OK
- application/json
- Schema
- Example (from schema)
- Example
Schema
- object
{}
{
"pagination": {
"next": "GET /api/v1/search/results?q=cats%20AND%20dogs&offset=2&hpp=2&sort_by=engagement&sort_order=desc&hl=true&pretty=false&access_token=abcd_1234_abcd",
"total": 105362
},
"request": "GET /api/v1/search/results?q=cats%20AND%20dogs&offset=0&hpp=2&sort_by=engagement&sort_order=desc&hl=true&pretty=false&access_token=abcd_1234_abcd",
"request_id": "#r8vn08dfe6e9#",
"result_content": {
"data": [
{
"data": {
"DEPRECATED_spam_level": 0,
"article_extended_attributes": {
"facebook_likes": 241282,
"facebook_shares": 6537,
"num_comments": 10988,
"twitter_shares": 80
},
"cluster_id": "http://twitter.com/worldnewstweet_/status/1499876602544476162",
"content": "Tears of little girls who may never see their brave daddy again: Ukrainian man bids farewell to his children, aged six and tw...",
"content_snippet": "...worst-hit areas – along with 11,000 <b>cats</b> and <b>dogs</b> – to the west, either directly to borders or to cities nearby such as...",
"domain_url": "http://dailymail.co.uk/",
"engagement": 258887,
"entity_url": [
{
"url": "https://i.dailymail.co.uk/1s/2022/03/04/22/54967895-10579573-image-a-33_1646432778016.jpg"
},
{
"url": "https://i.dailymail.co.uk/1s/2022/03/04/22/54967905-10579573-image-a-32_1646432767939.jpg"
}
],
"extra_author_attributes": {
"gender": "MALE",
"id": "ex:www.dailymail.co.uk-1414438987",
"name": "Ian Gallagher"
},
"extra_source_attributes": {
"id": "ex:www.dailymail.co.uk",
"name": "www.dailymail.co.uk",
"world_data": {
"city": "London",
"continent": "Europe",
"country": "United Kingdom",
"country_code": "uk",
"latitude": 51.50115966796875,
"longitude": -0.1153564453125,
"region": "Greater London",
"resolution": "COUNTRY"
}
},
"fluency_level": 100,
"host_url": "http://www.dailymail.co.uk/",
"images": [
{
"url": "https://i.dailymail.co.uk/1s/2022/03/04/22/54967893-0-image-a-26_1646432743014.jpg"
}
],
"indexed": 1646433894625,
"lang": "en",
"parent_url": "https://www.dailymail.co.uk/news/article-10579573/Tears-little-girls-never-brave-daddy-again.html",
"porn_level": 0,
"post_type": [
"TEXT"
],
"published": 1646432900000,
"reach": 41651376,
"root_url": "https://www.dailymail.co.uk/",
"search_indexed": 1646433919683,
"sentiment": 0,
"source_extended_attributes": {
"alexa_pageviews": 90800000,
"alexa_unique_visitors": 41651376
},
"source_type": [
"ONLINENEWS",
"ONLINENEWS_NEWSPAPER"
],
"tags_internal": [
"containsImage",
"hasImage",
"isQuestion"
],
"title": "Tears of little girls who may never see their brave daddy again",
"title_snippet": "Tears of little girls who may never see their brave daddy again",
"tokens_content": [
"Vladimir Putin",
"Vladimir Putin",
"Svobody Avenue",
"Ukrainian Railways",
"Opera House",
"Dasha",
"Dasha",
"Dasha",
"Anna",
"Anna"
],
"tokens_title": [
"their brave daddy",
"brave daddy",
"their brave",
"little girls",
"Tears",
"Tears",
"daddy",
"brave",
"girls"
],
"trending_score": 0,
"url": "https://www.dailymail.co.uk/news/article-10579573/Tears-little-girls-never-brave-daddy-again.html",
"word_count": 854
}
},
{
"data": {
"DEPRECATED_spam_level": 0,
"article_extended_attributes": {
"facebook_likes": 189948,
"facebook_shares": 9750,
"num_comments": 7429,
"twitter_shares": 864
},
"cluster_id": "https://en.mogaznews.com/World-News/1918852/Polish-Pen-Farthing-risks-his-life-to-rescue-more-than-100-cats-and-dogs-.html",
"content": "NICK PISA in Przemysl: How 'Polish Pen Farthing' risks his life to rescue more than 100 cats and dogs stuck in war-torn Ukrai...",
"content_snippet": "...<b>cats</b> and <b>dogs</b> stuck in war-torn Ukraine while dodging Putin's army\n\nEXCLUSIVE: Polish charity worker is saving <b>cats</b> and <b>dogs</b> ... charity Dioz have rescued more than 100 <b>dogs</b>, <b>cats</b>, rabbits, hamsters and even a chameleon.\n\nKonrad said: 'There has been a...",
"domain_url": "http://dailymail.co.uk/",
"engagement": 207991,
"entity_url": [
{
"url": "https://i.dailymail.co.uk/1s/2022/03/04/12/54945165-10577489-image-m-31_1646395615796.jpg"
},
{
"url": "https://i.dailymail.co.uk/1s/2022/03/04/12/54945579-10577489-image-a-1_1646395407041.jpg"
},
{
"url": "https://i.dailymail.co.uk/1s/2022/03/04/12/54945135-10577489-image-m-32_1646395622395.jpg"
},
{
"url": "https://i.dailymail.co.uk/1s/2022/03/04/12/54945117-10577489-image-a-14_1646395470317.jpg"
},
{
"url": "https://i.dailymail.co.uk/1s/2022/03/04/12/54945577-10577489-image-a-3_1646395411003.jpg"
},
{
"url": "https://www.facebook.com/centrumadopcyjne"
},
{
"url": "https://i.dailymail.co.uk/1s/2022/03/04/12/54945167-10577489-image-a-2_1646395408936.jpg"
},
{
"url": "https://i.dailymail.co.uk/1s/2022/03/04/12/54945137-10577489-image-a-4_1646395420162.jpg"
},
{
"url": "https://i.dailymail.co.uk/1s/2022/03/04/12/54945149-10577489-image-m-29_1646395609026.jpg"
},
{
"url": "https://i.dailymail.co.uk/1s/2022/03/04/12/54945163-10577489-image-m-33_1646395629579.jpg"
},
{
"url": "https://i.dailymail.co.uk/1s/2022/03/04/12/54945155-10577489-image-a-30_1646395612133.jpg"
},
{
"url": "https://i.dailymail.co.uk/1s/2022/03/04/12/54945141-10577489-image-m-34_1646395637344.jpg"
},
{
"url": "https://i.dailymail.co.uk/1s/2022/03/04/12/54945129-10577489-image-m-28_1646395603364.jpg"
}
],
"extra_author_attributes": {
"gender": "MALE",
"id": "ex:www.dailymail.co.uk-2119827620",
"name": "Nick Pisa"
},
"extra_source_attributes": {
"id": "ex:www.dailymail.co.uk",
"name": "www.dailymail.co.uk",
"world_data": {
"city": "London",
"continent": "Europe",
"country": "United Kingdom",
"country_code": "uk",
"latitude": 51.50115966796875,
"longitude": -0.1153564453125,
"region": "Greater London",
"resolution": "COUNTRY"
}
},
"fluency_level": 100,
"host_url": "http://www.dailymail.co.uk/",
"images": [
{
"url": "https://i.dailymail.co.uk/1s/2022/03/04/12/54946159-0-image-a-16_1646395485118.jpg"
}
],
"indexed": 1646398250533,
"lang": "en",
"parent_url": "https://www.dailymail.co.uk/news/article-10577489/Polish-Pen-Farthing-risks-life-rescue-100-cats-dogs-stuck-Ukraine.html",
"porn_level": 0,
"post_type": [
"TEXT"
],
"published": 1646395963000,
"reach": 41651376,
"root_url": "https://www.dailymail.co.uk/",
"search_indexed": 1646398263762,
"sentiment": 0,
"source_extended_attributes": {
"alexa_pageviews": 90800000,
"alexa_unique_visitors": 41651376
},
"source_type": [
"ONLINENEWS",
"ONLINENEWS_NEWSPAPER"
],
"tags_internal": [
"containsImage",
"hasImage"
],
"title": "'Polish Pen Farthing' risks his life to rescue more than 100 cats and dogs stuck in Ukraine",
"title_snippet": "'Polish Pen Farthing' risks his life to rescue more than 100 <b>cats</b> and <b>dogs</b> stuck in Ukraine",
"tokens_content": [
"Polish Pen Farthing",
"How Polish Pen",
"Ukraine Konrad Kuzminski",
"German Shepherd",
"Instagram Konrad",
"NICK PISA",
"Konrad Kuzminski",
"How Polish",
"Radoslaw Fedaczynski",
"Polish Pen"
],
"tokens_title": [
"Polish Pen Farthing",
"Polish Pen Farthing",
"and dogs stuck",
"than 100 cats",
"Pen Farthing risks",
"Polish Pen",
"Polish Pen",
"Pen Farthing",
"Pen Farthing",
"his life"
],
"trending_score": 0,
"url": "https://www.dailymail.co.uk/news/article-10577489/Polish-Pen-Farthing-risks-life-rescue-100-cats-dogs-stuck-Ukraine.html",
"word_count": 858
}
}
]
},
"status_code": "0",
"status_message": "OK"
}