MadHive

MadHive retargeting line item API

The retargeting line item API from MadHive — 1 operation(s) for retargeting line item.

Documentation GitHub OpenAPI

Business capability

Digital Marketing Management BC-400.60

Operations 1

POST /v1/retargeting/lineitems Ability to create a line item for retargeting #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/madhive-retargeting-line-item-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Madhive retargeting line item API
  version: 1.0.0
  description: The Madhive API provides a comprehensive interface for digital advertising clients and services.
servers:
- url: https://api2.madhive.com/api
  description: apigee
tags:
- name: retargeting line item
paths:
  /v1/retargeting/lineitems:
    post:
      tags:
      - retargeting line item
      summary: Ability to create a line item for retargeting
      description: Ability to create a line item retargeting segment with ability to add a custom name and notes. The inputs include advertiser, line item start/end dates and line item IDs. If the advertiser or start/end date do not match the line item ID’s it will return an error.
      operationId: createRetargetingLineItem
      parameters:
      - $ref: '#/components/parameters/X-Cloud-Trace-Context'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RetargetingLineItemRequest'
      responses:
        '200':
          description: retargeting line item created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RetargetingResponse'
        '400':
          $ref: '#/components/responses/400InvalidID'
        '401':
          $ref: '#/components/responses/401Unauthorized'
      security:
      - oauth2: []
components:
  examples:
    401Ex:
      value:
        error: unauthorized
        status: ERROR
        transaction:
          id: 4af459ff8e1a36b6bb74fb88f1a02477
          taskId: '14158884487309867565'
          created: '2030-11-02T15:04:00Z'
    400InvalidID:
      value:
        error: invalid resource id
        status: ERROR
        transaction:
          id: 4af459ff8e1a36b6bb74fb88f1a02477
          taskId: '14158884487309867565'
          created: '2030-11-02T15:04:00Z'
  responses:
    400InvalidID:
      description: Invalid input
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            response:
              $ref: '#/components/examples/400InvalidID'
    401Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            response:
              $ref: '#/components/examples/401Ex'
  schemas:
    Transaction:
      type: object
      x-go-type-skip-optional-pointer: true
      x-omitempty: false
      required:
      - id
      - taskId
      - created
      properties:
        id:
          type: string
          description: trace id
          example: 4af459ff8e1a36b6bb74fb88f1a02477
        taskId:
          type: string
          x-omitempty: true
          description: task id
          example: '14158884487309867565'
        created:
          type: string
          description: 'order created date, format: yyyy-mm-dd hh:mm:ss'
          example: '2030-11-02T15:04:00Z'
    ErrorResponse:
      type: object
      required:
      - transaction
      properties:
        errors:
          type: array
          x-go-type-skip-optional-pointer: true
          items:
            type: string
          description: many error messages
        error:
          type: string
          x-go-type-skip-optional-pointer: true
          description: error message
          example: Unauthorized
        status:
          type: string
          x-go-type-skip-optional-pointer: true
          description: status of the service
          example: ERROR
        transaction:
          $ref: '#/components/schemas/Transaction'
    RetargetingLineItemRequest:
      allOf:
      - $ref: '#/components/schemas/RetargetingCampaignRequest'
    ID:
      type: string
      x-go-name: ID
      x-go-type-skip-optional-pointer: true
      x-oapi-codegen-extra-tags:
        validate: omitempty,min=28,max=28
      description: resource id
      example: a8MWQ2v4ZceGhsku2P5amaOXCnwe
    RetargetingRequest:
      type: object
      x-isnullable: false
      required:
      - ids
      - name
      - advertiserId
      properties:
        name:
          $ref: '#/components/schemas/Name'
        description:
          type: string
          x-isnullable: true
          x-omitempty: true
          x-go-type-skip-optional-pointer: true
          x-oapi-codegen-extra-tags:
            validate: 'omitempty,min=2,max=128,ne= '
          description: retargeting description
          example: retargeting description
        ids:
          x-go-name: IDs
          type: array
          items:
            $ref: '#/components/schemas/ID'
          x-oapi-codegen-extra-tags:
            validate: required,unique,gte=1,dive
          description: resource ids
        advertiserId:
          type: string
          x-go-name: AdvertiserID
          x-omitempty: true
          x-go-type-skip-optional-pointer: true
          x-oapi-codegen-extra-tags:
            validate: required,min=28,max=28
          description: advertiser id
          example: 3XhdJ4bBiPD1B0kr2jjFFJjOvH8S
        retargetingWindow:
          type: string
          x-omitempty: true
          x-go-type-skip-optional-pointer: true
          pattern: ^([1-9][0-9]* (DAY|MONTH))?$
          description: retargeting window interval (e.g., "7 DAY", "3 MONTH")
          example: 7 DAY
    RetargetingResponse:
      type: object
      x-isnullable: false
      description: generic response for all retargeting requests
      allOf:
      - $ref: '#/components/schemas/RetargetingRequest'
      - type: object
        properties:
          id:
            $ref: '#/components/schemas/ID'
          transaction:
            $ref: '#/components/schemas/Transaction'
          retargetingType:
            $ref: '#/components/schemas/RetargetingType'
          startDate:
            $ref: '#/components/schemas/Date'
          endDate:
            $ref: '#/components/schemas/Date'
    Date:
      type: string
      x-go-type-skip-optional-pointer: true
      x-oapi-codegen-extra-tags:
        validate: required,datetime=2006-01-02T15:04:05Z07:00
      description: 2020-06-18T17:24:53Z is a basic example of an RFC 3339 timestamp, which refers to June 18, 2020 5:24:53 PM in UTC
      example: '2030-01-10T23:00:00Z'
    RetargetingCampaignRequest:
      allOf:
      - $ref: '#/components/schemas/RetargetingRequest'
      - type: object
        required:
        - startDate
        - endDate
        properties:
          startDate:
            $ref: '#/components/schemas/Date'
          endDate:
            $ref: '#/components/schemas/Date'
    Name:
      type: string
      x-isnullable: false
      x-omitempty: false
      x-oapi-codegen-extra-tags:
        validate: 'required,min=2,max=128,ne= '
      description: resource name
      example: name of resource
    RetargetingType:
      type: string
      x-go-type-skip-optional-pointer: true
      x-isnullable: false
      x-omitempty: false
      x-oapi-codegen-extra-tags:
        validate: required,oneof=RETARGETING_CAMPAIGN RETARGETING_LINE_ITEM RETARGETING_TRACKING_PIXEL RETARGETING_CREATIVE
      enum:
      - RETARGETING_CAMPAIGN
      - RETARGETING_LINE_ITEM
      - RETARGETING_TRACKING_PIXEL
      - RETARGETING_CREATIVE
      description: retargeting type
      example: RETARGETING_CAMPAIGN
  parameters:
    X-Cloud-Trace-Context:
      name: X-Cloud-Trace-Context
      in: header
      description: gcp trace
      required: false
      schema:
        type: string
        default: 91f9f012dc7c7ffc13604c77f12a8931
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://api2.madhive.com/oauth/token
          scopes: {}
    basicAuth:
      type: http
      description: Basic Authentication Not Implemented
      scheme: basic
    bearerAuth:
      type: apiKey
      name: Authorization
      in: header
      description: jwt access token for authentication