Documentation > Reporting API > Rank Data Methods

Get Campaign Stats API

The Get Campaign Stats API method returns the following campaign information and ranking data for all keywords in a campaign for the most recent 30 days:

Campaign ID
Campaign Name
Campaign Domain
Keyword ID (optional)
Search Engine Name
Search Engine URL
Search Engine Country
Total number of Keywords
Total number of Search Engines
Average Rank Today
Average Rank Week
Average Rank Month
Minimum Rank
Maximum Rank
Rank Change Up (number of keywords)
Rank Change Down (number of keywords)
No Change (number of keywords)
Visibility Score
Visibility Date

Refer to Rank Ranger API Overview page for information on how to obtain API access, obtain an API Key, error codes and a full list of API methods.

Table of Contents

Parameters

key	string	The unique API key assigned to your account
campaign_id	string	Campaign ID number
output	string	Output format options: &output=xml (this is the default format) &output=json Either of these parameters can be added to the json output parameter: &output=json&json_strict=true (forces the results to come back as array instead of objects) &output=json&json_arr=true (causes the entire json to be wrapped as array)

Example

Base URL
https://www.rankranger.com/api/v2/?get_campaign_stats&key=YourAPIKey&campaign_id=XXXXX

Response

<tracking-data provider="rankranger" date="02/18/2019" time="14:59:13" status="ok">
    <result>
        <campaign_id>64781</campaign_id>
        <campaign_name>All Recipes</campaign_name>
        <main_domain>allrecipes.com</main_domain>
        <search_engines>
            <se>
                <id>1</id>
                <name>Google USA</name>
                <url>google.com</url>
                <country>UNITED STATES</country>
            </se>
            <se>
                <id>437</id>
                <name>Google Mobile</name>
                <url>google.com</url>
                <country>UNITED STATES</country>
            </se>
        </search_engines>
        <rank_stats>
            <total_keywords>12</total_keywords>
            <total_search_engines>2</total_search_engines>
            <stats>
                <avg_rank>
                    <se>
                        <se_id>1</se_id>
                        <month>2.92</month>
                        <week>3.17</week>
                        <today>3.50</today>
                    </se>
                    <se>
                        <se_id>437</se_id>
                        <month>8.08</month>
                        <week>8.00</week>
                        <today>8.17</today>
                    </se>
                </avg_rank>
                <daily_change>
                    <se>
                        <se_id>1</se_id>
                        <up>1</up>
                        <down>3</down>
                        <none>8</none>
                    </se>
                    <se>
                        <se_id>437</se_id>
                        <up>3</up>
                        <down>2</down>
                        <none>7</none>
                    </se>
                </daily_change>
                <overall_performance>
                    <se>
                        <se_id>1</se_id>
                        <min_rank>3.5000</min_rank>
                        <max_rank>3.5000</max_rank>
                    </se>
                    <se>
                        <se_id>437</se_id>
                        <min_rank>4.5833</min_rank>
                        <max_rank>8.1667</max_rank>
                    </se>
                </overall_performance>
                <visibility>
                    <se>
                        <se_id>1</se_id>
                        <vis_results>
                            <vis_result>
                                <date>2019-01-18</date>
                                <score>337</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-19</date>
                                <score>336</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-20</date>
                                <score>336</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-21</date>
                                <score>333</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-22</date>
                                <score>336</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-23</date>
                                <score>334</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-24</date>
                                <score>335</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-25</date>
                                <score>310</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-26</date>
                                <score>308</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-27</date>
                                <score>308</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-28</date>
                                <score>309</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-29</date>
                                <score>312</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-30</date>
                                <score>310</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-31</date>
                                <score>308</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-01</date>
                                <score>307</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-02</date>
                                <score>308</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-03</date>
                                <score>335</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-04</date>
                                <score>331</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-05</date>
                                <score>332</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-06</date>
                                <score>334</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-07</date>
                                <score>336</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-08</date>
                                <score>334</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-09</date>
                                <score>335</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-10</date>
                                <score>332</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-11</date>
                                <score>334</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-12</date>
                                <score>331</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-13</date>
                                <score>331</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-14</date>
                                <score>332</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-15</date>
                                <score>334</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-16</date>
                                <score>337</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-17</date>
                                <score>334</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-18</date>
                                <score>330</score>
                            </vis_result>
                        </vis_results>
                    </se>
                    <se>
                        <se_id>437</se_id>
                        <vis_results>
                            <vis_result>
                                <date>2019-01-18</date>
                                <score>275</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-19</date>
                                <score>252</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-20</date>
                                <score>276</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-21</date>
                                <score>275</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-22</date>
                                <score>274</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-23</date>
                                <score>268</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-24</date>
                                <score>272</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-25</date>
                                <score>249</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-26</date>
                                <score>247</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-27</date>
                                <score>251</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-28</date>
                                <score>247</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-29</date>
                                <score>249</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-30</date>
                                <score>250</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-01-31</date>
                                <score>250</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-01</date>
                                <score>250</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-02</date>
                                <score>246</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-03</date>
                                <score>267</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-04</date>
                                <score>271</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-05</date>
                                <score>273</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-06</date>
                                <score>272</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-07</date>
                                <score>278</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-08</date>
                                <score>277</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-09</date>
                                <score>282</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-10</date>
                                <score>275</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-11</date>
                                <score>276</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-12</date>
                                <score>279</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-13</date>
                                <score>280</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-14</date>
                                <score>277</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-15</date>
                                <score>279</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-16</date>
                                <score>285</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-17</date>
                                <score>269</score>
                            </vis_result>
                            <vis_result>
                                <date>2019-02-18</date>
                                <score>274</score>
                            </vis_result>
                        </vis_results>
                    </se>
                </visibility>
            </stats>
        </rank_stats>
    </result>
