Thin Client

You will make a request to https://api.marketmuse.com/keywords using your API key which will be issued to you within 5-10 minutes of sign up. Don’t forget to replace YOUR_API_KEY with your API key.


Available Parameters

  • keywords – This accepts an Array and is the right way to now pass your keywords to this endpoint
    • Example: [”books”, “content marketing”, “crm software”]
  • locid – Nothing here has changed, please use this parameter as before
  • language – this is a new parameter we have added to allow you to query for other languages – this parameter accepts a 2 letter format for language identification
    • Examples: en es de


					import json
import requests

# Must be 400 to 700 unique terms
keywords = ['pod transport cost', 'best tv signal in my area', 'tumi daniella small leather backpack', 'credit factor account', 'buy cord wood near me', 'hhn orlando app', 'how to take internet connection', 'motorola v551', 'best laptop for simple tasks', 'balloons video baby', 'formula offroad engine', 'dreams of spouse infidelity', '2018 mustang gt 401a package for sale', 'williams and sonoma dish towels', 'is 5ghz faster than 2.4 ghz wifi', 'cake boss breakfast recipes', 'short quotes about cleanliness', 'april 20 nyc events', 'utm course selection', 'best grooming software', 'mike and the mechanics latest cd', 'sell timeshare', 'comedy good series to watch on netflix', 'agribusiness m&a', 'free forza games', 'how has social change affected education', 'mr poopybutthole shot', 'can you freeze pillsbury crescent rolls', 'lexus rc review', 'dcsd mobilt password', 'home flipping loans', 'gel foam bed', 'cyberpunk 2077 limited edition pc', 'bring your own laptop policy', '3 bedroom bungalow design', 'what does a nigerian look like', 'serp bot', 'www northeast community college', 'scan doctor writing', 'common std tests', 'ipad pro 20q8', 'relationship between ethics and code of conduct', 'bread and life', 'jesus i am so in love with you song download', 'norwegian cruise line head office address', 'next day replacement phone insurance', 'b2b erbil', 'barney pull', 'what temperature do you cook sausages at', 'haier 32 inch led smart tv', 'bom production', 'hbo max samsung tv', 'pick a deadbolt lock with a credit card', 'underwear with a hole in the front', 'welltower logo', 'motorbike insurance reviews', 'hsa for pregnancy', 'medievil enemies', 'qantas stock analysis', 'about doberman pinscher dog', 'how much interest is my student loan accruing', 'samsung galaxy player 3.6 troubleshooting', 'how to freeze papaya', 'attack on titan recon corps logo', 'ralph arcade game', 'www endlesspools com sale', 'death of bill cosby daughter', 'toyota ia horsepower', 'the cube game show trailer', 'quetzaltenango guatemala', 'how to transfer documents from one computer to another', 'diy guided missile', 'charles schwab minnesota', '2020 february lease deals', 'dell g5 15 gaming review', 'kirkland signature 8.0 hearing aid canada', 'lassens market ventura', 'stainless steel backsplash ideas', 'classy braid hairstyles', 'samsung family hub fridge australia', 'adobe flash for iphone app', 'pemberton music festival 2014 lineup', 'becoming a new supervisor tips', 'noblesville indiana concert venue', 'merry christmas funny vine', 'full time jobs hiring', 'linksys whw0103 velop', 'watch breathing room', 'swift moving company', 'download pdf file using php', 'microsoft keyboard not working', 'cruise ship illness name', 'basic greenside bunker shot', 'arkansas tuition texas', 'abortion verses', 'black plastic scratch remover', 'how does joker movie end', 'how to build a corner shelf for tv', 'mx music player', 'sales strategy b2b business', 'nexus 7 improve wifi', 'what stadium do the yankees play in', 'jann arden workin moms', 'winchester spca', 'society6 black and white prints', 'northwestern vs minnesota basketball', 'computer consulting business plan', 'energyen', 'calculate good lease deal', 'facebook user agent', 'autonomous driving technology stocks', 'why won t usps accept my payment', 'sasha obama ryan reynolds', 'frost bank atm corpus christi tx', 'rumer singer', 'coffee cake filling recipe', 'fubotv latino package', 'vuze free download', '2016 mazda 3 brake problems', 'zapier company valuation', 'david stirling movie', 'how long is the movie grown ups 2', 'scythe ps2', 'beyblade burst gt download', 'martha y maria', 'lebron james family', 'jordan writing', 'vw golf hatch dimensions', 'how to fix wooden blinds', 'what are the two different types of partnerships', 'video decoration app', 'fdr first data', 'delete icloud bookmarks', 'stardust vs stephen amell', 'where to hang mirrors', 'run local docker image in kubernetes', 'billy gilman birthday', 'old cartoons 2010', 'no bake appetizers for a crowd', 'wet termites', 'jack burton comic', 'how big can an air plant get', 'daft recently added', 'nys ein number application', 'sodium vapour lamp price list', 'how much is gold gym membership fee', 'cart source', 'girls near me for fun', 'google earth compass direction', 'the terminator trailer hd', 'java console windows 7', 'day of defeat free', 'region bank card activation', 'private lesson scheduling software', 'ewg beauty', 'homemade steak burger recipe', '2020 monopoly', 'drinking when you have the flu', 'best protein tubs for beef cattle', 'rust loading server slow', 'what happened to ryan newman in the daytona 500', 'us oscar nominations', 'online at getmyoffer capitalone com', 'how to turn magnifier off iphone', 'adapx out of business', 'nintendo switch 1tb', 'youtube child security settings', 'voices in the air wrestlemania 28', 'iphone 11 launch date 2019', 'satellite internet frederick md', 'subrapubic catheter', 'student loan payment calculator multiple loans', 'go fund me medical expenses examples', 'credit repair processes', 'gps for older tractors', 'how to introduce a new business', 'games like abzu', 'how many movies released today', 'deep learning with python pdf github', 'release date for gta 6 xbox one', 'who plays pan on once upon a time', 'accenture annual turnover', 'arizonian tires manufacturer', 'jade tree light', 'best cutting method', 'facebook page list of followers', 'smite custom skins', 'who carries frozen artichoke hearts', 'wav cars for sale', 'check my nordstrom gift card', 'objects all', 'can u take 10 out atm', 'royal canin puppy food chart', 'acts 16 30', 'mallow plant french', 'lump crab meat price', 'charter phone remote', 'social security number on id card', 'open my own blog', 'evenflo epic 4 travel system', 'can you buy busch gardens tickets at the gate', '100.5 radio sacramento', 'heavy equipment inspection app', 'what do you need to buy for your first home', 'auto insurance rates washington state', '2015 nissan murano car and driver', 'download sopcast cho mac', 'elisabeth moss is ugly', 'roberts american horror story', 'old navy gold coat', 'cloud message apis', 'average cost of health insurance for a family of 5', 'amanda kyle', 'olay regenerist sculpting serum', 'pebble watch music control', 'generator fuel transfer pump', 'a cloud of witnesses bible verse', 'squeeze paramount austin', 'you don t know your beautiful by one direction', 'denise austin today', 'antonio banderas dolittle', 'alabama vs lsu 2018 tickets', 'what chase credit card should i get', 'wd5000aaks 75a7b2', 'killing floor 2 beta dates', 'backup windows 7 on external hard drive', 'samsung galaxy s10+ buy', 'galaxy buds vs plus', 'vw atlas r line silver', 'cna certification huntsville al', 'chord overstreet shirtless', '220 power cord adapter', 'what do seventh day adventist believe about death', 'malibu recovery house', 'chicken nugget plush', 'gifting a car in new york state', 'valrhona baking chocolate', 'evernote snapshot', 'biden harris speeches', 'saas factoring', 'how often do you season your cast iron skillet', 'how long do you need to boil brats', 'beach bum movie streaming', 'wwe network raw episodes', 'the betty engelstad arena', 'mayans mc full episodes free', 'probate property insurance', 'green 11 pro max', 'nascar heat evolution similar games', 'marshall & swift boeckh llc', 'daily bread experience', 'call center jobs in brussels belgium', '14 5 19', 'advantages of capitalist society', 'chris hemsworth diet for endgame', 'tom cruise house', 'gold fish pedicure', 'plane ticket installments', 'tractor supply lynden', 'atmosphere phoenix concert', 'weekly duty roster format excel', 'current market freight rates', 'cockroach in microwave oven door', 'define the word scope', 'dry cleaning pros and cons', 'rocking chair brown', 'what does water resistant to 30 meters mean', 'frickers sauces', 'how many seasons of fresh prince are there', 'business case for investment outline', 'is viber blocked in turkey', 'i need to make a 1000 dollars fast', 'solo tuyo romeo santos', 'bangladesh and sri lanka map', 'what episode do all the power rangers come together', 'desktop vehicle maintenance', 'bahman golbarnezhad video', 'claire resident evil 2 remake', 'what is a dropbox document', 'ellen degeneres show hugh jackman', 'pretty little liars aria clothes', 'advanced disposal acquisition', 'how much esa am i entitled to', 'athleta jeans', 'advantages of adopting software package solution', 'ipad pro diary app', 'bray wyatt vs john cena wrestlemania 36', 'sky zone hiring', 'deductible out of pocket maximum', 'how many points to be diamond on royal caribbean', 'frontier channel comparison', 'american express internship', 'camera sony ilce 3000', 'south bahamas conference logos', 'one main financial summerville sc', 'how to enable virtualization enabled in firmware in windows 10', 'red dead redemption 2 ultimate edition discount code', 'ned flanders age', 'how to take paint off wood door', 'pottery barn leather recliner for sale', 'how to apply minority scholarship', 'ilmn chart', 'web hosting for dummies', 'tantan app login', 'amd best processor for gaming 2017', 'website audit software', "river ridge children's furniture", 'which cable is used to connect router and pc', 'article error', 'crosley furniture tv stand', 'mobius awards 2018', 'soy stain', 'top off opal card', 'movies that come out on christmas day 2017', 'toshiba crt tv', 'big but small boobs', 'identity theft college students', 'a world without colour speech', 'metro pcs store closing hours', 'made from america', 'idrp student loans', 'average prime interest rate 2019', 'er construction', 'protein chicken meat', 'cadillac lease nyc', 'on my block people', 'netapp 2040 datasheet', 'matt damon scandal', 'does mcdonalds serve pizza', 'what channel is pix11 on time warner cable', 'rugrats season 5 episodes', 'author website squarespace', 'e0780', 'best state for public elk hunting', 'best nationwide bank', 'how do credit card transactions work', 'limble mobile computer desk with shelving', 'celine dion met gala dance', "what's patreon", 'beyonce knowles movies', 'kate spade portfolio', 'maze runner 3 movie', 'top places to visit in september', 'wage levels uk', 'aromatic recipes', 'best places to park near td garden', 'can ear drops unclog ears', '900 5th ave', 'what happened to michelle tanner in fuller house', 'buying jewelry from overstock', 'ios developer kit download', 'helene cordet', 'australia vs germany education', 'reddit customer service', 'merrill edge mutual funds', 'anesthesiologist salary in ohio', 'protocol definition wikipedia', 'someone on my mind', 'how will gen z shape the future', '50 shades darker filming locations', 'multiselect box', 'how to do letterhead in excel', 'salmo 119 4', 'free online star wars games', '3d drucker industrie kunststoff', 'create react web app', 'advanced warfare mission 6', 'best business attorney las vegas', 'wind barriers for decks', 'what happened to sharon reed on cbs news', 'zeus botnet source code', 'historic new york', 'newmarks', 'herbs 4 you denver', 'suicide squad kehlani', 'denver va medical center', 'can you add pudding to cake mix', 'best vrmmorpg', 'fellow passenger nadia afzal', 'peacock alley', 'law and order disciple cast', 'sports betting washington dc', 'www 76ers schedule com', 'china infrastructure spending', 'diy wedge haircut', '2017 raptor dimensions', 'las vegas fighter pilot experience', 'apple watch lost mode', 'lung cancer and hot flashes', 'can you over brine chicken', 'small group the movie trailer', 'andy cohen show', 'autofill lastpass ios', 'system tray share monitor', 'how much do people get paid for instagram ads', 'rocket league latest patch notes', 'ged courses in miami', 'rock of ages in hollywood', 't mobile roadside assistance towing miles limit', 'polica']
headers = {
  'x-api-key': 'wWuoQqYmul8P56Y02CwCo1zEaac4Q4za7EsQEzxe', 
  'Content-Type': 'application/json'

payload = {
    "keywords": keywords
    "locid": 2840, # Defaults to US
    "language": 'en, # Defaults to en
    "api_key": '<YOUR_API_KEY>'

response = requests.post(
  json=payload, headers=headers


    'term': 'italian herb pork chops',
    'volume': 10,
    'cpc': None,
    'cmp': 0.0102040816,
    'history': [
      {'volume': 10, 'date': '08-2021'},
      {'volume': 10, 'date': '07-2021'},
      {'volume': 10, 'date': '06-2021'},
      {'volume': 10, 'date': '05-2021'},
      {'volume': 20, 'date': '04-2021'},
      {'volume': 10, 'date': '03-2021'},
      {'volume': 10, 'date': '02-2021'},
      {'volume': 10, 'date': '01-2021'},
      {'volume': 10, 'date': '12-2020'},
      {'volume': 10, 'date': '11-2020'},
      {'volume': 20, 'date': '10-2020'},
      {'volume': 10, 'date': '09-2020'}
  'category_ids': [
  'category_strings': [
    '/Food & Groceries',
    '/Hobbies & Leisure',
    '/Food & Groceries/Food',
    '/Hobbies & Leisure/Cooking',
    '/Food & Groceries/Food/Sauces',
    '/Hobbies & Leisure/Cooking/Recipes',
    '/Food & Groceries/Food/Sauces/BBQ & Grilling Sauces',
    '/Food & Groceries/Food/Herbs & Spices']

Response Changes

As you can see from the updated response format, we have made some changes to make information easier to process.
  1. We have remove miscellaneous attributes that we unnecessary to reduce response size
    1. Most notably, competition is now only represented as cmp
  2. We have moved historical information into the new history Array
    1. Additionally within this Array we have changed the attributes to make responses more legible and easier to parse
    2. Each “history” object has the following keys
      1. volume – This represents the search volume for the corresponding date
      2. date – These dates are now represented in an MM-YYYY format
  3. We are now returning the category_strings to make parsing through categories easier and save an additional lookup


  1. We have implemented an included words minimum of 400 keywords per request
  2. The maximum of 700 keywords per request remains in place