# 🧪 7-Day Free Trial — Smart Keyword Research API Get full access for 7 days. No credit card required. ----------- 1. ✅ Includes 100 requests per day 2. ✅ Access core features: 3. Keyword Search Volume 4. CPC (Cost Per Click) 5. Trend Data 6. Keyword Difficulty % + Label 7. Keyword Intent Classification ----------- ## 🕒 Trial Duration: 7 Days ----------- - 🔐 Approval Required: Just submit the request with the reason - 💬 Example: “I’d like to try the Smart Keyword Research API for 7 days. ----------- ****Developer Documentation: How to Connect and Use Smart Keyword Research API**** ----------- **The Smart Keyword Research API** provides developers, marketers, and SEO platforms with programmatic access to real-time keyword intelligence data. Built for speed and insight, this API delivers high-quality keyword metrics for trend analysis, competition, and monetization potential. ----------- **🔍 Core Features :** Feature Description 1. 📈 **Trend Data** : View month-by-month search volume trends to understand seasonal patterns. 3. 🧠 **Keyword Intent** : Automatically classify intent: Informational, Navigational, Transactional, or Commercial. 5. ⚖️ **Keyword Difficulty %** : Estimate ranking difficulty as a percentage based on competition and other factors. 7. 🏷️ **Difficulty Label Easy-to-read label** : Easy, Medium, or Hard for each keyword. 9. 💰 **CPC (Cost Per Click)** : Understand monetization potential with average CPC (USD). 11. 🔍 **Search Volume** : Access accurate monthly global or geo-specific search volumes. 13. 🧾 **Keyword** : The actual keyword phrase returned as part of results. ----------- ## 🚀 Features: 🎯 **Keyword Intent Classification** – Know if a keyword is transactional, informational, etc. 🧠**SERP Feature Prediction** – Identify if a keyword triggers special SERP features 📊 **Monetization & Difficulty Scoring** – Estimate keyword profitability and ranking difficulty 🔑 **Keyword Search Volume** – Get average monthly searches 💰 **CPC (Cost Per Click)** – Understand commercial value ⚖️ **Competition Level** – See how hard it is to rank or bid 🌎 **Geo-Targeted Data** – Fetch metrics for specific countries or global 📈 **Trend Analysis** – View historical keyword trends month-by-month ----------- ## 👥 Who It’s For : - SEO & digital marketing platforms - Keyword research tools - Content strategists and agencies - Data-driven marketers - Developers building SEO dashboards ## 🔧 Use Cases : - Build custom keyword research tools - Enrich content briefs with accurate SEO metrics - Analyze keyword profitability by region - Power AI content with high-value keyword data - Identify low-competition, high-CPC opportunities ## Steps for Integrating a Form and Sending API Requests **1. Install Flask** First, you need to install Flask if you haven't already:

pip install Flask

**2. Create a Flask Application** Below is a full example that uses Flask to accept a keyword from the user and sends that keyword to the SEMrush Keyword Magic Tool API. This guide will walk you through how to integrate the SEMrush Keyword Magic Tool API using Python's http.client library. We will cover connecting to the API, setting up the necessary headers, and retrieving keyword research data.

from flask import Flask, render_template, request
import http.client

app = Flask(__name__)

@app.route("/", methods=["GET", "POST"])
def keyword_search():
    if request.method == "POST":
        # Get the keyword and country code input from the form
        user_keyword = request.form.get("keyword")
        country_code = request.form.get("country_code")

        # API call to SEMrush using the user keyword and country code
        conn = http.client.HTTPSConnection("smart-keyword-research-api.p.rapidapi.com")
        
        headers = {
            'x-rapidapi-key': "your-rapidapi-key",  # Replace with your actual API key
            'x-rapidapi-host': "smart-keyword-research-api.p.rapidapi.com"
        }
        
        # Construct the API request URL with the user-provided keyword and country code
        conn.request("GET", f"/keyword-research?keyword={user_keyword}&country={country_code}", headers=headers)
        
        # Get response from the API
        res = conn.getresponse()
        data = res.read()
        
        # Decode the response data and pass it to the template for display
        decoded_data = data.decode("utf-8")
        
        return render_template("index.html", keyword=user_keyword, country_code=country_code, api_response=decoded_data)
    
    return render_template("index.html")


