Content Analysis – Search API
This endpoint will provide you with detailed citation data available for the target keyword.
This endpoint will provide you with detailed citation data available for the target keyword.
Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access
<?php // You can download this file from here https://cdn.dataforseo.com/v3/examples/php/php_RestClient.zip require('RestClient.php'); $api_url = 'https://api.dataforseo.com/'; // Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access $client = new RestClient($api_url, null, 'login', 'password'); $post_array = array(); // simple way to set a task $post_array[] = array( "keyword" => "logitech", "keyword_fields" => array( "snippet" => "logitech" ), "page_type" => array( "ecommerce", "news", "blogs", "message-boards", "organization" ), "search_mode" => "as_is", "filters" => array( "main_domain", "=", "reviewfinder.ca" ), "internal_list_limit" => 8, "order_by" => array( "content_info.sentiment_connotations.anger,desc" ), "limit" => 10 ); try { // POST /v3/content_analysis/search/live $result = $client->post('/v3/content_analysis/search/live', $post_array); print_r($result); // do something with post result } catch (RestClientException $e) { echo "n"; print "HTTP code: {$e->getHttpCode()}n"; print "Error code: {$e->getCode()}n"; print "Message: {$e->getMessage()}n"; print $e->getTraceAsString(); echo "n"; } $client = null; ?>
The above command returns JSON structured like this:
{ "version": "0.1.20220913", "status_code": 20000, "status_message": "Ok.", "time": "0.5305 sec.", "cost": 0.0203, "tasks_count": 1, "tasks_error": 0, "tasks": [ { "id": "09131957-0696-0463-0000-7db1bf7abc2b", "status_code": 20000, "status_message": "Ok.", "time": "0.4865 sec.", "cost": 0.0203, "result_count": 1, "path": [ "v3", "content_analysis", "search", "live" ], "data": { "api": "content_analysis", "function": "search", "keyword_fields": { "snippet": "logitech" }, "page_type": [ "ecommerce", "news", "blogs", "message-boards", "organization" ], "search_mode": "as_is", "filters": [ "main_domain", "=", "reviewfinder.ca" ], "internal_list_limit": 8, "limit": 10 }, "result": [ { "offset_token": "eyJWZXJzaW9uIjoxLCJTZWFyY2hBZnRlclZhbHVlcyI6eyJjb250ZW50cy5zZW50aW1lbnRfY29ubm90YXRpb25zLmFuZ3J5IjowLjA5NzU2Nzc1LCJfc2NvcmUiOjIxNTUuNDk0MSwidXJsX2hhc2giOiIzNDM1OTM5MjM3NTMzMTExNDQ1In0sIlRva2VuUmVhbE9mZnNldCI6MH0=", "total_count": 296, "items_count": 10, "items": [ { "type": "content_analysis_search", "url": "https://reviewfinder.ca/top-computer-speakers/edifier-r1280db-vs-logitech-g560/", "domain": "reviewfinder.ca", "main_domain": "reviewfinder.ca", "url_rank": 126, "spam_score": 0, "domain_rank": 493, "fetch_time": "2022-08-12 18:40:33 +00:00", "country": "CA", "language": "en", "score": 5900.941, "page_category": [ 10019, 10167, 10873, 12138, 10002, 10028, 10222, 13813 ], "page_types": [ "ecommerce" ], "ratings": null, "social_metrics": [ { "type": "facebook", "like_count": 13 } ], "content_info": { "content_type": "page_content", "title": "Verdict", "main_title": "Comparing Edifier R1280DB and Logitech G560", "previous_title": "Endorsement summary:", "level": 2, "author": null, "snippet": "After counting and adding up the 77 expert endorsements of the May rankings, Logitech G560 outranks Edifier R1280DB. This is not to say that Edifier R1280DB is a bad option. Like Logitech G560, it is recommended by experts, but less.\nAs can be seen below, Logitech G560 outranks Edifier R1280DB by 13 positions. This indicates that, as of 4 Aug 2022, Logitech G560 is more critically acclaimed than Edifier R1280DB.", "snippet_length": 415, "social_metrics": [ { "type": "facebook", "like_count": 13 } ], "highlighted_text": null, "language": "en", "sentiment_connotations": { "anger": null, "happiness": 0.07077454775571823, "love": 0.0959794893860817, "sadness": 0.030060304328799248, "share": null, "fun": 0.15295149385929108 }, "connotation_types": { "positive": 0.12338598817586899, "negative": 0.41213861107826233, "neutral": 0.4645053744316101 }, "text_category": [ 10019, 10167, 10873, 12138, 10013 ], "date_published": null, "content_quality_score": 90, "semantic_location": 90, "rating": null, "group_date": "2021-09-08 20:23:59 +00:00" } }, { "type": "content_analysis_search", "url": "https://reviewfinder.ca/info/top-gaming-racing-wheels/logitech-g920/", "domain": "reviewfinder.ca", "main_domain": "reviewfinder.ca", "url_rank": 64, "spam_score": 0, "domain_rank": 493, "fetch_time": "2022-07-31 20:16:34 +00:00", "country": "CA", "language": "en", "score": 5751.833, "page_category": [ 10108, 10019, 10167 ], "page_types": [ "ecommerce" ], "ratings": null, "social_metrics": null, "content_info": { "content_type": "page_content", "title": "Logitech G920 - Recommended and relevant!", "main_title": "Logitech G920 - Reviews, Prices, Specs and Alternatives", "previous_title": "ReviewFinder Gaming Racing Wheels Logitech G920", "level": 2, "author": null, "snippet": "According to the meta ranking published on 3 July 2022, Logitech G920 is currently recommended as a high-quality Racing Wheel. Out of 10 expert opinions queried, Logitech G920 received 4 endorsements, from TechRadar (8 Jun 2022), Android Authority (12 Sep 2021) BestCovery (7 Apr 2022) and 1 other..\n1 out of 4 experts ranked Logitech G920 as 'the best Racing Wheel of the month'.\nCompared to other most critically acclaimed Gaming Racing Wheels, Logitech G920 ranks #5 out of 15 in July 2022, - as can be seen from the table below.\nThe definitive sim racing wheel for Xbox One: Realistic steering and pedal action for the latest racing titles. Wheel spokes: Anodized aluminum\nBuilt to last: Durable solid steel ball bearings, stainless steel pedals and hand-stitched leather wheel grip. Glass-filled nylon mounting clamps\nDual-motor force feedback: Realistically simulates the racing experience with smooth, quiet helical gearing\nEasy-access game controls: On-wheel D-pad, console buttons and paddle shifters\nResponsive floor pedal unit: Accelerate, brake and change gears with the feel of an actual car.System requirement:Windows 10, 8.1, Windows 8 or Windows 7 and macOS 10.10+\nLogitech has different serial numbers for packaging vs. product, please keep your receipt for warranty purposes.\nAs can be seen from the ranking below, Logitech G920 is endorsed by the critics this months, and ranks #5.", "snippet_length": 1400, "social_metrics": null, "highlighted_text": null, "language": "en", "sentiment_connotations": { "anger": null, "happiness": 0.15027441084384918, "love": 0.1787649393081665, "sadness": 0.09101732820272446, "share": null, "fun": 0.0640750378370285 }, "connotation_types": { "positive": 0.34157365560531616, "negative": 0.3285507559776306, "neutral": 0.32990556955337524 }, "text_category": [ 10013, 10019, 10167 ], "date_published": null, "content_quality_score": 94, "semantic_location": 94, "rating": null, "group_date": "2021-09-13 05:05:18 +00:00" } }, { "type": "content_analysis_search", "url": "https://reviewfinder.ca/info/top-gaming-racing-wheels/logitech-g27/", "domain": "reviewfinder.ca", "main_domain": "reviewfinder.ca", "url_rank": 104, "spam_score": 0, "domain_rank": 493, "fetch_time": "2022-07-31 21:22:19 +00:00", "country": "CA", "language": "en", "score": 2685.8352, "page_category": [ 10108, 10002, 10028, 10222, 13813 ], "page_types": [ "ecommerce" ], "ratings": null, "social_metrics": null, "content_info": { "content_type": "page_content", "title": "ReviewFinder Gaming Racing Wheels Logitech G27", "main_title": "Logitech G27 - Reviews, Prices, Specs and Alternatives", "previous_title": "Logitech G27 - Reviews, Prices, Specs and Alternatives", "level": 3, "author": null, "snippet": "The powerful, dual-motor force feedback mechanism with helical gearing smoothly and accurately simulates traction loss\nSix-speed shifter with push-down reverse gear allows you to quickly choose exactly the right gear.\nRPM/shift indicator LEDs integrate with racing game software to indicate when the user should shift gears.\nRealistic 11-Inch wheel with leather-wrapped rim provides a more comfortable, true-to-life racing experience for hours on end.\nSteel gas, brake, and clutch pedals deliver precise throttle, braking, and shifting control for heightened realism.\nThe powerful dual-motor force feedback mechanism with helical gearing smoothly and accurately simulates traction loss\nSix-speed shifter with push-down reverse gear allows you to quickly choose exactly the right gear\nRPM/shift indicator LEDs integrate with racing game software to indicate when the user should shift gears\nRealistic 11-Inch wheel with leather-wrapped rim provides a more comfortable and true-to-life racing experience for hours on end\nSteel gas, brake and clutch pedals deliver precise throttle with braking and shifting control for heightened realism\nLogitech G27 is a popular option at the top of the price range. It's in the top 3 bestselling racing wheels and has doesn't have many popular alternatives in the same price range.\nLogitech G27 is C$2814.58 more expensive than the average racing wheel (C$337.16).", "snippet_length": 1398, "social_metrics": null, "highlighted_text": null, "language": "en", "sentiment_connotations": { "anger": null, "happiness": 0.05615948140621185, "love": 0.09969528764486313, "sadness": 0.15229091048240662, "share": null, "fun": 0.0502193346619606 }, "connotation_types": { "positive": 0.5877373814582825, "negative": 0.0651920959353447, "neutral": 0.34710052609443665 }, "text_category": [ 10019, 10167, 10013 ], "date_published": null, "content_quality_score": 90, "semantic_location": 90, "rating": null, "group_date": "2019-08-19 03:00:33 +00:00" } }, { "type": "content_analysis_search", "url": "https://reviewfinder.ca/info/top-computer-speakers/logitech-z213/", "domain": "reviewfinder.ca", "main_domain": "reviewfinder.ca", "url_rank": 137, "spam_score": 0, "domain_rank": 493, "fetch_time": "2022-08-13 11:12:47 +00:00", "country": "CA", "language": "en", "score": 4299.2095, "page_category": [ 10013, 10108 ], "page_types": [ "ecommerce" ], "ratings": null, "social_metrics": null, "content_info": { "content_type": "page_content", "title": "ReviewFinder Computer Speakers Logitech Z213", "main_title": "Logitech Z213 - Reviews, Prices, Specs and Alternatives", "previous_title": "Logitech Z213 - Reviews, Prices, Specs and Alternatives", "level": 3, "author": null, "snippet": "Down-firing subwoofer with adjustable bass control knob: Turn up the bass to add a deeper, richer low end to your music, movies and games\n14W peak power (7W RMS): Enjoy all your audio entertainment in loud, clear stereo sound\nConvenient handheld control pod: Easily power on the speakers, adjust volume and plug in your headset for private listening\nCompact satellite speakers: Inclined design directs great sound to your ears without sacrificing valuable desk space\nPlug-and-play setup: Simple wired connection to audio devices with 3.5mm output (Windows and Mac computers, smartphones, tablets, MP3 players)\nLogitech has different serial numbers for packaging vs. product, please keep your receipt for warranty purposes.\nSpeaker System Type:Multimedia Speakers\nConnections:Inputs: 3.5mm auxiliary input ;Outputs: 3.5mm headphone jack;\nNominal Output Power (Total):14 Watt\nMax (RMS) Output Power (Total):7 Watt\nService & Support Type:1-Year Limited Hardware Warranty\nLogitech Z213 is a very popular option in the middle of the computer speakers price range. It has dozens of popular alternatives in the same price range, such as Edifier R19U or Sanyun SW102.\nLogitech Z213 is C$25.56 cheaper than the average computer speaker (C$71.55).", "snippet_length": 1237, "social_metrics": null, "highlighted_text": null, "language": "en", "sentiment_connotations": { "anger": null, "happiness": 0.15706565976142883, "love": 0.19101671874523163, "sadness": 0.027795027941465378, "share": null, "fun": 0.06868279725313187 }, "connotation_types": { "positive": 0.36061927676200867, "negative": 0.1687621772289276, "neutral": 0.47064855694770813 }, "text_category": [ 10019, 10167, 10873, 12138, 10872 ], "date_published": null, "content_quality_score": 95, "semantic_location": 95, "rating": null, "group_date": "2021-08-07 07:56:41 +00:00" } }, { "type": "content_analysis_search", "url": "https://reviewfinder.ca/info/top-gaming-racing-wheels/logitech-g29/", "domain": "reviewfinder.ca", "main_domain": "reviewfinder.ca", "url_rank": 79, "spam_score": 0, "domain_rank": 493, "fetch_time": "2022-07-31 20:08:57 +00:00", "country": "CA", "language": "en", "score": 5864.53, "page_category": [ 10108, 10013 ], "page_types": [ "ecommerce" ], "ratings": null, "social_metrics": null, "content_info": { "content_type": "page_content", "title": "Logitech G29 - Recommended and relevant!", "main_title": "Logitech G29 - Reviews, Prices, Specs and Alternatives", "previous_title": "ReviewFinder Gaming Racing Wheels Logitech G29", "level": 2, "author": null, "snippet": "According to the meta ranking published on 3 July 2022, Logitech G29 is currently recommended as a high-quality Racing Wheel. Out of 10 expert opinions queried, Logitech G29 received 4 endorsements, from TechRadar (8 Jun 2022), Android Authority (12 Sep 2021) PCreview (9 Jan 2022) and 1 other..\nNo experts ranked Logitech G29 as 'the best Racing Wheel of July'.\nCompared to other most critically acclaimed Gaming Racing Wheels, Logitech G29 ranks #8 out of 15 in July 2022, - as can be seen from the table below.\nThe definitive SIM racing wheel for PlayStation 4 and PlayStation 3: realistic steering and pedal action for the latest racing titles. Note: Kindly refer the User manual before usage of the product\nBuilt to last: durable solid steel ball bearings, stainless steel shifter and PEDALS and hand-stitched leather wheel grip. Hall-effect steering sensor. Wheel spokes material: Anodized aluminum\nDual-motor force feedback: realistically simulates the racing experience with smooth, quiet Helical gearing. 900° wheel rotation\nSytem requirement:Windows 10, 8.1, Windows 8 or Windows 7 and macOS 10.10+\nWheel Unit Depth is 278 mm; Pedal piston sleeves: Polyoxymethylene thermoplastic (POM)\nAs can be seen from the ranking below, Logitech G29 is endorsed by the critics this months, and ranks #8.", "snippet_length": 1301, "social_metrics": null, "highlighted_text": null, "language": "en", "sentiment_connotations": { "anger": null, "happiness": 0.13903042674064636, "love": 0.14059056341648102, "sadness": 0.09468089044094086, "share": null, "fun": 0.061122357845306396 }, "connotation_types": { "positive": 0.39891257882118225, "negative": 0.30477818846702576, "neutral": 0.2963393032550812 }, "text_category": [ 10013, 10019, 10167 ], "date_published": null, "content_quality_score": 94, "semantic_location": 94, "rating": null, "group_date": "2021-09-13 05:08:30 +00:00" } }, { "type": "content_analysis_search", "url": "https://reviewfinder.ca/top-gaming-keyboards/logitech-g213-vs-razer-cynosa-chroma/", "domain": "reviewfinder.ca", "main_domain": "reviewfinder.ca", "url_rank": 146, "spam_score": 0, "domain_rank": 493, "fetch_time": "2022-08-11 23:21:00 +00:00", "country": "CA", "language": "en", "score": 4562.6978, "page_category": [ 10108, 13691, 10011 ], "page_types": [ "ecommerce" ], "ratings": null, "social_metrics": null, "content_info": { "content_type": "page_content", "title": "Experts prefer Razer Cynosa Chroma over Logitech G213 Prodigy", "main_title": "Comparing Logitech G213 Prodigy and Razer Cynosa Chroma", "previous_title": "Razer Cynosa Chroma", "level": 2, "author": null, "snippet": "Currently, Razer Cynosa Chroma received 1 endorsement from PC Gamer (27 Jul 2022). Meanwhile, Logitech G213 Prodigy did not receive any endorsements this month.\nCurious to see this month's entire Gaming Keyboards ranking? It's here", "snippet_length": 231, "social_metrics": null, "highlighted_text": null, "language": "en", "sentiment_connotations": { "anger": null, "happiness": 0.07467446476221085, "love": 0.18654434382915497, "sadness": 0.14675261080265045, "share": null, "fun": 0.08801265060901642 }, "connotation_types": { "positive": 0.22597165405750275, "negative": 0.5552403926849365, "neutral": 0.21881794929504395 }, "text_category": [ 10108, 13691, 10013 ], "date_published": null, "content_quality_score": 96, "semantic_location": 96, "rating": null, "group_date": "2021-09-08 12:27:37 +00:00" } }, { "type": "content_analysis_search", "url": "https://reviewfinder.ca/info/top-surround-speaker-systems/acoustic-audio-aa5210/", "domain": "reviewfinder.ca", "main_domain": "reviewfinder.ca", "url_rank": 120, "spam_score": 0, "domain_rank": 493, "fetch_time": "2022-08-13 21:56:48 +00:00", "country": "CA", "language": "en", "score": 1411.0455, "page_category": [ 10019, 10167, 10873, 12138, 10872 ], "page_types": [ "ecommerce" ], "ratings": null, "social_metrics": null, "content_info": { "content_type": "page_content", "title": "ReviewFinder Surround Speaker Systems Acoustic Audio AA5210", "main_title": "Acoustic Audio AA5210 - Reviews, Prices, Specs and Alternatives", "previous_title": "Acoustic Audio AA5210 - Reviews, Prices, Specs and Alternatives", "level": 3, "author": null, "snippet": "Acoustic Audio AA5210 powered 5.1 Bluetooth home theater speaker system with USB / SD, 600 watts system power, frequency response is 20hz-20 kHz, magnetically shielded satellite speakers\nIntegrated Bluetooth receiver and amplifier, 5 independent channel inputs and outputs, enhanced bass boost design, bass, treble and main controls, stereo AUX input, pro surround function, USB/SD card reader\nPlug and play connections, LED illuminated sub with multiple pattern flashing light display, 1 subwoofer speaker is (H x W x D) 11\" x 6.25\" x 12.5\", 5 full range satellite speakers are (H x W x D) 6.875\" x 4.125\" x 4\" each\n2 Fronts and 1 center satellite speakers have a 6' single RCA cable, 2 rear speakers have 12' single RCA cables, 3.5mm AUX to RCA cable included, 2 RCA to RCA cables included, remote control and full instructions included\nUse for home entertainment system, laptop or PC, DVD player, gaming, MP3 player, cell phone, tablet or any other device with a 3.5mm headphone output or RCA audio output\nAcoustic Audio AA5210 is a very popular and one of the less expensive options. It's in the top 3 bestselling speaker systems and has a couple of popular alternatives in the same price range, such as Monoprice 5.1 Home Theater or Logitech Z606.\nAcoustic Audio AA5210 is C$383 less expensive than an average speaker system (C$583.42).", "snippet_length": 1341, "social_metrics": null, "highlighted_text": null, "language": "en", "sentiment_connotations": { "anger": null, "happiness": 0.0951547920703888, "love": 0.326175719499588, "sadness": 0.021449072286486626, "share": null, "fun": 0.020081015303730965 }, "connotation_types": { "positive": 0.2667571008205414, "negative": 0.198574036359787, "neutral": 0.5346988439559937 }, "text_category": [ 10019, 10167, 10873, 12138, 12137 ], "date_published": null, "content_quality_score": 93, "semantic_location": 93, "rating": null, "group_date": "2021-08-30 15:38:32 +00:00" } }, { "type": "content_analysis_search", "url": "https://reviewfinder.ca/info/top-gaming-keyboards/logitech-g910/", "domain": "reviewfinder.ca", "main_domain": "reviewfinder.ca", "url_rank": 121, "spam_score": 0, "domain_rank": 493, "fetch_time": "2022-07-21 17:59:12 +00:00", "country": "CA", "language": "en", "score": 5116.254, "page_category": [ 10108, 10013 ], "page_types": [ "ecommerce" ], "ratings": null, "social_metrics": null, "content_info": { "content_type": "page_content", "title": "ReviewFinder Gaming Keyboards Logitech G910", "main_title": "Logitech G910 - Reviews, Prices, Specs and Alternatives", "previous_title": "Logitech G910 - Reviews, Prices, Specs and Alternatives", "level": 3, "author": null, "snippet": "Connectivity Type Wired. Connectivity USB. Bluetooth No. Cord Length or Cordless Range 1.8 m. Ergonomic Design No. Keyboard Language English. Built-in TrackpadTouchpad No. Backlit Keys Yes. Internet Keys 0. Multimedia Keys 5. Mechanical Keys Yes. Custom Programmable Buttons 9 Fully Programmable G Keys. LCD Display No. Number of Memory Profile(s) 3. Colour Black. Wrist Rest Included Yes. Integrated USB Ports 0.\nDesigned For Gaming Yes. Solar Powered No. Battery Life Indicator No. Rechargeable No. System Requirements Windows 788.1 Powered USB Port Internet Connection 100MB Hard Drive Space (for Optional Software Download). Width 50.5 cm. Height 3.5 cm. Depth 24.4 cm. Weight 1.5 kg. Width (Inches) 19.7 in. Height (Inches) 1.37 in. Depth (Inches) 9.52 in. Warranty Parts 2 Year(s).\nLogitech Mechanical Gaming Keyboard.\nLogitech G910 is a very popular and one of the most expensive options. It's in the top 3 bestselling gaming keyboards and has many popular alternatives in the same price range, such as Logitech G810 Orion or Corsair K70 RGB MK.2.\nLogitech G910 is C$86.75 more expensive than an average gaming keyboard (C$104.95).", "snippet_length": 1138, "social_metrics": null, "highlighted_text": null, "language": "en", "sentiment_connotations": { "anger": null, "happiness": 0.09535221010446548, "love": 0.2098393738269806, "sadness": 0.13099771738052368, "share": null, "fun": 0.035219766199588776 }, "connotation_types": { "positive": 0.18018507957458496, "negative": 0.16152001917362213, "neutral": 0.6583248972892761 }, "text_category": [ 10019, 10167, 10013 ], "date_published": null, "content_quality_score": 94, "semantic_location": 94, "rating": null, "group_date": "2021-08-28 00:43:56 +00:00" } }, { "type": "content_analysis_search", "url": "https://reviewfinder.ca/info/top-gaming-keyboards/logitech-g213/", "domain": "reviewfinder.ca", "main_domain": "reviewfinder.ca", "url_rank": 121, "spam_score": 0, "domain_rank": 493, "fetch_time": "2022-07-21 16:59:42 +00:00", "country": "CA", "language": "en", "score": 4598.567, "page_category": [ 10108, 10013 ], "page_types": [ "ecommerce" ], "ratings": null, "social_metrics": null, "content_info": { "content_type": "page_content", "title": "ReviewFinder Gaming Keyboards Logitech G213 Prodigy", "main_title": "Logitech G213 Prodigy - Reviews, Prices, Specs and Alternatives", "previous_title": "Logitech G213 Prodigy - Reviews, Prices, Specs and Alternatives", "level": 3, "author": null, "snippet": "Brilliant color spectrum illumination - personalize five individual lighting zones from a spectrum of over 16.8 million colors. Change colors to match your setup, specific games, or to showcase your favorite colors. Synchronize lighting effects with other Logitech G devices using Logitech gaming software. Low light leak around each keycap means less more light comes through the lettering – and less leaks around the keycaps. This helps make the illumination of each key more brilliant, making it easier to find your keys in the dark\nComfortable and durable - G213 prodigy is a full-sized keyboard designed for gaming and productivity. The slim body is built for gamers of all levels, with a durable construction that repels liquids, crumbs and dirt for easy cleanup. An integrated palm rest and adjustable feet let you set your keyboard to the ideal position, so it’s comfortable to use even during the longest gaming sessions\nPerformance tuned with multi-key input - G213 brings together the best in tactile feel and performance with keys built specifically for the way gamers play. Each key on the G213 is tuned to enhance the tactile experience, delivering ultra-quick, responsive feedback that is up to 4 times faster than standard keyboards. The anti-ghosting gaming Matrix is tuned for optimal gaming performance, keeping you in control when you press multiple gaming keys simultaneously\nDedicated media controls - control your background track without switching out of your game. G213 features dedicated media controls that can be used to play, pause and mute music and videos instantly. Adjust the volume, or skip to the next song with the touch of a button\nCustomize with Logitech gaming software - Logitech gaming software lets you fully customize your G213 for added convenience and personalization. Set the RGB lighting, save time by assigning multiple functions to function (F1-F12) keys, and much more\nLogitech G213 Prodigy is a popular and one of the less expensive options. It's in the top 3 bestselling gaming keyboards and has dozens of popular alternatives in the same price range, such as Corsair K55 RGB or Razer Cynosa V2.\nLogitech G213 Prodigy is C$34.19 less expensive than an average gaming keyboard (C$104.95).", "snippet_length": 2239, "social_metrics": null, "highlighted_text": null, "language": "en", "sentiment_connotations": { "anger": null, "happiness": 0.05594038963317871, "love": 0.4099886119365692, "sadness": 0.037346553057432175, "share": null, "fun": 0.029315805062651634 }, "connotation_types": { "positive": 0.45417067408561707, "negative": 0.13158488273620605, "neutral": 0.4142744541168213 }, "text_category": [ 10019, 10168, 10886, 12222, 10167 ], "date_published": null, "content_quality_score": 94, "semantic_location": 94, "rating": null, "group_date": "2021-08-28 00:43:49 +00:00" } }, { "type": "content_analysis_search", "url": "https://reviewfinder.ca/top-xbox-one-headsets/astro-a10-gaming-headset-vs-lucidsound-ls35x/", "domain": "reviewfinder.ca", "main_domain": "reviewfinder.ca", "url_rank": 165, "spam_score": 0, "domain_rank": 493, "fetch_time": "2022-08-11 00:13:11 +00:00", "country": "CA", "language": "en", "score": 2155.4941, "page_category": [ 10002, 10231, 13469, 10011 ], "page_types": [ "ecommerce" ], "ratings": null, "social_metrics": null, "content_info": { "content_type": "page_content", "title": "Score distribution:", "main_title": "Comparing Astro A10 and LucidSound LS35X", "previous_title": "Expert reviews [1]", "level": 4, "author": null, "snippet": "Durable construction – The A10 was designed to withstand serious abuse, featuring a lightweight yet rugged construction with premium materials for a pressure-free fit that won’t overheat your head. The ear cushions contain cloth for maximum comfort, backed with synthetic leather for the best acoustic performance.\nCombat Ready Precision Audio: Our focus is delivering flawless high quality PC and console audio that delivers total immersion into your game and precision audio to provide a competitive advantage. No one will be able to sneak up behind you with LucidSound on your team.\nNo manufacturer information linked for LucidSound LS35X.\nAstro A10 is a very popular option in the middle of the headsets price range. It's in the top 3 bestselling headsets and has dozens of popular alternatives in the same price range, such as Somic G951S or Logitech G332.\nAstro A10 is C$0.02 more expensive than an average headset (C$59.97).", "snippet_length": 931, "social_metrics": null, "highlighted_text": null, "language": "en", "sentiment_connotations": { "anger": null, "happiness": 0.10993830859661102, "love": 0.1934281885623932, "sadness": 0.039923928678035736, "share": null, "fun": 0.04024559631943703 }, "connotation_types": { "positive": 0.34128379821777344, "negative": 0.259573370218277, "neutral": 0.39917290210723877 }, "text_category": [ 10013, 10019, 10167 ], "date_published": null, "content_quality_score": 94, "semantic_location": 94, "rating": null, "group_date": "2021-09-08 22:26:11 +00:00" } } ] } ] } ] }
All POST data should be sent in the JSON format (UTF-8 encoding). The task setting is done using the POST method. When setting a task, you should send all task parameters in the task array of the generic POST array. You can send up to 2000 API calls per minute.
You can specify the number of results you want to retrieve, filter and sort them.
Below you will find a detailed description of the fields you can use for setting a task.
Description of the fields for setting a task:
Field name | Type | Description |
---|---|---|
keyword |
string | target keyword required field UTF-8 encoding a keyword should be at least 3 characters long; the keywords will be converted to a lowercase format; Note: to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes; example: "keyword": "\"tesla palo alto\""
learn more about rules and limitations of |
keyword_fields |
object | target keyword fields and target keywords optional field use this parameter to filter the dataset by keywords that certain fields should contain; fields you can specify: title , main_title , previous_title , snippet you can indicate several fields; Note: to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes; example: "keyword_fields": { |
page_type |
array | target page types optional field use this parameter to filter the dataset by page types possible values: "ecommerce" , "news" , "blogs" , "message-boards" , "organization"
|
search_mode |
string | results grouping type optional field possible grouping types: as_is – returns all citations for the target keyword one_per_domain – returns one citation of the keyword per domaindefault value: as_is |
limit |
integer | the maximum number of returned citations optional field default value: 100 maximum value: 1000 |
filters |
array | array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and , or between the conditionsthe following operators are supported: regex , not_regex , < , <= , > , >= , = , <> , in , not_in , like ,not_like you can use the % operator with like and not_like to match any string of zero or more charactersexample: ["country","=", "US"]
|
order_by |
array | results sorting rules optional field you can use the same values as in the filters array to sort the resultspossible sorting types: asc – results will be sorted in the ascending orderdesc – results will be sorted in the descending orderyou should use a comma to set up a sorting type example: ["content_info.sentiment_connotations.anger,desc"] default rule: ["content_info.sentiment_connotations.anger,desc"] note that you can set no more than three sorting rules in a single request you should use a comma to separate several sorting rules example: ["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"] |
offset |
integer | offset in the results array of returned citations optional field default value: 0 if you specify the 10 value, the first ten citations in the results array will be omitted and the data will be provided for the successive citations |
offset_token |
string | offset token for subsequent requests optional field provided in the identical field of the response to each request; use this parameter to avoid timeouts while trying to obtain over 10,000 results in a single request; by specifying the unique offset_token value from the response array, you will get the subsequent results of the initial task;offset_token values are unique for each subsequent taskNote: if the offset_token is specified in the request, all other parameters except limit will not be taken into account when processing a task |
tag |
string | user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response |
As a response of the API server, you will receive JSON-encoded data containing a tasks
array with the information specific to the set tasks.
Description of the fields in the results array:
Field name | Type | Description |
---|---|---|
version |
string | the current version of the API |
status_code |
integer | general status code you can find the full list of the response codes here Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions |
status_message |
string | general informational message you can find the full list of general informational messages here |
time |
string | execution time, seconds |
cost |
float | total tasks cost, USD |
tasks_count |
integer | the number of tasks in the tasks array |
tasks_error |
integer | the number of tasks in the tasks array returned with an error |
tasks |
array | array of tasks |
id |
string | task identifier unique task identifier in our system in the UUID format |
status_code |
integer | status code of the task generated by DataForSEO; can be within the following range: 10000-60000 you can find the full list of the response codes here |
status_message |
string | informational message of the task you can find the full list of general informational messages here |
time |
string | execution time, seconds |
cost |
float | cost of the task, USD |
result_count |
integer | number of elements in the result array |
path |
array | URL path |
data |
object | contains the same parameters that you specified in the POST request |
result |
array | array of results |
offset_token |
string | offset token for subsequent requests you can use the string provided in this field to get the subsequent results of the initial task; note: offset_token values are unique for each subsequent task |
total_count |
integer | total amount of results in our database relevant to your request |
items_count |
integer | the number of results returned in the items array |
items |
array | contains citations and related data |
type |
string | type of element = ‘content_analysis_search’ |
url |
string | URL where the citation was found |
domain |
string | domain name |
main_domain |
string | main domain |
url_rank |
integer | rank of the url this value is based on backlink data for the given URL from DataForSEO Backlink Index; url_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithmlearn more about the metric and how it is calculated in this help center article |
spam_score |
string | backlink spam score of the url this value is based on backlink data for the given URL from DataForSEO Backlink Index; learn more about how the metric is calculated on this help center page |
domain_rank |
string | rank of the domain this value is based on backlink data for the given domain from DataForSEO Backlink Index; domain_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithmlearn more about the metric and how it is calculated in this help center article |
fetch_time |
string | date and time when our crawler visited the page in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2017-01-24 13:20:59 +00:00 |
country |
string | country code of the domain registration to obtain a full list of available countries, refer to the Locations endpoint |
language |
string | main language of the domain to obtain a full list of available languages, refer to the Languages endpoint |
score |
string | citation prominence score this value is based on url_rank , domain_rank , keyword presence in title , main_title , url , snippet the higher the score , the more value the related citation has |
page_category |
array | contains all relevant page categories product and service categories relevant for the page to obtain a full list of available categories, refer to the Categories endpoint |
page_types |
array | page types |
ratings |
array | ratings found on the page all ratings found on the page based on microdata |
social_metrics |
array | social media engagement metrics data on social media interactions associated with the content based on website embeds developed and supported by social media platforms |
content_info |
object | contains data on citations from the given url |
content_type |
string | type of content example: page_content , comment |
title |
string | title of the result |
main_title |
string | page title |
previous_title |
string | title of the previous content block |
level |
integer | title heading levelindicates h-tag level from 1 (top) to 6 (bottom) |
author |
string | author of the content |
snippet |
string | content snippet |
snippet_length |
integer | character length of the snippet |
social_metrics |
array | social media engagement metrics data on social media interactions associated with the content based on website embeds developed and supported by social media platforms |
highlighted_text |
string | highlighted text from the snippet |
language |
string | content language to obtain a full list of available languages, refer to the Languages endpoint |
sentiment_connotations |
object | sentiment connotations contains sentiments (emotional reactions) related to the given citation and probability index per each sentiment possible sentiment connotations: anger , happiness , love , sadness , share , fun |
connotation_types |
object | connotation types contains types of sentiments (sentiment polarity) related to the given citation and probability index per each sentiment type possible sentiment connotation types: positive , negative , neutral |
text_category |
array | text category to obtain a full list of available categories, refer to the Categories endpoint |
date_published |
string | date and time when the content was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2017-01-24 13:20:59 +00:00 |
content_quality_score |
integer | content quality score this value is calculated based on the number of words, sentences and characters the content contains |
semantic_location |
string | semantic location indicates semantic element in HTML where the target keyword citation is located example: article , header |
rating |
object | content rating rating related to content_info |
name |
string | rating name here you can find the following elements: Max5 , Percents , CustomMax |
rating_value |
integer | the value of the rating |
max_rating_value |
integer | maximum value for the rating name |
rating_count |
integer | number of votes |
relative_rating |
float | relative rating |
group_date |
string | citation group date and time indicates content publication date or date and time when our crawler visited the page for the first time; this field can be used to group citations by date and display citation trends; date and time are provided in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2017-01-24 13:20:59 +00:00 |