Search buyable media outlets

Public. With an API key (catalog:read) the response carries the caller's own prices, including reseller price books, and priced_for is account. Filters such as min_price and max_price apply to list price.

get/api/agent/v1/outlets

Request

  • Base URL: https://essentras.com
  • URL: https://essentras.com/api/agent/v1/outlets
  • Auth: one of:
    • none
    • HTTP bearer

Query parameters

qstring

Match on publication name.

countrystring

Country name or ISO code, e.g. "US".

regionstring

North America, Europe, Middle East, Latin America, Asia Pacific, Africa, Oceania, Global.

languagestring

BCP-47 code, e.g. "en".

topicstring

Topic or genre, e.g. "fintech", "crypto", "lifestyle".

min_priceinteger

Minimum price in USD.

max_priceinteger

Maximum price in USD. The single most useful filter for a budget.

min_dainteger

Minimum Domain Authority.

min_drnumber

Minimum Domain Rating.

max_turnaround_daysinteger

Only outlets whose stated turnaround is at most this many business days.

statestring

State or region inside the country; a US postal code (TX) also works.

citystring

City; also matches the outlet name, since most listings carry no city field.

dofollowboolean

Only outlets giving dofollow links.

indexedboolean

Only outlets whose placements are confirmed indexed.

sort'popularity' | 'price_asc' | 'price_desc' | 'authority_desc' | 'traffic_desc'

Default: popularity.

limitinteger

Page size.

offsetinteger

Page offset.

Response

Matching offers

totalinteger
limitinteger
offsetinteger
has_moreboolean

Changes

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