How do the Object and Description table and JSON Output of Brightlocal bulk google ranking API function?

In this article, I will clarify the object table and JSON output of the Brightlocal Bulk Google Ranking API. As a programmer, you are likely familiar with the concept of an object table, which is a data structure that represents information in a tabular format. Similarly, you are also likely familiar with JSON (JavaScript Object Notation), a lightweight data interchange format that is widely used in web programming. In the context of the Brightlocal Bulk Google Ranking API, understanding the object table and JSON output is crucial for effectively extracting and analyzing ranking data from Google search results.

Object and description table

• success: A boolean value that indicates whether the API call was successful or not.

• results: A collection of search results.

• SearchRankV2Api: The API object that was used to perform the search.

• identifier: An identifier for the search query.

• site: The website that was searched for.

• site-url: The URL of the website that was searched for.

• search-url: The URL of the search engine that was used for the search.

• search-term: The search term or keyword that was used for the search.

• 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 (SERP).

• sub_rank: The sub-rank of the search result (e.g., the position of the result within a featured snippet).

• page: The page number of the SERP that the search result appears on.

• type: The type of search result (e.g., organic, paid, local pack, etc.).

• match: Whether the search result matches the search query exactly or is a partial match.

• website address: The address of the website associated with the search result.

• etc: Other data or information that is not specified in the table.

Json output

This is a JSON output that contains the search results for two different queries from the Google Search API. The JSON output is structured into different key-value pairs where the first key is "success" and its value is true, which indicates that the API request was successful. The second key is "results" and its value is an array of objects. Each object in the array contains the search results for a specific query. For each query, there is a "payload" key which contains the query parameters and other metadata. Additionally, there is a "results" key that contains an array of objects for each search result. Each search result object contains information such as the URL, title, and rank of the result, as well as other metadata such as the search term, site URL, and search engine used. Finally, there is a "serp-screenshots" key which contains an array of URLs that link to screenshots of the search engine results pages.

{
"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"
}

In summary

Toady, we discussed various topics related to web development, software engineering, and computer science. We talked about different programming languages, frameworks, and tools used in the field of web development. We also touched upon various topics such as databases, APIs, and JSON. Overall, this conversation provides a glimpse into the vast and ever-evolving field of computer science and the various technologies used to build modern web applications.

Reference

BrightLocal provides access to its bulk Google ranking API through World In Data, a third-party data marketplace. By accessing the API through World In Data, you can benefit from the additional features and data that the marketplace offers. Simply create an account on World In Data's website, find the BrightLocal API, and submit a request for access. From there, you can start using the API to analyze Google search rankings in bulk and gain valuable insights into your SEO performance.