Syndai Docs

Check a listing again

POST
/api/v1/external/coding/customers/{customer_id}/seo/sites/{site_id}/listings/{key}/check

google_business (a local site): reads Google's public profile of the business: claimed, permanently closed, rating and review count, and up to 3 fixes where it disagrees with the site, at most once per 24 hours. A checkable place: reads the owner's listing page and reports whether it links to the site, whether the link is followed and whether the page can be indexed, at most once per 10 minutes. A second press inside the window returns the stored result. Syndai pays; nothing is charged. A place with no address is 422 listing_url_missing (nothing fetched); a read that gets no answer is 502 listing_check_failed (the stored check is kept). Returns the Listings section. A key the site can't check is 404. Needs coding:apps:publish; a portal member who is not an owner or admin is 403.

Authorization

CustomerApiKey
headerAuthorizationBearer <API Key>

Customer API key sent as a bearer token

Path Parameters

customer_id*string
Formatuuid
site_id*string
Formatuuid
key*string

Response Body

Request fulfilled, document follows

application/json
  1. response
facts?|null
google?|null
kind?string|null
kit?|null
places*array<>
profiles*array<>
review_link?string|null
sample_gate?|null
Example Request
curl -X POST 'https://api.syndai.ai/api/v1/external/coding/customers/497f6eca-6276-4993-bfeb-53cbbbba6f08/seo/sites/497f6eca-6276-4993-bfeb-53cbbbba6f08/listings/string/check'
Example Response
{  "facts": {    "address": "string",    "hours": "string",    "missing": [      "string"    ],    "name": "string",    "phone": "string",    "website": "string"  },  "google": {    "checked_at": "string",    "fixes": [      "string"    ],    "rating": 0,    "review_link": "string",    "reviews": 0,    "status": "string"  },  "kind": "string",  "kit": {    "description": "string",    "name": "string",    "one_liner": "string",    "tagline": "string",    "tags": [      "string"    ],    "website": "string"  },  "places": [    {      "aggregator": true,      "blurb": "string",      "can_fill": true,      "catch": "string",      "check": {        "anchor": "string",        "checked_at": "string",        "code": 0,        "indexable": true,        "rel": [          "string"        ],        "state": "string",        "target_host": "string",        "url": "string"      },      "checkable": true,      "group": "string",      "key": "string",      "name": "string",      "paid_upgrade": true,      "state": "string",      "submit_url": "string",      "visitors_30d": 0    }  ],  "profiles": [    {      "key": "string",      "name": "string",      "on_site": true,      "shape_hint": "string",      "url": "string"    }  ],  "review_link": "string",  "sample_gate": {    "facts": [      "string"    ],    "repository_id": "string"  }}
Was this page helpful?