Find Sign Makers
Search Find Sign Makers listings to link
Finds the Find Sign Makers listings the Store could ask to link, as the
merchant admin's link picker does. Requires store:read.
Overview
Only listings
that a manufacturer account claimed are returned, because only they can
accept a link. A listing that another Store holds is returned with
is_linked: true. Each result gives the name and location only, never
the business email.
filter[search] is required. It keeps the listings whose name, profile
address or location contains the term, with the same case. The term is
trimmed, and must then have 2 to 100 characters. At most 10 listings are
returned, in name order, in one page; send a longer term to find a
listing that is not shown. Searches are limited to 30 per API key per
minute, as in the merchant admin. The API cannot ask for a link.
Authorisation
Bearer token required. Include it in the Authorization header.
Required scope: store:read
Query parameters
Only return listings whose name, profile slug or location contains this term (2 to 100 characters).
Example: bright
curl https://web.signcustomiser.com/api/v3/manufacturer-link-listings?filter%5Bsearch%5D=bright \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN'{
"data": [
{
"object": "manufacturer_link_listing",
"manufacturer_id": 318,
"name": "Bright Signs Ltd",
"location": "Manchester, United Kingdom",
"is_linked": false,
"is_publicly_verified": true
}
],
"pagination": {
"has_more": false,
"next_cursor": null
},
"links": {
"self": "https://web.signcustomiser.com/api/v3/manufacturer-link-listings?filter%5Bsearch%5D=bright",
"documentation": "https://www.signcustomiser.com/help/api/",
"next": null
},
"meta": {
"api_version": "v3",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
}{
"type": "https://www.signcustomiser.com/help/api/problems/missing_api_key",
"title": "Missing API key",
"status": 401,
"code": "missing_api_key",
"detail": "Provide a store API key as a bearer token.",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/insufficient_scope",
"title": "Insufficient scope",
"status": 403,
"code": "insufficient_scope",
"detail": "This operation requires the store:read scope.",
"required_scopes": [
"store:read"
],
"granted_scopes": [
"orders:read"
],
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/invalid_parameter",
"title": "Invalid query parameter",
"status": 422,
"code": "invalid_parameter",
"detail": "The filter[search] term must have 2 to 100 characters after it is trimmed.",
"errors": [
{
"parameter": "filter[search]",
"code": "invalid_parameter",
"detail": "The filter[search] term must have 2 to 100 characters after it is trimmed."
}
],
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/rate_limited",
"title": "Too many requests",
"status": 429,
"code": "rate_limited",
"detail": "You have exceeded the request limit for this API key.",
"retry_after": 30,
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}