</tracking-data>

AخA
 
<tracking-data provider="rankranger" date="02/18/2019" time="14:59:13" status="ok">    <result>        <campaign_id>64781</campaign_id>        <campaign_name>All Recipes</campaign_name>        <main_domain>allrecipes.com</main_domain>        <search_engines>            <se>                <id>1</id>                <name>Google USA</name>                <url>google.com</url>                <country>UNITED STATES</country>            </se>            <se>                <id>437</id>                <name>Google Mobile</name>                <url>google.com</url>                <country>UNITED STATES</country>            </se>        </search_engines>        <rank_stats>            <total_keywords>12</total_keywords>            <total_search_engines>2</total_search_engines>            <stats>                <avg_rank>                    <se>                        <se_id>1</se_id>                        <month>2.92</month>                        <week>3.17</week>                        <today>3.50</today>                    </se>                    <se>                        <se_id>437</se_id>                        <month>8.08</month>                        <week>8.00</week>                        <today>8.17</today>                    </se>                </avg_rank>                <daily_change>                    <se>                        <se_id>1</se_id>                        <up>1</up>                        <down>3</down>                        <none>8</none>                    </se>                    <se>                        <se_id>437</se_id>                        <up>3</up>                        <down>2</down>                        <none>7</none>                    </se>                </daily_change>                <overall_performance>                    <se>                        <se_id>1</se_id>                        <min_rank>3.5000</min_rank>                        <max_rank>3.5000</max_rank>                    </se>                    <se>                        <se_id>437</se_id>                        <min_rank>4.5833</min_rank>                        <max_rank>8.1667</max_rank>                    </se>                </overall_performance>                <visibility>                    <se>                        <se_id>1</se_id>                        <vis_results>                            <vis_result>                                <date>2019-01-18</date>                                <score>337</score>                            </vis_result>                            <vis_result>                                <date>2019-01-19</date>                                <score>336</score>                            </vis_result>                            <vis_result>                                <date>2019-01-20</date>                                <score>336</score>                            </vis_result>                            <vis_result>                                <date>2019-01-21</date>                                <score>333</score>                            </vis_result>                            <vis_result>                                <date>2019-01-22</date>                                <score>336</score>                            </vis_result>                            <vis_result>                                <date>2019-01-23</date>                                <score>334</score>                            </vis_result>                            <vis_result>                                <date>2019-01-24</date>                                <score>335</score>                            </vis_result>                            <vis_result>                                <date>2019-01-25</date>                                <score>310</score>                            </vis_result>                            <vis_result>                                <date>2019-01-26</date>                                <score>308</score>                            </vis_result>                            <vis_result>                                <date>2019-01-27</date>                                <score>308</score>                            </vis_result>                            <vis_result>                                <date>2019-01-28</date>                                <score>309</score>                            </vis_result>                            <vis_result>                                <date>2019-01-29</date>                                <score>312</score>                            </vis_result>                            <vis_result>                                <date>2019-01-30</date>                                <score>310</score>                            </vis_result>                            <vis_result>                                <date>2019-01-31</date>                                <score>308</score>                            </vis_result>                            <vis_result>                                <date>2019-02-01</date>                                <score>307</score>                            </vis_result>                            <vis_result>                                <date>2019-02-02</date>                                <score>308</score>                            </vis_result>                            <vis_result>                                <date>2019-02-03</date>                                <score>335</score>                            </vis_result>                            <vis_result>                                <date>2019-02-04</date>                                <score>331</score>                            </vis_result>                            <vis_result>                                <date>2019-02-05</date>                                <score>332</score>                            </vis_result>                            <vis_result>                                <date>2019-02-06</date>                                <score>334</score>                            </vis_result>                            <vis_result>                                <date>2019-02-07</date>                                <score>336</score>                            </vis_result>                            <vis_result>                                <date>2019-02-08</date>                                <score>334</score>                            </vis_result>                            <vis_result>                                <date>2019-02-09</date>                                <score>335</score>                            </vis_result>                            <vis_result>                                <date>2019-02-10</date>                                <score>332</score>                            </vis_result>                            <vis_result>                                <date>2019-02-11</date>                                <score>334</score>                            </vis_result>                            <vis_result>                                <date>2019-02-12</date>                                <score>331</score>                            </vis_result>                            <vis_result>                                <date>2019-02-13</date>                                <score>331</score>                            </vis_result>                            <vis_result>                                <date>2019-02-14</date>                                <score>332</score>                            </vis_result>                            <vis_result>                                <date>2019-02-15</date>                                <score>334</score>                            </vis_result>                            <vis_result>                                <date>2019-02-16</date>                                <score>337</score>                            </vis_result>                            <vis_result>                                <date>2019-02-17</date>                                <score>334</score>                            </vis_result>                            <vis_result>                                <date>2019-02-18</date>                                <score>330</score>                            </vis_result>                        </vis_results>                    </se>                    <se>                        <se_id>437</se_id>                        <vis_results>                            <vis_result>                                <date>2019-01-18</date>                                <score>275</score>                            </vis_result>                            <vis_result>                                <date>2019-01-19</date>                                <score>252</score>                            </vis_result>                            <vis_result>                                <date>2019-01-20</date>                                <score>276</score>                            </vis_result>                            <vis_result>                                <date>2019-01-21</date>                                <score>275</score>                            </vis_result>                            <vis_result>                                <date>2019-01-22</date>                                <score>274</score>                            </vis_result>                            <vis_result>                                <date>2019-01-23</date>                                <score>268</score>                            </vis_result>                            <vis_result>                                <date>2019-01-24</date>                                <score>272</score>                            </vis_result>                            <vis_result>                                <date>2019-01-25</date>                                <score>249</score>                            </vis_result>                            <vis_result>                                <date>2019-01-26</date>                                <score>247</score>                            </vis_result>                            <vis_result>                                <date>2019-01-27</date>                                <score>251</score>                            </vis_result>                            <vis_result>                                <date>2019-01-28</date>                                <score>247</score>                            </vis_result>                            <vis_result>                                <date>2019-01-29</date>                                <score>249</score>                            </vis_result>                            <vis_result>                                <date>2019-01-30</date>                                <score>250</score>                            </vis_result>                            <vis_result>                                <date>2019-01-31</date>                                <score>250</score>                            </vis_result>                            <vis_result>                                <date>2019-02-01</date>                                <score>250</score>                            </vis_result>                            <vis_result>                                <date>2019-02-02</date>                                <score>246</score>                            </vis_result>                            <vis_result>                                <date>2019-02-03</date>                                <score>267</score>                            </vis_result>                            <vis_result>                                <date>2019-02-04</date>                                <score>271</score>                            </vis_result>                            <vis_result>                                <date>2019-02-05</date>                                <score>273</score>                            </vis_result>                            <vis_result>                                <date>2019-02-06</date>                                <score>272</score>                            </vis_result>                            <vis_result>                                <date>2019-02-07</date>                                <score>278</score>                            </vis_result>                            <vis_result>                                <date>2019-02-08</date>                                <score>277</score>                            </vis_result>                            <vis_result>                                <date>2019-02-09</date>                                <score>282</score>                            </vis_result>                            <vis_result>                                <date>2019-02-10</date>                                <score>275</score>                            </vis_result>                            <vis_result>                                <date>2019-02-11</date>                                <score>276</score>                            </vis_result>                            <vis_result>                                <date>2019-02-12</date>                                <score>279</score>                            </vis_result>                            <vis_result>                                <date>2019-02-13</date>                                <score>280</score>                            </vis_result>                            <vis_result>                                <date>2019-02-14</date>                                <score>277</score>                            </vis_result>                            <vis_result>                                <date>2019-02-15</date>                                <score>279</score>                            </vis_result>                            <vis_result>                                <date>2019-02-16</date>                                <score>285</score>                            </vis_result>                            <vis_result>                                <date>2019-02-17</date>                                <score>269</score>                            </vis_result>                            <vis_result>                                <date>2019-02-18</date>                                <score>274</score>                            </vis_result>                        </vis_results>                    </se>                </visibility>            </stats>        </rank_stats>    </result></tracking-data>