if __name__ == "__main__":
    app.run(debug=True)

**3. Create a Basic HTML Form (index.html)** Create a file named index.html in a folder called templates within your project directory. This will serve as the user interface. **How It Works:** - New Input for Country Code: The form now has an additional input field for the country code. The user can specify the two-letter country code (e.g., us for the USA, in for India). - Dynamically Build the API URL: The API request now includes both the keyword and country code. If the user inputs the keyword "email marketing" and country code "us", the request would look like: ---------------------- **Prerequisites** - Python 3.x installed on your machine. - API Key from RapidAPI for smart keyword research - Step-by-Step Integration Guide **1. Install Required Libraries** Before you start, ensure that your Python environment is set up and that you have the required libraries. For this example, we will use Python's built-in http.client, so no additional libraries are needed. **2. Set Up Connection** We will use http.client.HTTPSConnection to establish a connection to the SEMrush Keyword Magic Tool API via RapidAPI.


import http.client

# Initialize HTTPS connection to SEMrush Keyword Magic Tool API via RapidAPI
conn = http.client.HTTPSConnection("smart-keyword-research-api.p.rapidapi.com")

**3. Define Headers** To authorize API requests, you need to include the required headers: x-rapidapi-key: Your unique API key from RapidAPI. x-rapidapi-host: The host, which is "semrush-keyword-magic-tool.p.rapidapi.com" for this tool.


headers = {
    'x-rapidapi-key': "your-rapidapi-key",  # Replace with your actual API key
    'x-rapidapi-host': "smart-keyword-research-api.p.rapidapi.com"
}

**4. Send API Request** Once the connection and headers are set, you can send a GET request to the API. In this example, we are searching for the keyword "email marketing" in the US market:


conn.request("GET", "/keyword-research?keyword=email%20marketing&country=us", headers=headers)

**5. Get the Response** After sending the request, the API will return a response. We will read this response and decode it from bytes to a string:


res = conn.getresponse()
data = res.read()

# Decode the byte data to a string and print the result
print(data.decode("utf-8"))

**6. Example API Response** The following is an example response from the API when searching for "email marketing":


{
    "keyword": "email marketing",
    "avg_monthly_searches": 550000,
    "competition_value": "MEDIUM",
    "competition_index": 41,
    "High CPC": "$13.44",
    "Low CPC": "$0.66",
    "monthly_search_volumes": [
        {
            "month": "OCTOBER",
            "searches": 450000,
            "year": 2023
        }
    ]
}

**7. Interpreting the Output** 1. keyword: The keyword you searched for. 2. avg_monthly_searches: The average monthly search volume for the keyword. 3. competition_value: Describes the keyword's competitiveness (e.g., LOW, MEDIUM, HIGH). 4. competition_index: A numerical representation of competition. 5. High CPC: The highest cost-per-click (CPC) for the keyword. 6. Low CPC: The lowest CPC for the keyword. 7. monthly_search_volumes: Contains details of search volumes for specific months. **Example extracted output:**


Keyword: email marketing
Average Monthly Searches: 550,000
Competition Value: MEDIUM
High CPC: $13.44
Low CPC: $0.66
Search Volume for October 2023: 450,000

**8. Error Handling (Optional)** Always ensure to handle errors gracefully. You can implement basic error checking like so:


if res.status != 200:
    print(f"Error: {res.status}")
else:
    print(data.decode("utf-8"))

