API reference · LinkedIn
linkedin/ads-search
Integrate this model through SandBase's unified API, with production-ready schemas and examples.
Production endpoint
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
POST
https://api.sandbase.ai/v1/api/linkedin/ads-searchModel ID
linkedin/ads-search01
Input Schema
7 parameters · 0 required · 7 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
company | string | Optional | Company name to search (e.g. "microsoft"). |
endDate | string | Optional | Search end date in YYYY-MM-DD format. Today or a later date is moved back to yesterday in UTC when your range overlaps LinkedIn's accepted dates. When you send startDate without endDate, the search ends yesterday in UTC, the latest day LinkedIn accepts. |
keyword | string | Optional | Keyword term for the ad search. |
companyId | string | Optional | LinkedIn company identifier. |
countries | string | Optional | Comma-separated two-letter country codes (e.g. "US,CA,MX"). |
startDate | string | Optional | Search start date in YYYY-MM-DD format. An earlier date is moved up to one year ago in UTC when your range overlaps LinkedIn's accepted dates. |
paginationToken | string | Optional | Opaque pagination token from a previous response's nextCursor. |
02
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
03
Code Examples
Ready-to-run snippets
const apiKey = process.env.SANDBASE_API_KEY;
const response = await fetch("https://api.sandbase.ai/v1/api/linkedin/ads-search", {
method: "POST",
headers: {
Authorization: `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"company": "microsoft"
}),
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());