Get a brand

Name	Type	Required	Description
brandId	string	required	Brand UUID, the `socialProfile.id` returned by POST /social/brands or the `id` of a row from GET /social/brands.

Name

Type

Required

Description

brandId

string

required

Brand UUID, the `socialProfile.id` returned by POST /social/brands or the `id` of a row from GET /social/brands.

Responses

200The brand.

Response

{  "data": {    "getSocialProfileDetails": {      "id": "6f2c9a41-7b0e-4d55-9a2f-3c8e1d47b902",      "profileName": "Jenny Home",      "archived": false,      "logo": "https://cdn.listingsapi.com/social/brands/6f2c9a41/logo.png",      "profileLogo": "https://cdn.listingsapi.com/social/brands/6f2c9a41/logo.png",      "siteUrl": "https://jennyhome.example",      "countryIso": "US",      "bio": "Handmade furniture for real homes.",      "businessIntent": "A family-run home furnishings store selling handmade furniture and textiles.",      "categories": ["Furniture Store", "Home Goods"],      "brandHashtags": ["jennyhome", "handmadefurniture"],      "competitorHashtags": ["localfurniture"],      "connectedChannelCount": 3,      "timezone": {        "label": "(GMT-05:00) Eastern Time",        "tzCode": "America/New_York",        "name": "Eastern Standard Time",        "utc": "-05:00"      },      "contentPreferredLanguage": "en"    }  }}

401Unauthenticated, missing or invalid API key.

404No brand with that ID on this account (`SY95043`).

Fetches a single brand by its UUID. The payload is identical to one row of GET /social/brands, so reach for this when you already hold a brandId and want the freshest copy rather than re-listing.

Use case: showing the brand header on a publishing screen. Read profileName and logo to label the composer, and timezone.tzCode to render scheduled times in the zone the API will actually interpret them in. A post scheduled with scheduleDate + scheduleTime is timed against this field, so showing the reader anything else invites off-by-hours mistakes.

Use case: pre-flight before publishing. If connectedChannelCount is 0, there is nowhere to publish. Send the user to a connection link instead of letting them compose a post that will be rejected with SY95045.

Notes.

brandId is a plain UUID. Base64-encoding it, as you would a location ID, produces a 404.
brandId is a path token only. The same value appears in request bodies as socialProfileId; the two names are the same ID in different positions.
archived is true for a brand that has already been archived. A brand that is merely scheduled for archival still reads archived: false — see archive a brand.
timezone.tzCode is the IANA identifier schedules are resolved against; the other three timezone fields are display labels.
For the individual connections on the brand — their platforms and connection IDs — call GET /social/brands/{brandId}/connections.

Parameters

Path

Responses