Skip to main content

JSON Response Format

Below is an explanation of the format and tags contained in our JSON response.

{
	"response": { 
		// output is wrapped in a single response.
		"status":"OK", 
		// Request status, OK or ERROR AND MESSAGE.
		// Example: if your daily limit is reached, ERROR: Daily Limit Reached.
		"head":{
			// Start of general details related to the search query.
			"query":"mojeek", 
			// Full search query string.
			"nword":1, 
			// Number of words in query which also relates to the number of word tags that follow.
			["words": 
			// Start of details on each word in the query.
				{ // Start of details on first word in the query.
					"full":"mojeek", 
					// Original version of word used in the search.
					"stem":"mojeek", 
					// Stemmed version of word used in the search.
					"plus":1, 
					// Set to 1 if word was used, 0 if minus or stop word.
					"hits":112207 
					// Exact amount of documents indexed for this word.
				}
				// End of word.
				{
					... 
					// Repeated for all words
				}
			], 
			// End of details on each word in the query.
			"timer":0.61,
			// Time in seconds search took to complete.
			"start":1,
			// First result equals start + 1, ie. 1st result equals 0, 11th result equals 10.
			"return":10,
			// Number of results returned.
			"exact":true,
			// 1 if results count is exact or 0 if about.
			"results":112094,
			// Total result count.
			"rankm":169,
			// Ranking method used.
			"dups":0,
			// True if duplicate listings have been removed.
			"more|excluded":47315
			// The number of documents that will not be returned in the results due to site clustering, restricting results by domain when performing a site search, or when filtering by categories (OrgSearch users only).
		}, // End of head.
		"cats_ref":{
			 // Start of cats_ref tag if popular categories to refine this search by were found.
			"category1":100,
			// category name:count
			... // Repeated for all cats_refs.
		}, // End of cats_ref.
		"cats_other":{
			 // Start of cats_other tag if other categories related to this search by were found.
			"category1":100,
			// category name:count
			... // Repeated for all cats_others.
		}, // End of cats_other.
		"facet_dates":
		// Start of facet_dates tag if faceted search performed (OrgSearch users only).
			"2020-07-01T00:00:00Z":100,
			// date(UTC):count
			... // Repeated for all facet_dates.
		}, // End of facet_dates.
		"results":[ // Start of results.
			{ // Start of individual result.
				"url":"https://www.mojeek.com/",
				// Document URL.
				"title":"Mojeek",
				// Document title.
				"desc":"Search Settings Site Search Boxes Add Mojeek to your browser Go to Mojeek UK Independent and unbiased search results with no user tracking. Learn More .",
				// Document description.
				"size":"1kb",
				// Document size.
				"timestamp":1184044740,
				// Date last modified timestamp.
				"date":"Tue Jul 10 05:19:00 2007",
				// Date last modified formatted.
				"pdate":1184044740,
				// Date published timestamp.
				"cdatetimestamp":1184044740,
				// Date crawled timestamp.
				"cdate":"Tue Jul 10 05:19:00 2007",
				// Date crawled formatted.
				"mres":1,
				// If set to 1 more results are available from this domain but have been excluded due to domain clustering.
				"cats":"cat1|cat2|cat3",
				// Pipe-separated list of categories that the result is tagged with. Note: only appears for OrgSearch users.
				"image" :{
					// Start of image tag.
					"url":"https://example.com",
					"width":100,
					// Width in pixels.
					"height":100
					// Height in pixels.
				} // End of image.
			},
			{
				... // Repeated for all results.
			}
		] // End of results.
	} // End of response.
}