ZoomRank Vendor API

Retrieve Result (Details)

URL

http://vendor.zoomrank.com/accounts/:account_id/keywords/:keyword_id/results/:id.json

Supported formats

JSON

Supported request methods

GET

Example

Retrieve details for result ID 1 belonging to keyword ID 1 and account ID 2

http://vendor.zoomrank.com/accounts/2/keywords/1/results/1.json

General Arguments

None

Filter Arguments

None

Response Codes

200 - Success
404 - No records found
500 - Unexpected error. Try again.

Example Response

Truncated Examples

Click on the links below to show JSON results truncated to include only a single example result.

Single Organic Result

A simple organic result

{
	account_id: 1,
	keyword_id: 1,
	external_id: "myuniqueid",
	engine_id: 1,
	mobile: false,
	term: "zoomrank",
	country: "US",
	language: "EN",
	location: "Dallas,TX",
	date: "2017-02-15",
	number_of_results: 765000000,
	serps: [
		{
			type: "organic",
			href: "http://zoomrank.com/",
			domain: "zoomrank.com",
			title: "ZoomRank",
			description: "SEO ranking tools from the enterprise leader.",
			page: 1
		}
	]
}
      
Download JSON file

Single Local Result

A single local result

{
	account_id: 1,
	keyword_id: 1,
	external_id: "myuniqueid",
	engine_id: 1,
	mobile: false,
	term: "star chevrolet frisco",
	country: "US",
	language: "EN",
	location: "Frisco,TX",
	date: "2017-02-15",
	number_of_results: 406000,
	serps: [
		{
			title: "Star Chevrolet",
			type: "local",
			address: "51232 Main St, Frisco, TX 75034",
			google_rating: 4.6,
			google_reviews: 93,
			website: "http://www.starchevydealer.com/",
			page: 1
		}
	]
}
      
Download JSON file

Local Pack Result

Local pack results

{
	account_id: 1,
	keyword_id: 1,
	external_id: null,
	engine_id: 1,
	mobile: false,
	term: "pizza",
	country: "US",
	language: "EN",
	location: "Dallas,TX",
	date: "2017-02-15",
	number_of_results: 765000000,
	serps: [
		{
			pack: true,
			type: "local",
			page: 1,
			items: [
				{
					href: null,
					domain: null,
					displayed_url: null,
					title: "Papa John's Pizza",
					cid: "10034270637841359996",
					number_of_reviews: 24,
					rating: 3.3
				},
				{
					href: null,
					domain: null,
					displayed_url: null,
					title: "Pizza Hut",
					cid: "16309351045596109619",
					number_of_reviews: 50,
					rating: 2.9
				},
				{
					href: null,
					domain: null,
					displayed_url: null,
					title: "Serious Pizza",
					cid: "3896093503307055287",
					number_of_reviews: 433,
					rating: 4.1
				}
			]
		}
	]			
}
      
Download JSON file

Indented Results

Indented/sub-page organic results

{
	account_id: 1,
	keyword_id: 1,
	external_id: "myuniqueid",
	engine_id: 1,
	mobile: false,
	term: "star chevrolet frisco",
	country: "US",
	language: "EN",
	location: "Frisco,TX",
	date: "2017-02-15",
	number_of_results: 26400,
	serps: [
		{
			type: "organic",
			href: "http://www.starchevydealer.com/",
			domain: "starchevydealer.com",
			displayed_url: "www.starchevydealer.com/",
			title: "Star Chevrolet in Frisco, TX Serving Plano Chevrolet Customers",
			description: "Star Chevrolet in Frisco, TX covers all your new and used car, truck, or SUV needs. Frisco Chevrolet drivers can find online financing options, quick quotes ...",
			indented_results: [
				{
					href: "http://www.starchevydealer.com/VehicleSearchResults?search=preowned",
					title: "Pre-Owned Used Cars",
					description: null
				},
				{
					href: "http://www.starchevydealer.com/Service",
					title: "Certified Service",
					description: null
				},
				{
					href: "http://www.starchevydealer.com/VehicleSearchResults?search=new",
					title: "Diesel",
					description: null
				},
				{
					href: "http://www.starchevydealer.com/ServiceApptForm",
					title: "Schedule Service",
					description: null
				},
				{
					href: "http://www.starchevydealer.com/dealership-staff",
					title: "Meet our Staff",
					description: null
				},
				{
					href: "http://www.starchevydealer.com/ContactUsForm",
					title: "Email",
					description: null
				}
			],
			page: 1
		}
	]
}
      
Download JSON file

Video Result

A single video result

