logo
LinkedInLinkedIn Ad Search

LinkedIn Ad Search

Search LinkedIn's Ad Library by keyword, company, country, and date range. Supports both structured parameters and raw Ad Library search URLs.

Pricing: 0.2 credit per result in the elements array.

curl -X GET "https://v3-api.texau.com/api/v1/ad_search?searchUrl=example_string&keyword=hiring&accountOwner=stripe&countries=US,GB&dateOption=last-30-days&startdate=2024-12-25&enddate=2024-12-25&paginationToken=example_string" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY"
{
  "elements": [
    {
      "id": "example_string",
      "advertiser": {
        "name": "John Doe",
        "imageUrl": "example_string",
        "headline": "example_string"
      },
      "content": {
        "headline": "example_string",
        "description": "example_string",
        "pageUrl": "example_string",
        "imageUrl": "example_string"
      },
      "creativeType": "example_string"
    }
  ],
  "pagination": {
    "totalPages": 25,
    "totalElements": 42,
    "pageSize": 25,
    "paginationToken": "example_string"
  },
  "status": 42,
  "query": {}
}
GET
/ad_search
GET
API Key (header: x-api-key)
x-api-keystring
Required

Your TexAu API key. Contact TexAu to obtain one.

Your TexAu API key. Contact TexAu to obtain one.
query
searchUrlstring

Full LinkedIn Ad Library search URL (alternative to params below).

query
keywordstring

Search by keyword.

query
accountOwnerstring

Company or advertiser name.

query
countriesstring

Comma-separated country codes or ALL.

query
dateOptionstring

Date filter preset.

Options: last-30-days, current-month, current-year, last-year, custom-date-range
query
startdatestring

Start date for custom range (YYYY-MM-DD).

Format: date
query
enddatestring

End date for custom range (YYYY-MM-DD).

Format: date
query
paginationTokenstring

Pagination token from previous response.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
x-api-keystring
Required

API Key for authentication. Your TexAu API key. Contact TexAu to obtain one.

Query Parameters

searchUrlstring

Full LinkedIn Ad Library search URL (alternative to params below).

keywordstring

Search by keyword.

accountOwnerstring

Company or advertiser name.

countriesstring

Comma-separated country codes or ALL.

dateOptionstring

Date filter preset.

Allowed values:last-30-dayscurrent-monthcurrent-yearlast-yearcustom-date-range
startdatestring

Start date for custom range (YYYY-MM-DD).

enddatestring

End date for custom range (YYYY-MM-DD).

paginationTokenstring

Pagination token from previous response.

Responses

elementsarray
paginationobject
statusinteger
queryobject