fbpx

Related Data API Documentation

/Related Get related data

Available Parameters

  • q – The topic you are looking for data on
  • apikey – Your API key

Example

				
					api.grepwords.com/related/?q=baseball&apikey=APIKEY
				
			

Response

				
					[
    {
        "gms":201000,
        "ams":201000,
        "lms":201000,
        "cpc":0.94525,
        "keyword":"baseball scores",
        "competition":0.0029952706253284,
        "cmp":0.0029952706253284,
        "m1":74000,
        "m1_month":"2021-03",
        "m2":9900,
        "m2_month":"2021-02",
        "m3":8100,
        "m3_month":"2021-01",
        "m4":8100,
        "m4_month":"2020-12",
        "m5":12100,
        "m5_month":"2020-11",
        "m6":823000,
        "m6_month":"2020-10",
        "m7":673000,
        "m7_month":"2020-09",
        "m8":550000,
        "m8_month":"2020-08",
        "m9":201000,
        "m9_month":"2020-07",
        "m10":4400,
        "m10_month":"2020-06",
        "m11":4400,
        "m11_month":"2020-05",
        "m12":4400,
        "m12_month":"2020-04",
        "updated_history":"2021-05-04",
        "updated_lms":"2021-05-04",
        "updated_cmp":"2021-05-04",
        "updated_cpc":"2021-05-04",
        "category_ids":[
            10114,
            13605,
            10597,
            13610,
            10108,
            10013,
            10014,
            10110
        ],
        "category_strings":[
            "\/Arts & Entertainment",
            "\/Arts & Entertainment\/Sports Entertainment",
            "\/Arts & Entertainment\/Sports Entertainment\/Sport Scores & Statistics",
            "\/News, Media & Publications",
            "\/Sports & Fitness",
            "\/Sports & Fitness\/Sports",
            "\/Sports & Fitness\/Sports\/Baseball",
            "\/Sports & Fitness\/Sports News & Media"
        ],
        "search_volume":201000
    },
    "... // More results"{
        "gms":4400,
        "ams":4400,
        "lms":4400,
        "cpc":1.628019,
        "keyword":"baseball scoreboard",
        "competition":0.99938578082612,
        "cmp":0.99938578082612,
        "m1":5400,
        "m1_month":"2021-03",
        "m2":3600,
        "m2_month":"2021-02",
        "m3":2400,
        "m3_month":"2021-01",
        "m4":1900,
        "m4_month":"2020-12",
        "m5":2400,
        "m5_month":"2020-11",
        "m6":6600,
        "m6_month":"2020-10",
        "m7":8100,
        "m7_month":"2020-09",
        "m8":8100,
        "m8_month":"2020-08",
        "m9":5400,
        "m9_month":"2020-07",
        "m10":3600,
        "m10_month":"2020-06",
        "m11":3600,
        "m11_month":"2020-05",
        "m12":3600,
        "m12_month":"2020-04",
        "updated_history":"2021-05-04",
        "updated_lms":"2021-05-04",
        "updated_cmp":"2021-05-04",
        "updated_cpc":"2021-05-04",
        "category_ids":[
            10114,
            10597,
            13605,
            10121,
            13610,
            10108,
            10013,
            10110,
            10014
        ],
        "category_strings":[
            "\/Arts & Entertainment",
            "\/Arts & Entertainment\/Sports Entertainment",
            "\/Arts & Entertainment\/Sports Entertainment\/Sport Scores & Statistics",
            "\/News, Media & Publications",
            "\/Sports & Fitness",
            "\/Sports & Fitness\/Sporting Goods",
            "\/Sports & Fitness\/Sports",
            "\/Sports & Fitness\/Sports\/Baseball",
            "\/Sports & Fitness\/Sports News & Media"
        ],
        "search_volume":4400
    }
]
				
			

Response Breakdown

  • LMS, AMS, and GMS now all report the same Average Monthly Search Volume
  • M1-M12 – the last 12 months of search volume
  • CPC – the estimated cost per click
  • CMP – the Adwords competition.

Models

RelatedQuery

				
					{
term*	        string
country	        string
                default: us
                Country code (us, au, etc.)

language	    string
                default: en
                Language code (en, es, etc.)
            
sort_by	        string
                default: volume
                Enum:
                [ volume, cpc, cmp ]
sort_direction	string
                default: desc
                Enum:  
                [ desc, asc ]
num_results	    integer
                default: 500
                minimum: 50
                maximum: 500
                example: 50
match_type	    string
                default: broad
                Enum:  
                [ broad, phrase ]
}
				
			

RelatedQueryResult

				
					{
status	    integer($int64)
            Response http-status
message	    string
errors      [string]
data        {
            term	string
            volume	integer
            cpc	number
            cmp	number
            category_ids        [integer]
            category_strings    [string]
            history             [RelatedQueryResultHistoryData{
                                date	string
                                example: 10-2020
                                volume	integer
                    }]            
            related_keywords    [RelatedData{
                                term	string
                                volume	integer
                                cpc	number
                                cmp	number
                                category_ids        [integer]
                                category_strings    [string]                
                                history             [RelatedQueryResultHistoryData{
                                                    date	string
                                                    example: 10-2020
                                                    volume	integer
                                                    }]            
                                }]
            }
}
				
			

RelatedData

				
					{
term	            string
volume	            integer
cpc	                number
cmp	                number
category_ids        [integer]
category_strings    [string]
history             [RelatedQueryResultHistoryData{
                    date	string
                    example: 10-2020
                    volume	integer
                    }]
}
				
			

RelatedQueryResultHistoryData

				
					{
date	string
        example: 10-2020
volume	integer
}