How does the JSON output and object table of Brightlocal Google ranking API work?
In this article, I will clarify the object table and JSON output of BrightLocal's Google Ranking API. As a reader with programming knowledge, you may already be familiar with the concept of an object table and JSON output. However, specific implementation details may vary depending on the API provider. Therefore, I will focus solely on BrightLocal's implementation of these concepts, providing clear explanations and examples to help you better understand how to interpret the data returned by their API. By the end of this article, you should have a deeper understanding of the object table and JSON output of BrightLocal's Google Ranking API.
Object Table
| Object | Description |
| Car | A vehicle with four wheels and an engine designed for transportation on roads |
| Bicycle | A human-powered vehicle with two wheels and pedals, commonly used for transportation or exercise |
| Airplane | A vehicle with wings and engines that allows for flight in the air |
| Boat | A vehicle designed for travel on water, either with sails or an engine |
| Train | A series of connected vehicles that run on tracks, often used for transportation of passengers or cargo |
| Helicopter | A vehicle that can hover in the air and fly in any direction using rotors and an engine |
| Bus | A large vehicle used for transporting passengers, typically on a fixed route with multiple stops |
| Motorcycle | A motorized vehicle with two wheels that is driven by an engine |
| Truck | A large motor vehicle used for transporting goods or materials, typically with a separate cab and trailer |
| Scooter | A small motorized vehicle with two wheels, a platform for the feet, and handlebars for steering |
success: A Boolean value indicating whether the request was successful or not.results: An array of objects containing information about the search engine results for a particular query.SearchRankV2Api: The root object containing all of the search engine result information.identifier: A unique identifier for the search engine results, typically a timestamp or other unique identifier.site: The name or URL of the website being searched.site-url: The URL of the website being searched.search-url: The URL of the search engine query.search-term: The search term used in the search engine query.url: The URL of the search result.orig_url: The original URL of the search result.title: The title of the search result.ludocid: A unique identifier for the search result.rank: The rank of the search result on the search engine results page.sub_rank: The sub-rank of the search result, if applicable.page: The page number of the search engine results page.type: The type of search result, such as an organic listing, local pack listing, or featured snippet.match: Whether the search result matches the search query exactly or partially.website address: The address of the website being searched.etc: Any additional information about the search result, as provided by the API.
The information in the table provides a detailed overview of the objects and properties that are available through the BrightLocal Google Ranking API. Understanding this information is essential for developers who wish to integrate the API into their applications or build custom reports using the data provided. By knowing what objects and properties are available, developers can make more informed decisions about how to structure their queries and what information to include in their reports. This, in turn, can help businesses gain valuable insights into their online presence and improve their search engine rankings. Additionally, having a clear understanding of the available objects and properties can make it easier to troubleshoot issues or errors that may arise when working with the API. Overall, the information in the table is essential for anyone who wants to use the BrightLocal Google Ranking API to gather insights into their search engine rankings and improve their online presence.
JSON REST output
This is a JSON output with a hierarchical structure that contains the search results for the search query "Back Pain midtown manhattan" and "apos therapy new york". The output includes two top-level keys, "success" and "results." The "success" key indicates whether the search was successful or not, and its value is set to "true." The "results" key contains an array of objects that correspond to the search engines used in the search, in this case, Google. Each object contains various details, such as the search term, site URL, search URL, result types, results, and payload, among others. The "payload" key contains additional information about the search, such as queue-attempts, search engine, search options, and position, among others. The "results" key has an array of objects, each corresponding to a search result, with information about the search result such as the URL, the rank, the type, and the matched URL, among others. The output also includes an array of serp-screenshots URLs, which correspond to the screenshots of the search engine results page.
{
"success": true,
"results": {
"SearchRankV2Api": [
{
"results": [
{
"identifier": "google",
"site": "Google Search",
"site-url": "http://www.google.com",
"search-url": "https://www.google.com/search?q=Back+Pain+midtown+manhattan&gl=us&gws_rd=cr&pws=0",
"search-term": "Back Pain midtown manhattan",
"results": [
{
"url": "http://thecenternyc.com/tag/back-pain/",
"orig_url": "http://www.thecenternyc.com/tag/back-pain/",
"title": "Back Pain Archives >> New York, NY 10001",
"ludocid": "",
"rank": 13,
"sub_rank": null,
"page": 2,
"type": "Organic",
"match": [
"website address"
],
"matched_url": "www.thecenternyc.com",
"serp-screenshot-url": "https://seo-serp-screenshots.s3.amazonaws.com/2016/10/14/14/6daa949323ef54687f41d95500751fd08256bc17.png"
},
{
"url": "http://thecenternyc.com/back-pain-nyc/",
"orig_url": "http://www.thecenternyc.com/back-pain-nyc/",
"title": "Back Pain NYC Archives >> The Center Chiropractic & PT NYC",
"ludocid": "",
"rank": 14,
"sub_rank": null,
"page": 2,
"type": "Organic",
"match": [
"website address"
],
"matched_url": "www.thecenternyc.com",
"serp-screenshot-url": "https://seo-serp-screenshots.s3.amazonaws.com/2016/10/14/14/6daa949323ef54687f41d95500751fd08256bc17.png"
}
],
"result-types": [
"Organic",
"Places",
"Carousel",
"Directory",
"Secondary"
],
"http-error": false,
"error-type": "None",
"serp-screenshots": [
"https://seo-serp-screenshots.s3.amazonaws.com/2016/10/14/14/6b3c2ea8060ad5d564bbbfb84e1dc877e401d7ab.png",
"seo-serp-screenshots.s3.amazonaws.com/2016/..",
"seo-serp-screenshots.s3.amazonaws.com/2016/..",
"seo-serp-screenshots.s3.amazonaws.com/2016/..",
"seo-serp-screenshots.s3.amazonaws.com/2016/.."
]
}
],
"payload": {
"queue-attempts": 1,
"http-codes": [
0
],
"source": 3,
"api-key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"search-engine": "google",
"options": {
"urls": [
"www.thecenternyc.com"
],
"business-names": [
"The center for chiropractic & pt",
"the center for chiropractic decomperssion"
],
"search-term": "Back Pain midtown manhattan",
"postcode": "10001",
"telephone": "646-606-2580",
"country": "USA",
"google-location": "",
"bing-location": "",
"include-name-only-matches": true,
"num-search-pages": 5,
"debug": false,
"listings": false,
"screenshots-enabled": true,
"include-intermediate-html": false,
"append-location": false
},
"position": 0
},
"status": "Completed",
"job-id": 564270998
},
{
"results": [
{
"identifier": "google",
"site": "Google Search",
"site-url": "http://www.google.com",
"search-url": "https://www.google.com/search?q=apos+therapy+new+york&gl=us&gws_rd=cr&pws=0",
"search-term": "apos therapy new york",
"results": [
{
"url": "http://thecenternyc.com/apostherapy/",
"orig_url": "http://www.thecenternyc.com/apostherapy/",
"title": "Apostherapy NYC - Chiropractor NYC",
"ludocid": "",
"rank": 18,
"sub_rank": null,
"page": 2,
"type": "Organic",
"match": [
"website address"
],
"matched_url": "www.thecenternyc.com",
"serp-screenshot-url": "https://seo-serp-screenshots.s3.amazonaws.com/2016/10/14/14/9fce8698cbbfb59eeb4237dbb337c35e73fca0fa.png"
}
],
"result-types": [
"Organic",
"Places",
"Carousel",
"Directory",
"Secondary"
],
"http-error": false,
"error-type": "None",
"serp-screenshots": [
"https://seo-serp-screenshots.s3.amazonaws.com/2016/10/14/14/98aa8a19a602cefdb4d1ee0c2d220bf651b8d5cc.png",
"seo-serp-screenshots.s3.amazonaws.com/2016/..",
"seo-serp-screenshots.s3.amazonaws.com/2016/..",
"seo-serp-screenshots.s3.amazonaws.com/2016/..",
"seo-serp-screenshots.s3.amazonaws.com/2016/.."
]
}
],
"payload": {
"queue-attempts": 1,
"http-codes": [
0
],
"source": 3,
"api-key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"search-engine": "google",
"options": {
"urls": [
"www.thecenternyc.com"
],
"business-names": [
"The center for chiropractic & pt",
"the center for chiropractic decomperssion"
],
"search-term": "apos therapy new york",
"postcode": "10001",
"telephone": "646-606-2580",
"country": "USA",
"google-location": "",
"bing-location": "",
"include-name-only-matches": true,
"num-search-pages": 5,
"debug": false,
"listings": false,
"screenshots-enabled": true,
"include-intermediate-html": false,
"append-location": false
},
"position": 0
},
"status": "Completed",
"job-id": 564270999
}
]
},
"statuses": {
"Completed": 4
},
"status": "Finished"
}
Conclusion
In this article today, we discussed various topics ranging from computer hardware to programming languages, and web development. We also looked at the basics of JSON and how to interpret JSON data. Additionally, we talked about machine learning and AI, including different types of models, their applications, and ethical considerations. Overall, this conversation provided a broad overview of several aspects of technology and computer science.
Footnote
The Brightlocal Google ranking API is a service that provides users with access to Google search rankings data for specific keywords and locations. In order to access this API, it is possible to request access to the API through a third-party data marketplace called Worldindata.
Worldindata is a platform that connects data providers (like Brightlocal) with potential data consumers. By using Worldindata, users can access a wide range of data sources from multiple providers, including the Brightlocal Google ranking API. This means that if you're interested in using the Brightlocal API, you can request access to it through Worldindata instead of subscribing directly to Brightlocal.
Overall, using Worldindata to access the Brightlocal API can be a convenient and cost-effective option for businesses or individuals who need access to Google search ranking data for their projects or analyses.