Documentation > Search API > SEO Intelligence Methods

Google Jobs Search API

The Google Jobs Search API method provides rank date, keyword, rank position, job listing URL, listing title, full job listing text, company, location, post time, and employment type.

API Type: this is a stand-alone API-only package, it does not include access to our reporting platform reports or Reporting API methods.

Data Retention: data generated by this API is stored for 60 days.

Contact us with the number of keywords and your frequency requirements (e.g., daily, weekly or monthly), and we'll provide you with information regarding a custom Google Jobs Search API package and pricing.

API Options & Restrictions

API package capacity can be upgraded at any time.

Multiple types of API packages (Google Jobs Daily API, Rank Top 50 Weekly with SERP Features, Google Suggested Search Monthly, etc.) can exist in one account.
IMPORTANT! When creating new campaigns you must be careful to select the correct package for the new campaign because you:

Cannot transfer keywords or campaigns between Reporting Platform and API packages or between different types of API packages.
Cannot change an existing API package to a different type (e.g., Rank Top50 to Google Suggested Search).
Cannot change the frequency (e.g. from Monthly to Daily) of an existing API package.

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.

Parameters

key	string	The unique API key assigned to your account
keyword	string	Keyword
date	yyyy-mm-dd	Requested data date Optional: Date Range can be called using &start_date=YYYY-MM-DD&end_date=YYYY-MM-DD (for up to a span of 10 days) If date is used, then do not include the results parameter
se_id	int	Search Engine ID (Google Jobs USA is 547, refer to Search Engine List method for other countries)
campaign_id	int	Campaign ID number
results	int	Optional: Number of days' data (up to 10) Do not use with date parameter
show_title	string	Optional: to include SERP Link Title in results
show_desc	string	Optional: to include the job listing text in results
batch_start batch_limit	string	Optional: The Batch request may be used to obtain results in batches of 200 keywords at a time. This option requires the parameters batch_start=X&batch_limit=200, where X equals the beginning of the batch. To request the first 200 keywords in a campaign, this is an example request: https://www.rankranger.com/api/v2/?google_for_jobs_api_results&key=YOUR-API-KEY&se_id=SEARCH-ENGINE-ID&campaign_id=YOUR-CAMPAIGN-ID&show_title=true&batch_start=1&batch_limit=200 The request for the next batch would start with 201, for example: &batch_start=201&batch_limit=200 Do not use date and keyword parameters when choosing the batch option

Example Requests

Construct & test API requests in the API Console or follow one of these examples:

Google Jobs with Title and Full Description for specific date
https://www.rankranger.com/api/v2/?google_for_jobs_api_results&key=YourAPIkey&date=YYYY-MM-DD&campaign_id=XXXXX&keyword=your-keyword&se_id=XXX&show_title=true&show_desc=true

Google Jobs for a Date Range
https://www.rankranger.com/api/v2/?google_for_jobs_api_results&key=YourAPIkey&start_date=YYYY-MM-DD&end_date=YYYY-MM-DD&campaign_id=XXXXX&keyword=your-keyword&se_id=XXX&show_title=true&show_desc=true

Google Jobs for a specific number of Results
https://www.rankranger.com/api/v2/?google_for_jobs_api_results&key=YOUR-API-KEY&keyword=your-keyword&se_id=XXX&campaign_id=XXXXX&results=20&show_title=true&show_desc=true

Google Jobs Batch Request
https://www.rankranger.com/api/v2/?google_for_jobs_api_results&key=YourAPIkey&se_id=XXX&campaign_id=XXXXXX&show_title=true&show_desc=true&batch_start=1&batch_limit=200

The request for the next batch would start with 201, for example:
https://www.rankranger.com/api/v2/?google_for_jobs_api_results&key=YourAPIkey&se_id=XXX&campaign_id=XXXXXX&show_title=true&show_desc=true&batch_start=201&batch_limit=200

The default output is in XML format, if you would like the output to be json the you will need to add "&output=json at the end of the string

Response Example

