Thin Client

You will make a request to http://api.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.

Uses

Available Parameters

  • q – This is an array of topics. You can pass anywhere from 1 to 700 topics at once
  • locid – The location ID for which you would like data from
  • apikey – Your API key

Example

				
					curl -X "POST" "http://api.grepwords.com/"  -H 'Content-Type: application/x-www-form-urlencoded; charset=utf-8' --data-urlencode "q=[\"airport\",\"ave\"]"  --data-urlencode "apikey="APIKEY" --data-urlencode "locid=2840"
				
			

Response

				
					{
    "results":{
        "airport":{
            "string":"airport",
            "cpc":0.889179,
            "cmp":0.0026170814205058,
            "volume":1220000,
            "m1":1500000,
            "m1_month":4,
            "m1_year":2021,
            "m2":1220000,
            "m2_month":3,
            "m2_year":2021,
            "m3":1000000,
            "m3_month":2,
            "m3_year":2021,
            "m4":1000000,
            "m4_month":1,
            "m4_year":2021,
            "m5":1000000,
            "m5_month":12,
            "m5_year":2020,
            "m6":1220000,
            "m6_month":11,
            "m6_year":2020,
            "m7":1500000,
            "m7_month":10,
            "m7_year":2020,
            "m8":1500000,
            "m8_month":9,
            "m8_year":2020,
            "m9":1220000,
            "m9_month":8,
            "m9_year":2020,
            "m10":1000000,
            "m10_month":7,
            "m10_year":2020,
            "m11":1220000,
            "m11_month":6,
            "m11_year":2020,
            "m12":2240000,
            "m12_month":5,
            "m12_year":2020
        }
    },
    "query":{
        "q":"[\"airport\"]",
        "locid":"2840",
        "rini":3
    },
    "api_res":{
        "status":"ok",
        "task_id":1622134096,
        "results_time":"5.000 sec.",
        "results_count":1,
        "results":[
            {
                "language":"en",
                "key":"airport",
                "sv":1220000,
                "loc_id":"2840",
                "cpc":0.889179,
                "categories":"10144, 10017, 10785, 10778, 10146",
                "cmp":0.0026170814205058,
                "ms":[
                    {
                        "year":2021,
                        "month":4,
                        "count":1500000
                    },
                    {
                        "year":2021,
                        "month":3,
                        "count":1220000
                    },
                    {
                        "year":2021,
                        "month":2,
                        "count":1000000
                    },
                    {
                        "year":2021,
                        "month":1,
                        "count":1000000
                    },
                    {
                        "year":2020,
                        "month":12,
                        "count":1000000
                    },
                    {
                        "year":2020,
                        "month":11,
                        "count":1220000
                    },
                    {
                        "year":2020,
                        "month":10,
                        "count":1500000
                    },
                    {
                        "year":2020,
                        "month":9,
                        "count":1500000
                    },
                    {
                        "year":2020,
                        "month":8,
                        "count":1220000
                    },
                    {
                        "year":2020,
                        "month":7,
                        "count":1000000
                    },
                    {
                        "year":2020,
                        "month":6,
                        "count":1220000
                    },
                    {
                        "year":2020,
                        "month":5,
                        "count":2240000
                    }
                ]
            }
        ]
    }
}
				
			

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.