****Final Notes**** - Make sure to replace the placeholder your-rapidapi-key with your actual API key. - You can modify the keyword and country parameters based on your specific use case. - For detailed API documentation, refer to the official API page on RapidAPI. - ### Available Country Codes The API supports the following country codes:

 
            
                
                      Code
            Country
                
            
            
                af Afghanistan
                al Albania
                dz Algeria
                as American Samoa
                ad Andorra
                ao Angola
                ai Anguilla
                aq Antarctica
                ag Antigua and Barbuda
                ar Argentina
                am Armenia
                aw Aruba
                au Australia
                at Austria
                az Azerbaijan
                bs Bahamas
                bh Bahrain
                bd Bangladesh
                bb Barbados
                by Belarus
                be Belgium
                bz Belize
                bj Benin
                bm Bermuda
                bt Bhutan
                bo Bolivia
                bq Bonaire, Sint Eustatius and Saba
                ba Bosnia and Herzegovina
                bw Botswana
                bv Bouvet Island
                br Brazil
                io British Indian Ocean Territory
                bn Brunei Darussalam
                bg Bulgaria
                bf Burkina Faso
                bi Burundi
                kh Cambodia
                cm Cameroon
                ca Canada
                cv Cape Verde
                ky Cayman Islands
                cf Central African Republic
                td Chad
                cl Chile
                cn China
                cx Christmas Island
                cc Cocos (Keeling) Islands
                co Colombia
km Comoros
                cg Congo
                cd Congo, the Democratic Republic of the
                ck Cook Islands
                cr Costa Rica
                ci Cote D'Ivoire
                hr Croatia
                cu Cuba
                cw Curaçao
                cy Cyprus
                cz Czech Republic
                dk Denmark
                dj Djibouti
                dm Dominica
                do Dominican Republic
                ec Ecuador
                eg Egypt
                sv El Salvador
                gq Equatorial Guinea
                er Eritrea
                ee Estonia
                sz Eswatini
                et Ethiopia
                fk Falkland Islands (Malvinas)
                fo Faroe Islands
                fj Fiji
                fi Finland
                fr France
                gf French Guiana
                pf French Polynesia
                tf French Southern Territories
                ga Gabon
                gm Gambia
                ge Georgia
                de Germany
                gh Ghana
                gi Gibraltar
                gr Greece
                gl Greenland
                gd Grenada
                gp Guadeloupe
                gu Guam
                gt Guatemala
                gg Guernsey
                gn Guinea
                gw Guinea-Bissau
                gy Guyana