<tracking-data provider="rankranger" date="12/13/2018" time="13:54:58" status="ok">
    <results>
        <result>
            <details>
                <date>2018-12-12</date>
                <se_id>547</se_id>
                <keyword_name>electrical engineer</keyword_name>
                <keyword_identifier/>
            </details>
            <search_results>
                <search_result>
                    <rank>1</rank>
                    <url>
https://www.careerbuilder.com/job/J3V84C6TQPTFY2PN1C0?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic
</url>
                    <extra>HTTPS</extra>
                    <title>Entry Level Electrical Engineer</title>
                    <desc>
Job Description AES is searching for a qualified Entry Level Electrical Engineer for a very reputable company in the Columbus are. Pay: $18-$20/hour depending on experience Job Description: Depending on operation, the Test Technician will perform any or all the following operations: Performs functional testing of UPS, Charger and Inverter modules. Conducts witness tests and/or assist Test Engineers conducting witness tests. The position will be responsible for verifying conformance to all specified requirements. -Performing electrical tests and systems testing on UPS units Design and develop instrumentation systems that incorporate uncertainty analysis to produce the most accurate testing systems. Collection of data with electronic equipment. Duties include, but are not limited to, physical inspection and the functional inspection of electrical components, the operation of test bays/stations and associated equipment and troubleshooting and/or repairing faulty... components. Must assess product evaluation against engineered standards which may include UL/CSA/IEEE standards. Review order write-ups, operate components, ensure product quality, work with other areas to ensure quality, and verify units to meet agency approvals. Configure and connect system equipment (switchgear, SCCT cabinets, and power ties), and perform preliminary inspection and tests. About Aerotek: We know that a company's success starts with its employees. We also know that an individual's success starts with the right career opportunity. As a Best of Staffing® Client and Talent leader, Aerotek's people-focused approach yields competitive advantage for our clients and rewarding careers for our contract employees. Since 1983, Aerotek has grown to become a leader in recruiting and staffing services. With more than 250 non-franchised offices, Aerotek's 8,000 internal employees serve more than 300,000 contract employees and 18,000 clients every year. Aerotek is an Allegis Group company, the global leader in talent solutions. Learn more at Aerotek.com. The company is an equal opportunity employer and will consider all applications without regards to race, sex, age, color, religion, national origin, veteran status, disability, sexual orientation, gender identity, genetic information or any characteristic protected by law. If you would like to request a reasonable accommodation, such as the modification or adjustment of the job application process or interviewing process due to a disability, please call 888-237-6835 or email accommodation@aerotek .com for other accommodation options. However, if you have questions about this position, please contact the Recruiter located at the bottom of the job posting. The Recruiter is the sole point of contact for questions about this position
</desc>
                    <company>Aerotek</company>
                    <location>Columbus, OH</location>
                    <post_time>14 hours ago</post_time>
                    <employment_type>Full-time</employment_type>
                </search_result>
                <search_result>
                    <rank>2</rank>
                    <url>
https://job-openings.monster.com/electrical-engineer-70k-columbus-oh-us-pro-vision-inc/11/203638906?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic
</url>
                    <extra>HTTPS</extra>
                    <title>Electrical Engineer - $70K</title>
                    <desc>
