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

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
    }
]
				
			

/related

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.