Search Ads

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

READscrape-creators.scrape_creators_linkedin_ad_library_get_v1_linkedin_ads_search

• Contract tier: legacy
• Risk: read
• Catalog version: scrape-creators-2026.07.12.1
• Descriptor hash: e8c94f7860f31f8ff4b98b624dcbc829fd5edf0b33810c909c0c483df46720d6

Use this when you need ScrapeCreators LinkedIn Ad Library data from GET /v1/linkedin/ads/search for Search Ads. Searches the LinkedIn Ad Library by company name, keyword, or companyId with optional country and date filters. Each ad includes id, description, headline, adType, advertiser, targeting details, image or video URLs, totalImpressions, and impressionsByCountry. Supports pagination via paginationToken. Returns the ScrapeCreators response in the standard MCP envelope with ok/data/error/meta. This is read-only. Requires the portal grant header and a ScrapeCreators BYOK API key.

Request Body

{
  "jsonrpc": "2.0",
  "id": "scrape-creators-scrape-creators-linkedin-ad-library-get-v1-linkedin-ads-search-example",
  "method": "tools/call",
  "params": {
    "name": "scrape-creators.scrape_creators_linkedin_ad_library_get_v1_linkedin_ads_search",
    "arguments": {
      "body": "",
      "params": "",
      "compact": "",
      "company": "",
      "endDate": "",
      "keyword": "",
      "companyId": "",
      "countries": "",
      "max_items": "",
      "startDate": ""
    }
  }
}

Arguments Schema

{
  "type": "object",
  "properties": {
    "body": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "array",
          "items": {}
        },
        {
          "type": "null"
        }
      ],
      "title": "Body",
      "default": null,
      "description": "JSON request body for provider endpoints that accept one."
    },
    "params": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "title": "Params",
      "default": null,
      "description": "Optional advanced query parameter object. Prefer the documented top-level parameters when available."
    },
    "compact": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Compact",
      "default": null,
      "description": "When true, trims large list payloads before returning them to the agent."
    },
    "company": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Company",
      "default": null,
      "description": "The company name to search for. 'Microsoft' for example"
    },
    "endDate": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Enddate",
      "default": null,
      "description": "End date to search for. Format: YYYY-MM-DD"
    },
    "keyword": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Keyword",
      "default": null,
      "description": "The keyword to search for"
    },
    "companyId": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Companyid",
      "default": null,
      "description": "The company id to search for"
    },
    "countries": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Countries",
      "default": null,
      "description": "Comma separated list of countries. Example: US,CA,MX"
    },
    "max_items": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Items",
      "default": null,
      "description": "Maximum number of list items to return when compacting provider responses."
    },
    "startDate": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Startdate",
      "default": null,
      "description": "Start date to search for. Format: YYYY-MM-DD"
    },
    "include_raw": {
      "type": "boolean",
      "title": "Include Raw",
      "default": false,
      "description": "When true, returns both compact normalized data and the raw provider payload; this can be large."
    },
    "path_params": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "title": "Path Params",
      "default": null,
      "description": "Path template values for endpoints that expose path placeholders."
    },
    "paginationToken": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Paginationtoken",
      "default": null,
      "description": "Pagination token to paginate through results"
    },
    "cache_ttl_seconds": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cache Ttl Seconds",
      "default": null,
      "description": "Optional cache lifetime for idempotent GET requests."
    },
    "confirm_high_cost": {
      "type": "boolean",
      "title": "Confirm High Cost",
      "default": false,
      "description": "Set true only when intentionally running a high-credit or write-intent request."
    }
  },
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "required": [
    "ok",
    "data",
    "error",
    "meta"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the local or provider operation completed successfully."
    },
    "data": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "array",
          "items": {}
        },
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "Bounded operation result when ok is true."
    },
    "meta": {
      "type": "object",
      "description": "Safe request, pagination, cache, and timing metadata.",
      "additionalProperties": true
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "description": "Safe structured error when ok is false."
    }
  },
  "description": "Scrape Creators MCP normalized response envelope.",
  "additionalProperties": false
}

Code Examples

cURL

curl -X POST 'https://portal.madpanda3d.com/api/mcp' \
  -H 'Authorization: Bearer mad_live_***' \
  -H 'Content-Type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": "scrape-creators-scrape-creators-linkedin-ad-library-get-v1-linkedin-ads-search-example",
  "method": "tools/call",
  "params": {
    "name": "scrape-creators.scrape_creators_linkedin_ad_library_get_v1_linkedin_ads_search",
    "arguments": {
      "body": "",
      "params": "",
      "compact": "",
      "company": "",
      "endDate": "",
      "keyword": "",
      "companyId": "",
      "countries": "",
      "max_items": "",
      "startDate": ""
    }
  }
}'

Node.js

const response = await fetch('https://portal.madpanda3d.com/api/mcp', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer mad_live_***',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "jsonrpc": "2.0",
  "id": "scrape-creators-scrape-creators-linkedin-ad-library-get-v1-linkedin-ads-search-example",
  "method": "tools/call",
  "params": {
    "name": "scrape-creators.scrape_creators_linkedin_ad_library_get_v1_linkedin_ads_search",
    "arguments": {
      "body": "",
      "params": "",
      "compact": "",
      "company": "",
      "endDate": "",
      "keyword": "",
      "companyId": "",
      "countries": "",
      "max_items": "",
      "startDate": ""
    }
  }
}),
});
const data = await response.json();
console.log(data);

Python

import requests

url = 'https://portal.madpanda3d.com/api/mcp'
headers = {
    'Authorization': 'Bearer mad_live_***',
    'Content-Type': 'application/json',
}
payload = {
  "jsonrpc": "2.0",
  "id": "scrape-creators-scrape-creators-linkedin-ad-library-get-v1-linkedin-ads-search-example",
  "method": "tools/call",
  "params": {
    "name": "scrape-creators.scrape_creators_linkedin_ad_library_get_v1_linkedin_ads_search",
    "arguments": {
      "body": "",
      "params": "",
      "compact": "",
      "company": "",
      "endDate": "",
      "keyword": "",
      "companyId": "",
      "countries": "",
      "max_items": "",
      "startDate": ""
    }
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

{
  "ok": true,
  "message": "Tool scrape-creators.scrape_creators_linkedin_ad_library_get_v1_linkedin_ads_search executed successfully.",
  "note": "Response shape varies by MCP tool. Inspect live responses for exact fields."
}

502 Upstream Error

{
  "ok": false,
  "classification": "upstream_http_error",
  "message": "Upstream MCP returned a non-success status."
}