How would you like to join the Engineering Team of a company named by Inc. Magazine for years as one of the fastest-growing companies in America? We are PRO-VISION! Our record setting growth is due to the world-class efforts of our top level engineering talent that develops mobile video hardware and software utilized around the world in operations such as national security, military, transit, utilities, law enforcement, and commercial transport. Our achievement has further fueled our relentless drive to push our growth to new record setting levels and thus generating the need for additional top engineering talent to fill multiple new positions. We are looking for the absolute best Electrical Engineers to take part in the design, development, and improvement of cutting edge technology such as body cameras and our latest 8 channel 1080P mobile HD video recorder. With products such as these, PRO-VISION continues to provide unmatched quality and performance by delivering true high... definition video recording, vehicle integration, GPS location, G-force dynamics, integrated WIFI, and cellular connectivity. A PRO-VISION Engineer must have the drive, desire, and talent to work as a team to incorporate the latest technology into our mobile products so we may continue to provide our customers with the most reliable, simple, and affordable products in the industry. If you are the right person for this opportunity, you would describe yourself as having the self-motivation, energy, and attitude to do anything it takes to keep our commitment to being our industry’s leader. Your style will be relaxed and self-confident. You would describe yourself as friendly and enthusiastic. You would be professional, persistent, and conscientious, have a methodical approach to your work, and meet the following requirements: • Bachelor’s Degree in Electrical Engineering • 3 or more years of relevant experience • Fluent in Chinese(Mandarin) is a plus • Advanced knowledge of Digital and Analog Electronics • Advanced knowledge of PCBA layouts  Advanced knowledge of Computer Hardware and Software  Excellent verbal and written communication skills  Excellent organizational and prioritization skills of all types of tasks and activities  Excellent interpersonal skills to work with all department types to achieve goals This position is best suited for a creative, innovative professional that desires a fast-paced entrepreneurial business environment, limited daily management, decision making responsibility, and a role in the direction of a growing company. This is a full time, salaried position. This position offers a great work environment, unlimited potential for advancement, competitive compensation, and excellent benefits that include a generous health plan and company matched 401(K). Compensation is commensurate with experience. This position is located in Byron Center, MI. Relocation plans are available. If you are ready for a new and challenging career with an industry leading company, email your resume to hr@provisionusa.com. No phone calls please
</desc>
                    <company>Pro-Vision, Inc.</company>
                    <location>Columbus, OH</location>
                    <post_time>1 day ago</post_time>
                    <employment_type>Full-time</employment_type>
                </search_result>
                <search_result>
                    <rank>3</rank>
                    <url>
https://www.careerbuilder.com/job/J3Q3KY746DC0F1J01BL?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic
</url>
                    <extra>HTTPS</extra>
                    <title>Electrical Engineer</title>
                    <desc>
Job Description Looking for an ELECTRICAL ENGINEER. They are responsible for engineering and making sure all safety/compliance is followed regarding P&C and relay equipment relating to generation. This can be SEL or GE relays, in the plant control room or connecting to the switch yard. Every 5 years, this group needs to review ALL equipment drawings and verify they have been maintained properly according to NERC and AEP compliance. They will review these documents in their internal systems, and report it all online. They need 5 people to help for at least a year to get through all these drawings and reportings. • Designs, tests, installs, and maintains large-scale electronic equipment or machinery for use in manufacturing or power generation or transmission. May use computer-assisted engineering and design software and equipment to perform assignments. • Requires a bachelor's degree in engineering OR Associate's degree with a few years of I&C tech experience. • Must be familiar with... reading blueprints and drawings, as they will be looking at relay and P&C equipment, but do NOT need to know how to program these things. Simply reviewing the drawings for the information they need. • Minimum Requirements: Bachelor's degree in engineering in a program accredited by the Engineering Accreditation Commission of the Accreditation Board for Engineering and Technology (ABET). • Experience with NERC Protective Relay and Control Standards preferred. About Aerotek: We know that a company's success starts with its employees. We also know that an individual's success starts with the right career opportunity. As a Best of Staffing® Client and Talent leader, Aerotek's people-focused approach yields competitive advantage for our clients and rewarding careers for our contract employees. Since 1983, Aerotek has grown to become a leader in recruiting and staffing services. With more than 250 non-franchised offices, Aerotek's 8,000 internal employees serve more than 300,000 contract employees and 18,000 clients every year. Aerotek is an Allegis Group company, the global leader in talent solutions. Learn more at Aerotek.com. The company is an equal opportunity employer and will consider all applications without regards to race, sex, age, color, religion, national origin, veteran status, disability, sexual orientation, gender identity, genetic information or any characteristic protected by law. If you would like to request a reasonable accommodation, such as the modification or adjustment of the job application process or interviewing process due to a disability, please call 888-237-6835 or email accommodation@aerotek .com for other accommodation options. However, if you have questions about this position, please contact the Recruiter located at the bottom of the job posting. The Recruiter is the sole point of contact for questions about this position
</desc>
                    <company>Aerotek</company>
                    <location>Columbus, OH</location>
                    <post_time>2 days ago</post_time>
                    <employment_type>Full-time</employment_type>
                </search_result>
                <search_result>
                    <rank>4</rank>
                    <url>
