LIlistingsapi
Posts

List of post campaigns for tags/locations.

Changed on

Returns a page of bulk (multi-location) post campaigns that include a single location.

get/api/v4/locations/{locationId}/bulk-posts

Request

Path parameters

locationIdstring required

Base64-encoded location cursor / global ID (e.g. TG9jYXRpb246MTgwMDI4OQ==). Pass it unchanged, do not URL-encode it. The base64 cursor always resolves; the raw numeric database ID also works on this endpoint, but the base64 form is the portable choice across the API.

Query parameters

locationIdsstring

JSON-encoded filter object

JSON-encoded array of location IDs to include alongside the path location.

filtersstring

JSON-encoded filter object

JSON-encoded SocialPostFiltersInput (e.g. by type, status, creationDateRange, siteUrls).

pageinteger

1-based page number for offset pagination.

perPageinteger

Number of records per page.

sortFieldsstring

JSON-encoded filter object

JSON-encoded sort object { "field": "created_at", "order": "Descending" }. field is one of name, type, status, created_at, schedule_start_date, schedule_end_date, client_name, clicks, views, shares.

componentIdentifierstring

Filter to campaigns created by a specific component/integration.

Response

Successful response

Changes

  • 91249a5e08beRevision changes
    • breaking

      added to the response body oneOf list for the response status

    • info

      removed from the response body oneOf list for the response status

  • 8bc826bc148cRevision changes
    • breaking

      added to the response body oneOf list for the response status

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      removed the required property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status