Skip to main content
POST
Look up company advertisements

Authorizations

pubrio-api-key
string
header
required

A unique API token that represents the actions you perform through the API and the corresponding permissions and operations. You can create it through the Settings section.

Body

application/json
advertisement_search_id
string<uuid>
required

A unique identifier for the advertisement search result. Used to reference specific advertisements returned from the ads search endpoint.

Example:

"a92643e8-9033-4029-aa65-ef929327cebb"

profile_id
integer

Optional. An identifier for the user profile (workspace) making the request. This is no longer required as the API key already includes your workspace information. If provided, it helps in associating the lookup with a specific user, allowing for data retrieval and credit tracking.

Check out user details endpoints under the Profile tab for more information.

is_include_unlinked_companies
boolean
default:false

Include ads not yet linked to a resolved company (raw-layer ads, e.g. scam or burner-page ads). Defaults to false, which returns only company-attributed ads.

Example:

true

Response

Successful response containing company advertisement details.

data
object | null

Response info depends on specific endpoint.