https://www.careerbuilder.com/job/J3330H5X4CC2V4WCK34?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic
</url>
                    <extra>HTTPS</extra>
                    <title>Electrical Engineer-PE</title>
                    <desc>
Job Description This multi-discipline Engineering Consulting Firm is prepared to offer you a lot of variety and security in exchange for the talent that you bring to their growing operation. Quarterly bonuses and yearly profit sharing combine with benefits that are paid 100% for family coverage! If you are curious as to how you can take advantage of this stellar opportunity, we would like to speak with you in more detail! Please call for more information as well as the possibility of scheduling an interview. If you are looking for a new career in the new year, this is the time to investigate a change. Call TODAY! Job Requirements to be discussed!
</desc>
                    <company>GEE Group Inc</company>
                    <location>Columbus, OH</location>
                    <post_time>2 days ago</post_time>
                    <employment_type>Full-time</employment_type>
                </search_result>
                <search_result>
                    <rank>5</rank>
                    <url>
https://www.linkedin.com/jobs/view/entry-level-electrical-engineer-at-visionworks-of-america-1018119473?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic
</url>
                    <extra>HTTPS</extra>
                    <title>Entry Level Electrical Engineer</title>
                    <desc>
Job Description AES is searching for a qualified Entry Level Electrical Engineer for a very reputable company in the Columbus are. Pay $18-$20/hour depending on experience Job Description Depending on operation, the Test Technician will perform any or all the following operations: Performs functional testing of UPS, Charger and Inverter modules. Conducts witness tests and/or assist Test Engineers conducting witness tests. The position will be responsible for verifying conformance to all specified requirements. • Performing electrical tests and systems testing on UPS units Design and develop instrumentation systems that incorporate uncertainty analysis to produce the most accurate testing systems. Collection of data with electronic equipment. Duties include, but are not limited to, physical inspection and the functional inspection of electrical components, the operation of test bays/stations and associated equipment and troubleshooting and/or repairing faulty components. Must... assess product evaluation against engineered standards which may include UL/CSA/IEEE standards. Review order write-ups, operate components, ensure product quality, work with other areas to ensure quality, and verify units to meet agency approvals. Configure and connect system equipment (switchgear, SCCT cabinets, and power ties), and perform preliminary inspection and tests. About Aerotek We know that a company's success starts with its employees. We also know that an individual's success starts with the right career opportunity. As a Best of Staffing® Client and Talent leader, Aerotek's people-focused approach yields competitive advantage for our clients and rewarding careers for our contract employees. Since 1983, Aerotek has grown to become a leader in recruiting and staffing services. With more than 250 non-franchised offices, Aerotek's 8,000 internal employees serve more than 300,000 contract employees and 18,000 clients every year. Aerotek is an Allegis Group company, the global leader in talent solutions. Learn more at Aerotek.com. The company is an equal opportunity employer and will consider all applications without regards to race, sex, age, color, religion, national origin, veteran status, disability, sexual orientation, gender identity, genetic information or any characteristic protected by law. If you would like to request a reasonable accommodation, such as the modification or adjustment of the job application process or interviewing process due to a disability, please call 888-237-6835 or email accommodation@aerotek .com for other accommodation options. However, if you have questions about this position, please contact the Recruiter located at the bottom of the job posting. The Recruiter is the sole point of contact for questions about this position
</desc>
                    <company>Visionworks of America</company>
                    <location>Columbus, OH</location>
                    <post_time>4 hours ago</post_time>
                    <employment_type>Full-time</employment_type>
                </search_result>
                <search_result>
                    <rank>6</rank>
                    <url>
