marketplace

POST `/v1/marketplace/listings/bulk`

Create or update up to 200 per-site guest-post listings in one call.

Authentication

Send an API key as a bearer token. This endpoint checks no specific permission, so any key for your organisation can call it.

This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.

Try it

Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.

curl -X POST https://api.zinndigital.com/v1/marketplace/listings/bulk \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "rows": <object[]> }'

Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console

Details

s1006 (owner D41). Guest posts are listed one per SITE. The dashboard parses the seller's CSV (template at /v1/marketplace/listings/bulk/template.csv) and sends it in batches of at most 200 rows. Each row is created — or UPDATED when this seller already lists that site under that type (never duplicated) — and published through the ordinary path (measured metrics, content scan, review queue / automatic publish). A bad row is reported with its line and reason and never stops the batch. Requires an approved seller account.

Request body

Name	Type	Required	What it is
`listing_type`	`string<guest_post, niche_edit>`	No	—
`first_line`	`integer`	No	The CSV line of the first row, so reported lines match the file.
`rows`	`object[]`	Yes	—

Response

Name	Type	Required	What it is
`data`	`object[]`	Yes	—

Errors this endpoint can return

401 · 422

POST /v1/marketplace/listings/bulk