Synupv1
Create a key
v1Resources/SEO/getGet businesses ranked at one grid point

Get businesses ranked at one grid point

Returns the local-search results captured at a single grid cell for one keyword, in rank order.

get/api/v1/seo/grid-point
seo:read
Query parameters
locationIdstringrequired
The location to look up.
keywordIdstringrequired
The tracked keyword whose grid this point belongs to.
rowintegerrequired
Grid row index of the point.
colintegerrequired
Grid column index of the point.
clientIdstringoptional
The location's client.
monthstringoptional
Pin the result to this month (YYYY-MM) instead of the keyword's latest measured report.
Response
dataobjectoptional
countnumberoptional
Number of businesses returned.
businessesarray of objectoptional
Businesses ranked at this grid point, in rank order.
idstringoptional
An identifier for this business (its place ID, name, or list position).
ranknumberoptional
This business's rank at this grid point (1 = top).
namestringoptional
Business name.
photoUrlstringoptional
Photo URL, or null (not returned by the local-search data source).
ratingnumberoptional
Star rating, or null.
reviewCountnumberoptional
Number of reviews, or null.
categorystringoptional
Business category, or null.
addressstringoptional
Street address, or null.
websitestringoptional
Business website, or null (not returned by the local-search data source).
isYoubooleanoptional
Whether this row is your own business.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
429Too many requests. Retry after the number of seconds in the Retry-After header.
get/api/v1/seo/grid-point
Your API key
locationId *
keywordId *
row *
col *
clientId
month
{
  "data": {
    "count": 1,
    "businesses": [
      {
        "id": "cm_biz_1",
        "rank": 3,
        "name": "Acme Dental — Downtown",
        "photoUrl": null,
        "rating": 4.6,
        "reviewCount": 210,
        "category": "Dentist",
        "address": "123 Main St, Austin, TX 78701",
        "website": null,
        "isYou": true
      }
    ]
  }
}