https://www.glassdoor.com/job-listing/electrical-engineer-m-engineering-JV_IC1145913_KO0,19_KE20,33.htm?jl=3053024612&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic
</url>
                    <extra>HTTPS</extra>
                    <title>Electrical Engineer</title>
                    <desc>
M-Engineering is seeking dynamic Electrical Engineers to join our team in Columbus, OH. Candidates shall have MEP consulting experience. A P.E. license is preferred but not required. M-Engineering has vast opportunities for candidates with entrepreneurial spirit who seek a position in leadership and have an interest in managing and developing business. Candidates must have strong electrical design and production skills to serve as the building blocks for management and business development. Compensation shall commensurate with experience and value. We are currently seeking the following electrical engineers: Sr. Electrical Engineer/Designer 12+ years experience in Consulting Engineering for Buildings Knowledge of and proficiency in AutoCad & Revit is desired P.E. is preferred Lighting design is of strong interest Industrial design is of strong interest Utility infrastructure design is of strong interest LEED AP is preferred Mid-level Electrical Engineer/Designer 6 to 11... years experience in Consulting Engineering for Buildings Knowledge of and proficiency in AutoCad & Revit is required E.I./P.E. preferred LEED AP is preferred
</desc>
                    <company>M-ENGINEERING</company>
                    <location>Westerville, OH</location>
                    <post_time>4 days ago</post_time>
                    <employment_type>Full-time</employment_type>
                </search_result>
      
      
      <--- CONTINUES THROUGH TO THE LAST RESULT FOUND FOR THE DATE --->
        
      
                <search_result>
                    <rank>30</rank>
                    <url>
http://ball.jobs/columbus-oh/ball-metalpack-electrical-controls-project-engineer/d314efba79824a599b9dea55f880f982/job/?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic
</url>
                    <extra/>
                    <title>
Ball Metalpack - Electrical Controls Project Engineer
</title>
                    <desc>