Code	Country
af	Afghanistan
al	Albania
dz	Algeria
as	American Samoa
ad	Andorra
ao	Angola
ai	Anguilla
aq	Antarctica
ag	Antigua and Barbuda
ar	Argentina
am	Armenia
aw	Aruba
au	Australia
at	Austria
az	Azerbaijan
bs	Bahamas
bh	Bahrain
bd	Bangladesh
bb	Barbados
by	Belarus
be	Belgium
bz	Belize
bj	Benin
bm	Bermuda
bt	Bhutan
bo	Bolivia
bq	Bonaire, Sint Eustatius and Saba
ba	Bosnia and Herzegovina
bw	Botswana
bv	Bouvet Island
br	Brazil
io	British Indian Ocean Territory
bn	Brunei Darussalam
bg	Bulgaria
bf	Burkina Faso
bi	Burundi
kh	Cambodia
cm	Cameroon
ca	Canada
cv	Cape Verde
ky	Cayman Islands
cf	Central African Republic
td	Chad
cl	Chile
cn	China
cx	Christmas Island
cc	Cocos (Keeling) Islands
co	Colombia
km	Comoros
cg	Congo
cd	Congo, the Democratic Republic of the
ck	Cook Islands
cr	Costa Rica
ci	Cote D'Ivoire
hr	Croatia
cu	Cuba
cw	Curaçao
cy	Cyprus
cz	Czech Republic
dk	Denmark
dj	Djibouti
dm	Dominica
do	Dominican Republic
ec	Ecuador
eg	Egypt
sv	El Salvador
gq	Equatorial Guinea
er	Eritrea
ee	Estonia
sz	Eswatini
et	Ethiopia
fk	Falkland Islands (Malvinas)
fo	Faroe Islands
fj	Fiji
fi	Finland
fr	France
gf	French Guiana
pf	French Polynesia
tf	French Southern Territories
ga	Gabon
gm	Gambia
ge	Georgia
de	Germany
gh	Ghana
gi	Gibraltar
gr	Greece
gl	Greenland
gd	Grenada
gp	Guadeloupe
gu	Guam
gt	Guatemala
gg	Guernsey
gn	Guinea
gw	Guinea-Bissau
gy	Guyana



    
        
            Code
            Country
        
    
    
        ht Haiti
        hm Heard Island and Mcdonald Islands
        va Holy See (Vatican City State)
        hn Honduras
        hk Hong Kong
        hu Hungary
        is Iceland
        in India
        id Indonesia
        ir Iran, Islamic Republic of
        iq Iraq
        ie Ireland
        im Isle of Man
        il Israel
        it Italy
        jm Jamaica
        jp Japan
        je Jersey
        jo Jordan
        kz Kazakhstan
        ke Kenya
        ki Kiribati
        xk Kosovo
        kw Kuwait
        kg Kyrgyzstan
        la Lao People's Democratic Republic
        lv Latvia
        lb Lebanon
        ls Lesotho
        lr Liberia
        ly Libya
        li Liechtenstein
        lt Lithuania
        lu Luxembourg
        mo Macao
        mg Madagascar
        mw Malawi
        my Malaysia
        mv Maldives
        ml Mali
        mt Malta
        mh Marshall Islands
        mq Martinique
        mr Mauritania
        mu Mauritius
        yt Mayotte
        mx Mexico
        fm Micronesia, Federated States of
        md Moldova, Republic of
        mc Monaco
        mn Mongolia
        me Montenegro
        ms Montserrat
        ma Morocco
        mz Mozambique
        mm Myanmar
        na Namibia
        nr Nauru
        np Nepal
        nl Netherlands
        nc New Caledonia
        nz New Zealand
        ni Nicaragua
        ne Niger
        ng Nigeria
        nu Niue
        nf Norfolk Island
        kp North Korea
        mk North Macedonia, Republic of
        mp Northern Mariana Islands
        no Norway
        om Oman
        pk Pakistan
        pw Palau
        ps Palestinian Territory, Occupied
        pa Panama
        pg Papua New Guinea
        py Paraguay
        pe Peru
        ph Philippines
        pn Pitcairn
        pl Poland
        pt Portugal
        pr Puerto Rico
        qa Qatar
        re Reunion
        ro Romania
        ru Russian Federation
        rw Rwanda
        bl Saint Barthélemy
        sh Saint Helena
        kn Saint Kitts and Nevis
        lc Saint Lucia
        mf Saint Martin (French part)
        pm Saint Pierre and Miquelon
        vc Saint Vincent and the Grenadines
        ws Samoa
        sm San Marino
        st Sao Tome and Principe
        sa Saudi Arabia
        sn Senegal
        rs Serbia
        sc Seychelles
        sl Sierra Leone
        sg Singapore
        sx Sint Maarten (Dutch part)
        sk Slovakia
        si Slovenia
        sb Solomon Islands
        so Somalia
        za South Africa
        gs South Georgia and the South Sandwich Islands
        kr South Korea
        ss South Sudan
        es Spain
        lk Sri Lanka
        sd Sudan
        sr Suriname
        sj Svalbard and Jan Mayen
        se Sweden
        ch Switzerland
        sy Syrian Arab Republic
        tw Taiwan
        tj Tajikistan
        tz Tanzania, United Republic of
        th Thailand
        tl Timor-Leste
        tg Togo
        tk Tokelau
        to Tonga
        tt Trinidad and Tobago
        tn Tunisia
        tr Turkey
        tm Turkmenistan
        tc Turks and Caicos Islands
        tv Tuvalu
        ug Uganda
        ua Ukraine
        ae United Arab Emirates
        gb United Kingdom
        uk United Kingdom
        um United States Minor Outlying Islands
        us United States of America
        uy Uruguay
        uz Uzbekistan
        vu Vanuatu
        ve Venezuela
        vn Vietnam
        vg Virgin Islands, British
        vi Virgin Islands, U.S.
        wf Wallis and Futuna
        eh Western Sahara
        ye Yemen
        zm Zambia
        zw Zimbabwe
        ax Åland Islands

