visibility
PUT /v1/visibility/targets/{targetId}/review-profiles
Confirm which review profiles belong to this business.
Ìfàṣẹ́pọ̀
Fi bọ́kì kọ́kọ́ (bearer token) ránṣẹ́ gẹ́gẹ́ bí àmì ìdánimọ̀ API. Ibùdó yìí kò sọ àṣẹ pàtó kan nínú àlàyé rẹ̀, nítorí náà fún kọ́kọ́ rẹ̀ ní ohun tó kéré jù lọ tí ó nílò kí o sì ṣàyẹ̀wò ìdáhùn náà dípò kí o kàn rò ó.
Ojú abánisọ̀rọ̀ yìí kò gba id ajọ kankan. Kọ́kọ́rọ́ rẹ ti mọ ajọ ti o jẹ ti e, a o si fèsì nipa rẹ̀.
Gbiyanju rẹ
Rọ́pọ̀ èyíkéyìí nínú àwọn àmì ìtọ́ka < > pẹ̀lú iye tirẹ̀, àti àmì ìdánimọ̀ bọ́tìnnì náà pẹ̀lú bọ́tìnnì kan láti inú dásibọ̀ọ̀dù rẹ.
curl -X PUT https://api.zinndigital.com/v1/visibility/targets/{targetId}/review-profiles \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "profiles": <ReviewProfile[]> }'Ṣé o ti wọlé? Iwọ̀n api ní nú ìgbékalẹ̀ rẹ kún id àjọ gidi rẹ ati bọtini tirẹ, o si nṣiṣẹ ibeere na lòdì si api gidi ki o le rii esi gidi na. Ṣí ojú abáná yìí sílẹ̀ nínú kọnsólù API
Àwọn kúlẹ̀kúlẹ̀
A business is identified by a `place_id` at Google, a domain at Trustpilot and a `url_path` at Tripadvisor, and a search for a common trading name legitimately returns several records. The **customer confirms** which are theirs and the confirmed set is what the weekly reputation check refreshes. Nothing picks a profile automatically. Doing so would, for every chain and every shared trading name, report a stranger's reviews on a paying customer's dashboard.
Àwọn ìpìlẹ̀
| Orúkọ | Iru | Tí a nílò | Kini o jẹ |
|---|---|---|---|
targetId (path) | Uuid | Bẹẹni | The watched domain's id. |
Akoonu ibeere naa
| Orúkọ | Iru | Tí a nílò | Kini o jẹ |
|---|---|---|---|
profiles | ReviewProfile[] | Bẹẹni | — |
Idahun
| Orúkọ | Iru | Tí a nílò | Kini o jẹ |
|---|---|---|---|
id | Uuid | Bẹẹni | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
domain | string | Bẹẹni | The hostname |
label | string | Bẹẹkọ | The customer's own label for this domain. |
brand | string | Bẹẹkọ | The trading name to look for in an answer engine's reply. Genuinely separate from the domain — an answer that recommends a business by name without printing its URL has still me… |
category | string | Bẹẹkọ | What this business sells, in the customer's own words. The questions asked of the answer engines are built from it, so it is the single field that decides whether an AI-visibili… |
market | string | Bẹẹkọ | Where the business sells. Used with `category` to build the questions. |
is_external | boolean | Bẹẹni | True when this is not a domain hosted with us — a competitor or a prospect. Only external targets count against the plan's allowance. |
site_id | string | Bẹẹkọ | The site this target corresponds to, when it is one of ours. |
kinds | VisibilityAuditKind[] | Bẹẹni | — |
cadence_days | integer | Bẹẹni | Days between scheduled audits. `0` means paused — **not** deleted. History and settings survive and it resumes with no further action. |
next_due_at | string | Bẹẹkọ | — |
last_audit_at | string | Bẹẹkọ | — |
review_profiles | ReviewProfile[] | Bẹẹkọ | — |
products | TrackedProduct[] | Bẹẹkọ | The products this organisation has asked us to price-track. |
merchant_names | string[] | Bẹẹkọ | How this business appears as a **seller** on the marketplaces. Confirmed by the customer and never inferred: Google Shopping publishes a seller name and no domain on its listing… |
keywords | TrackedKeyword[] | Bẹẹkọ | The search phrases this organisation tracks its position for. Customer-supplied and never derived: asking a vendor which phrases a domain already ranks for would return exactly… |
Awọn aṣiṣe ti ibudo ipari yii le da pada
401 · 403 · 404 · 422