Who We Are: Ball Metalpack is the leading supplier of sustainable metal packaging for food and household products and the largest aerosol manufacturer in North America. Previously part of Ball Corporation, we’re a newly formed company with 130 years of experience, and we’re proud to continue our legacy as an industry leader in innovative, next-generation packaging solutions. Come join our 1,300+ team members in one of our 10 locations across the U.S. heartland. Ball Metalpack is a Lean Manufacturing System environment. Job Duties: Primary Purpose of Position: Provides electrical technical support (*PLC programming & troubleshooting - Allen Bradley, Siemens*) for the project engineering function as directed. Essential Functions : • Conducts all of his/her work with communication and coordination involving appropriate engineering and plant organizations. • Consults with engineering and manufacturing personnel to assure the use of appropriate and consistent technologies. (Identify... the best PLC to utilize for the new high-speed manufacturing production lines at our Columbus, Ohio plant; complete new system programming, installation, implementation and troubleshooting). • Prepares bid packages/RFQ’s, evaluates and educates potential suppliers/contractors and evaluates bids for equipment, systems, and construction work. • Originates, investigates, and suggests improvements to electrical equipment, systems, and processes for the purpose of increased production, reduced cost, or improved maintainability. • Maintains a knowledge of technology improvements in electrical engineering, communicates their existence to the engineering and manufacturing areas, and proposes/coordinates implementation or evaluation of such innovations. • Responsible for providing technical support to plants, licensees, joint ventures, and customers. Participates hands-on in troubleshooting investigations and corrective action of electrical-related problems using hand tools and test equipment. • Responsible for preparing designs, PLC programs, bills of materials, spare parts lists, and specifications and overseeing the preparation of drawings for the installation or modification of control systems, power distribution, and lighting. • Prepares electrical check-out procedures and participates in check-out and acceptance of equipment and systems. • Participates in audits and upgrades and recommends improvements to controls and processes. • Works with outside consulting firms and vendors used in the design of control, power distribution, and support and service systems. Responsible for the review of vendor and other outside engineering drawings and documents for suitability and compliance with project requirements. • Works with on-site electrical contractors and supplies technical assistance in the installation, check-out, and start-up of control, power distribution, and support and service systems. • Prepares cost estimates for electrical control and power distribution systems. • Oversees the scope, cost, and schedule of the electrical portions of projects. • Initiates, reviews, and follows all standard operating procedures (SOPs). • Maintains a broad understanding of other engineering disciplines and of the mechanical functions of equipment used in the plants. • Assures and maintains safe and healthful working conditions while enforcing safety rules and regulations. • Maintains an awareness and complies with all environmental management requirements. Position Requirements: • Broad training in a related field usually acquired through college level education (preferably Electrical or Controls Engineering) or work-related experience • Job related experience for 2 year(s) minimum • Working knowledge of the following areas: • Ability to perform mathematical calculations. • Ability to functionally use a computer. • Design new PLC systems (Allen Bradley & Siemens), requires experience with programming the PLC ladder logic and troubleshooting. • Ability to use a computer. • Must maintain professional competence, ethical integrity, knowledge, and skills. • Must be able to handle sensitive and proprietary information in a confidential manner. • Works under general supervision. Follows established procedures. Work is reviewed for soundness of technical judgment and overall adequacy. • Demonstrates effective verbal and written communication skills. Assists with the preparation of presentations. Standard Competencies and Responsibilities – • Demonstrates Self-Awareness - uses a combination of feedback and reflection to gain productive insight into personal strengths and weaknesses • Instills Trust - gains the confidence and trust of others through honesty, integrity, and authenticity • Interpersonal Intelligence - relates openly and comfortably with diverse groups of people • Demonstrates Results - consistently achieves results, even under tough circumstances 30% of travel Relocation: Relocation for this position is NOT Available. At Ball Metalpack, we offer a comprehensive total rewards package including Competitive pay and Benefits package options that include: Medical, dental, and vision coverage, paid vacation, sick time and holidays to recreate and rejuvenate and care for the health of yourself and family, a 401(k) retirement plan with company match, a variety of company paid and voluntary insurance plans including life, personal accident and disability insurance and tuition reimbursement. EEO Statement: Ball Metalpack is proud to provide equal employment opportunity to individuals regardless of race, ethnicity, color, creed, religion, gender, age, national origin, marital status, sexual orientation, gender identity or expression, genetic information, protected disability or veteran status, or any other characteristic protected by state, federal or local law. Job Title: Ball Metalpack - Electrical Controls Project Engineer Job ID: 665010 Location: OH - Columbus Full/Part Time: Full-Time Regular/Temporary: Regular
</desc>
                    <company>Ball Corporation / Ball Aerospace</company>
                    <location>Columbus, OH</location>
                    <post_time>Over 1 month ago</post_time>
                    <employment_type>Full-time</employment_type>
                </search_result>
            </search_results>
        </result>
    </results>
</tracking-data>

How to Obtain API Access

If you'd like to help determining which of our API plans is most appropriate for your needs, contact our service team and an account manager will be happy to assist you.

If you already have a Rank Ranger plan and see an error message when accessing the Account Settings > API & Connected Apps screen, then to obtain API access you will need to upgrade to a package that includes API access by completing a custom package request form or contacting Rank Ranger support with your requirements.

If your company has API services included in a plan and you aren't able to access the screen, contact your company's Rank Ranger account administrator to request that your user permissions be set to include access to the Account Settings > API & Connected Apps screen.

How to Generate New API Keys

You can obtain API Keys per user if your Rank Ranger account has API access by navigating to
1. Campaigns
2. API Resources
3. API Key Generator
4. Click the Generate Key button
5. Select a User and add a note (optional)
6. Click the Add button

API Console: Construct & Test API Requests

To make construction of API requests easy, we offer this API testing tool. Most parameters are included in the options of the console, however, you may need to add custom option parameters to your API requests based on the specific API you're using. Referencing the parameters information that is listed in the specific API method documentation, you can construct and test API requests in Rank Ranger's API Console by navigating to:

