Lookup API Documentation

This is by far the fastest way to start using the GrepWords API. You will make a request to http://grepwords.com using your API key which will be issued to you within 5-10 minutes of sign up. Don’t forget to replace APIKEY with your API key.

/lookup Get GrepWords by Query

Available Parameters

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

Example

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

Response

				
					[
    {
        "gms":450000,
        "ams":450000,
        "lms":450000,
        "cpc":0.80133,
        "keyword":"baseball",
        "competition":0.19101640486314,
        "cmp":0.19101640486314,
        "m1":368000,
        "m1_month":"2021-03",
        "m2":301000,
        "m2_month":"2021-02",
        "m3":301000,
        "m3_month":"2021-01",
        "m4":246000,
        "m4_month":"2020-12",
        "m5":246000,
        "m5_month":"2020-11",
        "m6":823000,
        "m6_month":"2020-10",
        "m7":550000,
        "m7_month":"2020-09",
        "m8":550000,
        "m8_month":"2020-08",
        "m9":673000,
        "m9_month":"2020-07",
        "m10":450000,
        "m10_month":"2020-06",
        "m11":368000,
        "m11_month":"2020-05",
        "m12":368000,
        "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,
            10644,
            13605,
            10121,
            13610,
            10108,
            10014
        ],
        "category_strings":[
            "/News, Media & Publications",
            "/Sports & Fitness",
            "/Sports & Fitness/Sporting Goods",
            "/Sports & Fitness/Sporting Goods/Baseball Equipment",
            "/Sports & Fitness/Sports",
            "/Sports & Fitness/Sports/Baseball",
            "/Sports & Fitness/Sports News & Media"
        ],
        "search_volume":450000
    }
]

Models

Lookup Query

				
					{
term*		string
			Lookup grepwords term

country		string
			default: us
			example: us
			Country code (us, au, etc.). 

language	string
			default: en
			example: en
			Language code (en, es, etc.). 
}

LookupQueryResult

				
					{
status		integer($int64)
			Response http-statud

message		string
errors		[string]
data		[LookupQueryResultData{
			cpc					number
			cmp					number
			volume				integer
			keyword				string
			spell_type			string
			spell				string
			category_ids		[integer]
			category_strings	[string]
			history				[LookupQueryResultHistoryData{
								date	string
										example: 10-2020
								volume	integer
								}]
			}]
}

LookupQueryResultData

				
					{
cpc					number
cmp					number
volume				integer
keyword				string
spell_type			string
spell				string
category_ids		[integer]
category_strings	[string]
history				[LookupQueryResultHistoryData{
					date	string
							example: 10-2020
					volume	integer
					}]
}

LookupQueryResultHistoryData

				
					{
date	string
example: 10-2020
volume	integer
}