Search Ads

Retrieve search ads from LinkedIn Ad Library with a single API request.

GET/api/data/v1/linkedin/ads/search

1credit base cost

Request parameters

Up to 1 credit

companyoptional

The company name to search for. 'Microsoft' for example

keywordoptional

The keyword to search for

companyIdoptional

The company id to search for

countriesoptional

Comma separated list of countries. Example: US,CA,MX

startDateoptional

Start date in YYYY-MM-DD format. Must be used with endDate and cannot be earlier than the date one year ago.

endDateoptional

End date in YYYY-MM-DD format. Must be used with startDate and cannot be today or a future date.

paginationTokenoptional

Pagination token to paginate through results

Try in the console

Live requests use your prepaid balance. Cached responses cost zero where supported.

curl --request GET \
  --url 'https://fetchgoblin.com/api/data/v1/linkedin/ads/search' \
  --header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'

Response

Example

{
  "success": true,
  "ads": [
    {
      "id": "823975056",
      "description": "The countdown has begun – grab your discounted tickets now for #FabConEurope in Vienna!\nJoin us for an unforgettable experience filled with deep learning, expert insights, and top-tier networking opportunities.\n\nRegister today and be part of the future of innovation: http://msft.it/6043sMFt3 \n\n#MicrosoftFabric",
      "headline": null,
      "poster": "Microsoft",
      "posterTitle": "Promoted",
      "promotedBy": null,
      "targeting": {
        "language": "Targeting includes English",
        "location": "Targeting includes Netherlands",
        "company": "Exclusion targeting applied"
      },
      "image": "https://media.licdn.com/dms/image/v2/D5610AQH8f223ANJdoQ/image-shrink_1280/B56ZiDa0MFHkAQ-/0/1754551502346?e=2147483647&v=beta&t=ZuZ0zUs1KInS8ysVO7FxzmlzxHP9B_JX2b6kdMU8GT4",
      "video": null,
      "carouselImages": [],
      "adType": "Single Image Ad",
      "advertiser": "Microsoft",
      "advertiserLinkedinPage": "https://www.linkedin.com/company/1035",
      "cta": null,
      "destinationUrl": "http://msft.it/6043sMFt3?trk=ad_library_ad_preview_headline_content",
      "adDuration": "Ran from Aug 10, 2025 to Aug 10, 2025",
      "startDate": "2025-08-10T05:00:00.000Z",
      "endDate": "2025-08-10T05:00:00.000Z",
      "totalImpressions": "< 1k",
      "impressionsByCountry": []
    }
  ],
  "paginationToken": "756412693-1754569518292",
  "isLastPage": false,
  "totalAds": 8699,
  "credits_charged": 1,
  "credits_remaining": 1000,
  "request_id": "00000000-0000-4000-8000-000000000000"
}

Example data from the API specification. Run a request to retrieve current data.

Response shape

This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.

View JSON Schema +

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "ads": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "headline": {
            "type": [
              "string",
              "object",
              "array",
              "number",
              "boolean",
              "null"
            ]
          },
          "poster": {
            "type": "string"
          },
          "posterTitle": {
            "type": "string"
          },
          "promotedBy": {
            "type": [
              "string",
              "object",
              "array",
              "number",
              "boolean",
              "null"
            ]
          },
          "targeting": {
            "type": "object",
            "properties": {
              "language": {
                "type": "string"
              },
              "location": {
                "type": "string"
              },
              "company": {
                "type": "string"
              }
            }
          },
          "image": {
            "type": "string"
          },
          "video": {
            "type": [
              "string",
              "object",
              "array",
              "number",
              "boolean",
              "null"
            ]
          },
          "carouselImages": {
            "type": "array"
          },
          "adType": {
            "type": "string"
          },
          "advertiser": {
            "type": "string"
          },
          "advertiserLinkedinPage": {
            "type": "string"
          },
          "cta": {
            "type": [
              "string",
              "object",
              "array",
              "number",
              "boolean",
              "null"
            ]
          },
          "destinationUrl": {
            "type": "string"
          },
          "adDuration": {
            "type": "string"
          },
          "startDate": {
            "type": "string"
          },
          "endDate": {
            "type": "string"
          },
          "totalImpressions": {
            "type": "string"
          },
          "impressionsByCountry": {
            "type": "array"
          }
        }
      }
    },
    "paginationToken": {
      "type": "string"
    },
    "isLastPage": {
      "type": "boolean"
    },
    "totalAds": {
      "type": "integer"
    },
    "credits_charged": {
      "type": "integer",
      "minimum": 0,
      "description": "FetchGoblin credits charged for this request."
    },
    "credits_remaining": {
      "type": "integer",
      "description": "Your FetchGoblin credit balance after this request."
    },
    "request_id": {
      "type": "string",
      "format": "uuid",
      "description": "FetchGoblin request identifier."
    }
  }
}

More LinkedIn Ad Library endpoints Errors and credit accounting