{
	account_id: 1,
	keyword_id: 1,
	external_id: null,
	engine_id: 1,
	mobile: false,
	term: "conor mcgregor interviews",
	country: "US",
	language: "EN",
	location: "Dallas,TX",
	date: "2017-02-15",
	number_of_results: 554000,
	serps: [
		{
			type: "video",
			href: "https://www.youtube.com/watch?v=C27_IQZWn34",
			domain: "youtube.com",
			displayed_url: "https://www.youtube.com/watch?v=C27_IQZWn34",
			title: "UFC 205: Conor McGregor Backstage Interview - YouTube",
			description: "Megan Olivi catches up with Conor McGregor after becoming the first man to hold two belts in UFC history at ...",
			page: 1
		}
	]
}
      
Download JSON file

News Pack Result

Pack of 3 news results including an image

{
	account_id: 1,
	keyword_id: 1,
	external_id: null,
	engine_id: 1,
	mobile: false,
	term: "steve jobs",
	country: "US",
	language: "EN",
	location: "Dallas,TX",
	date: "2017-02-15",
	serps: [
		{
			pack: true,
			type: "news",
			items: [
				{
					href: "http://www.usatoday.com/story/money/columnist/strauss/2017/02/14/keep-plugging-entrepreneurs-guy-named-steve-jobs-failed-too/97892326/",
					domain: "usatoday.com",
					title: "Keep plugging, entrepreneurs: A guy named Steve Jobs failed, too",
					source: "USA Today",
					age: "1 day ago"
				},
				{
					href: "https://skift.com/2017/02/14/how-airbnb-turned-steve-jobs-three-click-rule-into-design-brilliance/",
					domain: "skift.com",
					title: "How Airbnb Turned Steve Jobs’ Three-Click Rule Into Design Brilliance",
					source: "Skift",
					age: "2 hours ago"
				},
				{
					href: "https://www.macrumors.com/2017/02/13/apple-cybercafe-project-1997/",
					domain: "macrumors.com",
					title: "Apple Almost Built a Futuristic Cybercafe in 1997 With Computers at Every Table",
					source: "Mac Rumors",
					age: "7 hours ago"
				}
			],
			page: 1
		}
	]
}
      
Download JSON file

Action Block Result with URL

An action block containing a URL

{
	account_id: 1,
	keyword_id: 37,
	external_id: null,
	engine_id: 1,
	mobile: false,
	term: "toyota recalls canada",
	country: "CA",
	language: "EN",
	location: "Toronto",
	date: "2017-02-15",
	number_of_results: 615000,
	serps: [
		{
		type: "ab",
		href: "https://www.auto123.com/en/recalls/details/toyota/",
		domain: "auto123.com",
		displayed_url: "https://www.auto123.com/en/recalls/details/toyota/",
		page: 1
		}
	]
}
      
Download JSON file

Action Block Result without URL

An action block that does not contain a URL or other parseable contents

{
	account_id: 1,
	keyword_id: 27,
	external_id: null,
	engine_id: 1,
	mobile: false,
	term: "Star Chevrolet Hours",
	country: "US",
	language: "EN",
	location: "Dallas,TX",
	date: "2017-02-15",
	serp: [
		{
			type: "ab",
			href: null,
			domain: null,
			displayed_url: null,
			page: 1
		}		
	]
}
      
Download JSON file

Image Pack Result
A pack of image results
```
      
Download JSON file
```

Knowledge Graph

Example of a knowledge graph result

{
	account_id: 1,
	keyword_id: 1,
	external_id: null,
	engine_id: 1,
	mobile: false,
	term: "golden globes",
	country: "US",
	language: "EN",
	location: "Dallas,TX",
	date: "2017-02-15",		
	number_of_results: 36100000,
	serps: [
		{
			title: "Golden Globe Award",
			type: "knowledge_graph",
			items: [
				"Golden Globe Awards are accolades bestowed by the 93 members of the Hollywood Foreign Press Association, recognizing excellence in film and television, both domestic and foreign. Wikipedia",
				"Ceremony date: January 8, 2017, 5:00 PM PST",
				"Currently held by: Tracee Ellis Ross",
				"Country: United States of America",
				"Network: NBC"
			],
			page: 1
		}
	]
}
      
Download JSON file

Complete Examples

Click on these links for the complete results that the above examples were taken from

Vendor API

Retrieve Result (Details)

URL

Supported formats

Supported request methods

Example

General Arguments

Filter Arguments

Response Codes

Example Response

Truncated Examples

Complete Examples

Quick Links

Overview

Accounts

Keywords

Batch

Results