Code	Country
ht	Haiti
hm	Heard Island and Mcdonald Islands
va	Holy See (Vatican City State)
hn	Honduras
hk	Hong Kong
hu	Hungary
is	Iceland
in	India
id	Indonesia
ir	Iran, Islamic Republic of
iq	Iraq
ie	Ireland
im	Isle of Man
il	Israel
it	Italy
jm	Jamaica
jp	Japan
je	Jersey
jo	Jordan
kz	Kazakhstan
ke	Kenya
ki	Kiribati
xk	Kosovo
kw	Kuwait
kg	Kyrgyzstan
la	Lao People's Democratic Republic
lv	Latvia
lb	Lebanon
ls	Lesotho
lr	Liberia
ly	Libya
li	Liechtenstein
lt	Lithuania
lu	Luxembourg
mo	Macao
mg	Madagascar
mw	Malawi
my	Malaysia
mv	Maldives
ml	Mali
mt	Malta
mh	Marshall Islands
mq	Martinique
mr	Mauritania
mu	Mauritius
yt	Mayotte
mx	Mexico
fm	Micronesia, Federated States of
md	Moldova, Republic of
mc	Monaco
mn	Mongolia
me	Montenegro
ms	Montserrat
ma	Morocco
mz	Mozambique
mm	Myanmar
na	Namibia
nr	Nauru
np	Nepal
nl	Netherlands
nc	New Caledonia
nz	New Zealand
ni	Nicaragua
ne	Niger
ng	Nigeria
nu	Niue
nf	Norfolk Island
kp	North Korea
mk	North Macedonia, Republic of
mp	Northern Mariana Islands
no	Norway
om	Oman
pk	Pakistan
pw	Palau
ps	Palestinian Territory, Occupied
pa	Panama
pg	Papua New Guinea
py	Paraguay
pe	Peru
ph	Philippines
pn	Pitcairn
pl	Poland
pt	Portugal
pr	Puerto Rico
qa	Qatar
re	Reunion
ro	Romania
ru	Russian Federation
rw	Rwanda
bl	Saint Barthélemy
sh	Saint Helena
kn	Saint Kitts and Nevis
lc	Saint Lucia
mf	Saint Martin (French part)
pm	Saint Pierre and Miquelon
vc	Saint Vincent and the Grenadines
ws	Samoa
sm	San Marino
st	Sao Tome and Principe
sa	Saudi Arabia
sn	Senegal
rs	Serbia
sc	Seychelles
sl	Sierra Leone
sg	Singapore
sx	Sint Maarten (Dutch part)
sk	Slovakia
si	Slovenia
sb	Solomon Islands
so	Somalia
za	South Africa
gs	South Georgia and the South Sandwich Islands
kr	South Korea
ss	South Sudan
es	Spain
lk	Sri Lanka
sd	Sudan
sr	Suriname
sj	Svalbard and Jan Mayen
se	Sweden
ch	Switzerland
sy	Syrian Arab Republic
tw	Taiwan
tj	Tajikistan
tz	Tanzania, United Republic of
th	Thailand
tl	Timor-Leste
tg	Togo
tk	Tokelau
to	Tonga
tt	Trinidad and Tobago
tn	Tunisia
tr	Turkey
tm	Turkmenistan
tc	Turks and Caicos Islands
tv	Tuvalu
ug	Uganda
ua	Ukraine
ae	United Arab Emirates
gb	United Kingdom
uk	United Kingdom
um	United States Minor Outlying Islands
us	United States of America
uy	Uruguay
uz	Uzbekistan
vu	Vanuatu
ve	Venezuela
vn	Vietnam
vg	Virgin Islands, British
vi	Virgin Islands, U.S.
wf	Wallis and Futuna
eh	Western Sahara
ye	Yemen
zm	Zambia
zw	Zimbabwe
ax	Åland Islands