Publisher Parameters

Program Term API — Publisher Reference

This page covers the publisher-side query structure for the Program Terms API, including query arguments, filters, and the result wrapper object.


Query: publisher

Returns: PublisherQueries!

Top-level namespace for all publisher-related operations. Use the contracts field to retrieve program term data.

Field: contracts

Returns: ContractList!

Returns one or more contracts filtered according to the supplied arguments.

ArgumentTypeDescription
publisherIdID!Required. The publisher company ID to query for.
filtersContractFiltersOptional set of filters to narrow results.
limitIntHow many contracts to request at once. Defaults to 10; maximum 100.
offsetIntOffset in the list of contracts, used for pagination.

Input Object: ContractFilters

Optional set of filters applied to the contracts query.

FieldTypeDescription
advertiserIdIDIf given, returns all contracts with this specific advertiser.
activeAfterISODateTimeIf given, returns all contracts that are active after this time.
activeBeforeISODateTimeIf given, returns all contracts that are active before this time.

Object: ContractList

Wrapper object returned by the contracts query.

FieldTypeDescription
countLong!Count of contracts returned in this response.
resultList[Contract!]!List of contracts matching the query, each including program terms.
totalCountLong!Total count of all available contracts matching the query, regardless of limit.