API Reference › LinkedIn Ads › discover_linkedin_assets

discover_linkedin_assets

LinkedIn Ads Read

User wants to find existing images/videos in their LinkedIn account to reuse

Endpoint

POST https://api.adspirer.ai/api/v1/tools/discover_linkedin_assets/execute

Headers

Description

User wants to find existing images/videos in their LinkedIn account to reuse. Discover previously uploaded image and video assets for a LinkedIn Ad Account. IMPORTANT: - Call `get_linkedin_organizations` FIRST to get both organization_id AND account_id - The account_id is REQUIRED to find images uploaded via the new LinkedIn API What this tool does: - Queries LinkedIn for existing assets in the ad account - Returns images and videos with URNs, dimensions, and status - Assets can be reused in new campaigns without re-uploading Parameters: - organization_id: LinkedIn Organization (Company Page) ID (required) - account_id: LinkedIn Ad Account (Sponsored Account) ID (REQUIRED for image discovery!) - Get this from `get_linkedin_organizations` response - Without this, images uploaded via new API won't be found - asset_type: Filter by type - 'image', 'video', or 'all' (default: all) - limit: Maximum assets to return (default: 50, max: 100) Returns: - List of images with asset_urn, dimensions, status - List of videos with asset_urn, dimensions, duration, status - Total count of assets found Use this tool to: - Find existing images to reuse (saves time and ensures consistency) - Check what video assets are available for Video Ad campaigns - Avoid uploading duplicate assets Workflow: 1. Call `get_linkedin_organizations` first - get organization_id AND account_id 2. Call `discover_linkedin_assets` with both IDs 3. Use returned `asset_urn` in `create_linkedin_image_campaign` Execution time: 3-5 seconds

Request body

All tool arguments are wrapped in an arguments object.

FieldTypeDescription
organization_idstring requiredLinkedIn Organization (Company Page) ID. This is the organization that owns the assets. Use the organization ID from your connected LinkedIn account.
account_idstring optionalLinkedIn Ad Account (Sponsored Account) ID. Required to discover images uploaded via the new LinkedIn API. Get this from your LinkedIn Campaign Manager or `get_linkedin_ad_accounts` tool. Format: numeric ID or full URN (urn:li:sponsoredAccount:XXXXX).
asset_typestring optionalType of assets to discover: 'image', 'video', or 'all' (default). Use 'image' for Single Image Ads, 'video' for Video Ads. default: "all"
limitinteger optionalMaximum number of assets to return (default: 50, max: 100) default: 50

Example request

{
  "arguments": {
    "organization_id": "string",
    "account_id": "string",
    "asset_type": "all",
    "limit": 50
  }
}

Example responses

200 — Success

{
  "success": true,
  "data": {
    "text": "(tool-specific textual output for discover_linkedin_assets)",
    "quota": {
      "used": 42,
      "limit": 150,
      "tier": "plus",
      "period_end": "2026-05-01"
    }
  },
  "tool": "discover_linkedin_assets"
}

400 — Tool-level error (bad arguments / multi-account selection)

{
  "success": false,
  "error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n  - Acme Holdings (ad_account_id=\"act_123456789\")\n  - Acme EU (ad_account_id=\"act_987654321\")",
  "is_error": true,
  "tool": "discover_linkedin_assets"
}

402 — Quota exhausted

{
  "success": false,
  "error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.",
  "is_error": true,
  "tool": "discover_linkedin_assets",
  "quota": {
    "used": 150,
    "limit": 150,
    "tier": "plus",
    "period_end": "2026-05-01",
    "upgrade_url": "https://adspirer.ai"
  }
}

Try it live

Interactive: Swagger UI

Machine-readable: OpenAPI 3.1 spec · llms-full.txt

More tools: LinkedIn Ads · All tools

Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai