Skip to main content
POST
/
companies
/
advertisements
/
lookup
cURL
curl --request POST \
  --url https://api.pubrio.com/companies/advertisements/lookup \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "advertisement_search_id": "a92643e8-9033-4029-aa65-ef929327cebb",
  "profile_id": 123
}
'
{
  "data": {
    "headline": "Thuraya-4 Satellite Solutions for Government",
    "description": "Thuraya-4 provides secure, always-on connectivity for vehicles, aircraft and command centers, ensuring mission continuity. \n\nLearn more about our satellite-powered government solutions.",
    "poster": "Space42",
    "poster_title": "Promoted",
    "promoted_by": null,
    "cta": "Learn more",
    "target_country_codes": [
      "MM",
      "..."
    ],
    "target_locations": [
      "United Arab Emirates",
      "..."
    ],
    "total_impressions": "10k-20k",
    "impression_countries": [
      {
        "country": "India",
        "impressions": "19%"
      },
      "..."
    ],
    "advertisement_id": "a92643e8-9033-4029-aa65-ef929327cebb",
    "advertisement_search_id": "a92643e8-9033-4029-aa65-ef929327cebb",
    "created_at": "2026-03-03T01:01:31.134Z",
    "last_modified": "2026-03-03T13:01:22.805Z",
    "started_at": "2026-02-25T00:00:00.000Z",
    "ended_at": "2026-03-02T00:00:00.000Z",
    "title": "Thuraya-4 Satellite Solutions for Government",
    "source_type": "linkedin",
    "advertisement_format": "Single Image Ad",
    "video_url": null,
    "image_url": "https://buckets.pubrio.com/images/public/qDf8TrjHJw9o8xFoQJv7vhnkLXNYKy1ThNVCWSHPmgHG5j7U4EroKtH4cYJcHCzTSh.jpg",
    "carousel_images": null,
    "destination_url": "https://www.thuraya.com/en/thuraya-4-ngs/home/index.html?trk=ad_library_ad_preview_headline_content",
    "companies": {
      "logo_url": "https://buckets.pubrio.com/company-logo/MjA3NTQ4NjQyM2lsajlzc25qMXNwYWNlNDIuYWlsaW5rZWRpbl82NDIyMjM3NA==.jpg",
      "domain_search_id": "fe3963dc-87a4-4016-8c95-217ea68cd57a",
      "company_name": "Space42",
      "linkedin_name": "space42ai",
      "country_code": "AE",
      "domain": "space42.ai"
    }
  }
}

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
required

An identifier for the user profile (workspace) making the request. This ID 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.

Response

Successful response containing company advertisement details.

​
data
object

Response info depends on specific endpoint.