Marin API

A POST-only REST API for programmatically writing data into Marin. Five bulk endpoints — /campaigns, /groups, /keywords, /ads and /strategies — accept a JSON body containing a single "data" array of rows whose keys are the same column headers used by Marin's bulk-upload spreadsheets. Requests are HTTPS only, authenticated with HTTP Basic using a MarinOne username and password issued by a Marin representative, and scoped by four required query-string parameters (clientId, customerId, userId, userCustomerId) read out of the MarinOne UI. The API is versioned in the URI path; only version 0.1 is published. Marin publishes no OpenAPI, no SDK and no error catalog beyond HTTP 200 and 500.

API entry from apis.yml

apis.yml Raw ↑
name: Marin API
description: A POST-only REST API for programmatically writing data into Marin. Five bulk endpoints —
  /campaigns, /groups, /keywords, /ads and /strategies — accept a JSON body containing a single "data"
  array of rows whose keys are the same column headers used by Marin's bulk-upload spreadsheets. Requests
  are HTTPS only, authenticated with HTTP Basic using a MarinOne username and password issued by a Marin
  representative, and scoped by four required query-string parameters (clientId, customerId, userId, userCustomerId)
  read out of the MarinOne UI. The API is versioned in the URI path; only version 0.1 is published. Marin
  publishes no OpenAPI, no SDK and no error catalog beyond HTTP 200 and 500.
humanURL: https://support.marinsoftware.com/en_US/bulk-actions/marin-api
baseURL: https://api.marinsoftware.com/open-api
tags:
- campaign-management
- paid-search
- paid-social
- retail-media
- bid-management
- bulk-upload
- advertising
- martech
properties:
- type: Documentation
  url: https://support.marinsoftware.com/en_US/Managing_Campaigns/api
- type: APIReference
  url: https://support.marinsoftware.com/en_US/bulk-actions/marin-api
- type: Authentication
  url: authentication/marin-software-authentication.yml
- type: Conventions
  url: conventions/marin-software-conventions.yml
- type: DataModel
  url: data-model/marin-software-data-model.yml
- type: ErrorCatalog
  url: errors/marin-software-error-codes.yml
- type: RateLimits
  url: rate-limits/marin-software-rate-limits.yml
- type: Lifecycle
  url: lifecycle/marin-software-lifecycle.yml
x-status: Documented on a live provider page, but the published base host api.marinsoftware.com resolves
  in DNS (69.194.129.87) and refuses TCP connections on both 443 and 80 from a public network as of 2026-08-12.
  Recorded as observed.