Adspirer icon

Adspirer

Manage ad campaigns across Google, Meta, LinkedIn & TikTok Ads via the Adspirer REST API

Actions119

Get Research Status

AI-generated

Summary

Retrieve the status of a specific research job on the selected advertising platform or utility service.

Inputs

  • Platform (required) — Select the advertising platform or utility service to query, e.g., Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads, or Utility.
  • Job Id (required) — Provide the unique identifier of the research job whose status you want to retrieve (only required when Platform is 'utility').

Output shape

a single record containing the research job status as returned by the Adspirer API for the specified platform and job ID.

The 'Job Id' input is mandatory only if the Platform is set to 'utility'; otherwise, it is not used. The operation returns the job status synchronously from the Adspirer advertising API or utility endpoint.

Examples

Example 1: Check the status of a Google Ads research job

Select Platform as 'Google Ads' and invoke the operation; no job ID is required for the platform-specific calls.

Example 2: Get the status of a utility research job

Select Platform as 'Utility' and specify the 'Job Id' string to retrieve the status of that specific research job.

Links

Discussion