Bulk landing-page URL update

Overview

Backfills landing-page URLs for several of a store's review sites in one call. Only fills rows whose landing_page_url is currently empty (skips already-set rows silently). It also seeds review_site_url+enables the scraper when that column is empty on an active store.

Prerequisites

• A bearer token. Callable with Partner and Account tokens.

Base URL

Endpoint

POST /api/v1/store-review-site/landing-page-url/update

Authentication

• Requires a bearer token in the Authorization: Bearer <bearer-token> header.

• Who can call it: Partner and Account tokens.

• store_id must pass an ownership check, so the store has to be in the auth user's hierarchy.

• A Partner reaches any store under its tree. An Account reaches only its own account's.

Rate limit

• No rate limit.

Request body

• Body:

{
  "store_id": 42,
  "landing_page_urls": [
    {
      "review_site_id": 44,
      "url": "https://search.google.com/local/writereview?placeid=ChIJ123"
    },
    {
      "review_site_id": 1,
      "url": "https://www.yelp.com/biz/demo"
    }
  ]
}

Response

• data.status (string) — success.
• data.message (string) — Landing page URL updated successfully.
• data.total_updated (integer) — count of rows actually updated (rows already holding a landing page URL do not count and not counted).

200 OK · 200

{ "data": { "status": "success", "message": "Landing page URL updated successfully", "total_updated": 2 } }

Errors

Example request

curl --request POST \
  --url "https://production-api.shoutaboutus.com/api/v1/store-review-site/landing-page-url/update" \
  --header 'Authorization: Bearer <bearer-token>' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"store_id": 42, "landing_page_urls": [{"review_site_id": 44, "url": "https://search.google.com/local/writereview?placeid=ChIJ123"}, {"review_site_id": 1, "url": "https://www.yelp.com/biz/demo"}]}'