Catalogue

List publications

The paginated catalogue, with the same filters as the interface. Each entry also states how it can be paid for: from a package, from the balance, or not at all.

Required scope: CATALOG_READ.

get/partner/catalog

Request

  • Base URL: https://app.comunicate.eu/api/v1
  • URL: https://app.comunicate.eu/api/v1/partner/catalog
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.comunicate.eu/api/v1/oauth/authorize, token URL https://app.comunicate.eu/api/v1/oauth/token, scopes: CATALOG_READ)

Query parameters

pageinteger

Requested page, from 1.

pageSizeinteger

Entries per page, at most 100.

searchstring

Searches name and domain.

campaignstring

Only publications accepting the given type (see campaign-types).

serviceTypestring

PUBLISH_ONLY, WRITE_AND_PUBLISH, HOMEPAGE_PLACEMENT or FACEBOOK_SHARE. For the other three, only sites with an active offer of the requested type appear — plain publishing is the base service, any priced site has it.

Response

OK

entries[].idstring uuid

The publication id. Used when requesting a publication.

entries[].metricsobject

DR, DA, PA and backlink count. null where we have no reading.

entries[].audit'object' | 'null'

flagged is the only field that changes a decision: a site Google flags as dangerous should not be bought.

entries[].preturiCampaniiobject

Publication price per accepted campaign type, in minor units.

entries[].accessobject

OWN, CREDIT (covered by a package), MONEY (paid from balance), UNAVAILABLE. When packages has more than one entry, publishing requires packageTypeId.

entries[].masuratobject

What we measured from our own orders: average hours to going live, how many verified publications are still fine. null where we have not published enough.

Changes

No recorded changes to this operation across all 1 revision of this API.