visibility
GET /v1/visibility/targets/{targetId}/local
One business's local set-up, every row's positions and their trend.
Аутентификација
Пошаљите API кључ као bearer токен. Ова крајња тачка не наводи конкретну дозволу у спецификацији, па свом кључу доделите најмања неопходна овлашћења и проверите одговор уместо да претпостављате.
Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X GET https://api.zinndigital.com/v1/visibility/targets/{targetId}/local \
-H "Authorization: Bearer zdk_live_…"Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
A row is one keyword searched from one town. Each carries its latest reading — the map position (of up to 100 listings read), the local 3-pack position on the results page and the website's organic position — the change since the previous reading, the businesses above it on the map, and up to twelve readings of trend. null positions mean "we looked and the business was not there", never zero; a row with latest: null has not been checked yet, and pending: true means its answer has been paid for and is on its way.
Параметри
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
targetId (path) | Uuid | Да | The watched domain's id. |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
target_id | string | Да | — |
domain | string | Да | — |
label | string | Да | — |
business | LocalBusiness | null | Да | — |
places | LocalPlace[] | Да | — |
keywords | LocalKeyword[] | Да | — |
rows | LocalRow[] | Да | — |
last_checked_at | object | Да | — |
Грешке које ова крајња тачка може вратити
401 · 404 · 422