How to Obtain API Access

How to Generate New API Keys

API Console: Construct & Test API Requests

API Query Limits

Developer API Methods

API Error Codes

Get the ultimate SEO tools with the Rank Ranger Software
Learn More About Rank Ranger

Featured SEO Tools

SEO Dashboard Rank Tracker Social Analytics Link Manager White Label SEO

Marketing Dashboard Keyword Finder Insight Graph API

Resources

Top 100 Websites Rank Risk Index Google Algorithm Updates Google SERP Features Tool Mobile SERP Features Tool Visual Guide to SERP Features SEO Glossary

Rank Ranger

Pricing Contact us Blog Help Center Documentation Brand Ambassadors

Code	Text	Description
101	Invalid Method	Method does not exist, check your syntax
102	Invalid API Key	The API Key inserted is invalid, check for key accuracy
103	Invalid Domain	The Domain requested is invalid or does not exist in your account
104	Invalid Date	The selected date range or syntax is invalid
105	Invalid Keyword	The Keyword does not exist in this campaign
202	Invalid Campaign Name	The Campaign name is invalid or missing
203	Invalid Primary URL	The Primary URL is invalid or missing
204	Invalid Campaign ID	The Campaign ID is invalid or missing
208	Invalid Search Engine	Invalid Search Engine ID
210	Keyword already exists	The Keyword already exists in this campaign
211	Keywords exist in campaign	You need to delete Keywords from this campaign before trying to delete the campaign
212	Invalid Package ID	Invalid Package ID
215	Custom White Label URL is already in use for another campaign	The Custom URL that you have selected for your White Label Portal is in use by another campaign, please select a different URL
400	No Results	No results were found
401	Limit Reached	You have reached the maximum number of Campaigns allowed in your package
406	Too many processes requested	The account has exceeded the limit on the number of exports that can be run and stored via the Campaigns > Import & Export > Campaign Export tool. After downloading the files, you may delete them in the Campaign Export screen or via the API.

Get Campaign Stats API

Parameters

Example

Response

How to Obtain API Access

How to Generate New API Keys

API Console: Construct & Test API Requests

Getting Started: Samples of APIs used for Creating Campaigns

API Query Limits

Developer API Methods

Account Management

Account Data

Reporting API

Rank Data Methods

Research Methods

Search API

SEO Intelligence Methods

API FAQs

API Error Codes