1. Campaigns
2. API Resources > API Console
3. Select the Method and complete the applicable fields
4. Click the Generate button
5. Test your API method by clicking the launch URL icon and view your results. Once your results are as you want them, copy that URL into your own application and modify as needed for each request.

Getting Started: Samples of APIs used for Creating Campaigns

We recommend reviewing our Best Practices Guide prior to structuring campaigns.

Get Packages Info: Required when there is more than 1 package in an account
https://www.rankranger.com/api/v2/?packages&key=YOURAPIKEY

Add a Profile: An option for adding an identifier to your campaigns for categorization (e.g., by language, country, etc)
https://www.rankranger.com/api/v2/?add_profile&key=YOURAPIKEY&profile_name=Profile Name&profile_ref_id=YourInternalReferenceID

Get Profile ID list: Optional Data needed for Add a Campaign
https://www.rankranger.com/api/v2/?get_all_profiles&key=YOURAPIKEY

Obtain the Search Engine List: Data needed for Add a Campaign
https://www.rankranger.com/api/v2/?se_list&key=YOURAPIKEY

Add a Campaign: Create a new campaign, response will include the Campaign ID number that is needed for adding a search engine and keywords
https://www.rankranger.com/api/v2/?add_campaign&key=YOURAPIKEY&campaign_name=yourcampaignname&campaign_domain=example.com&campaign_ranking_system
=default&profile_id=ProfileIDnumber

*Note that Profile ID is an optional field that you may use, if you choose not to use it, then please remove "&profile_id=ProfileIDnumber” from the end of this call

Add a Search Engine: Add search engine to a campaign
https://www.rankranger.com/api/v2/?add_search_engine&key=YOURAPIKEY&campaign_id=123456&se_id=se_id

Add a Keyword: An optional field is available for keyword_identifier field, allowing you to add your own unique identifier to each keyword
https://www.rankranger.com/api/v2/?add_keyword&key=YOURAPIKEY&campaign_id=123456 &keyword=yourkeyword&keyword_identifier=your-keyword-identifier

Bulk Add Keywords: You may download and use the spreadsheet found on the Campaign Settings > Keywords screen to organize and import your keywords, or use this API
https://www.rankranger.com/api/v2/?add_bulk_keywords&key=YOURAPIKEY&campaign_id=123456&keywords=keyword1,keyword2,keyword3

You'll find additional API methods in the Account Management and Data documentation

API Query Limits

Rank Ranger APIs can pull up to 100 queries per minute. If more than 10,000 API GET requests per hour is required, then there is an option available at an additional throughput fee, contact customer service for assistance.

Rank Reporting Method Limits

Rank Data & Research Reporting API methods can only provide data from campaigns tracking in your Rank Ranger account.
You can run an unlimited number of queries through the API.

Research API Methods

The variety of Research Method APIs have limits on the number of queries per day based on the capacity of your package. If you require additional units, please contact customer service and an account manager will provide you with package upgrade pricing.

Search API Method Limits

SEO Intelligence API method query limits are based on the number of units purchased for your custom plan (e.g., 1 unit = 1 keyword tracked on 1 search engine, 1 time).
Search API plans do not include access to the reporting platform.

Developer API Methods

Account Management

Getting Started with Rank Ranger Developer APIs
Campaign APIs: Add Campaign, Update Campaign, Archive Campaign, Delete Campaign
Search Engine APIs: get Search Engine List, Add Search Engine, Update Search Engine, Delete Search Engine
Keyword APIs: Add Keyword, Bulk Add Keywords, Delete Keyword, Bulk Delete Keywords
Competitor URL APIs: Add Competitor URL, Delete Competitor URLs
Brand URLs: Add and Delete
Add Profile API
Add Link API
Client Dashboard Public Access API
Marketing Dashboard Public Access API

Account Data

Reporting API

Rank Data Methods

Research Methods

Search API

SEO Intelligence Methods

These are stand-alone packages that do not include use of reports, graphs or analysis tools in the Rank Ranger platform.

API FAQs

API Error Codes

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