# LinkedIn Search API (linkedin.search)

- Canonical page: https://everyinfra.com/en/linkedin-api/search
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "linkedin", "action": "search", "params": {...}}
- Price: $0.003194 per call ($3.19 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 10, max 50 per call
- Mode: sync; add "mode": "async" for slow tasks

LinkedIn Search finds public LinkedIn posts by `keyword` and returns each post's text, author name and username, like and comment counts, link and publish time. It shows who is talking about a topic on LinkedIn and how much engagement the conversation draws. B2B marketers and PR teams use it for social listening and tracking mentions of a brand or product, and sales teams use it to find people who post about a problem they solve.

Narrow results by publish time with `date_range`, from the past hour to the past month, and choose `newest` or `relevance` in `sort`. It searches posts only; people are found with LinkedIn Profile search and job postings with LinkedIn Jobs. A null `like_count` or `comment_count` means the number was not disclosed, not that it is zero, and `author_username` can usually be used to build the author's LinkedIn link.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=linkedin&action=search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | Specifies the search string, acting as a post search keyword in search, a current job title in profile_search, or a job search term or full job URL in jobs. Searching for people with this parameter does not perform an exact match by individual name or email. |
| date_range | enum: no_filter / past_1_hour / past_24_hours / past_month / past_week | no | not declared | Filters post publishing timestamps for the search action using allowed values no_filter, past_1_hour, past_24_hours, past_week, or past_month. It applies strictly to post publishing times rather than job listing validity or personal employment history. |
| sort | enum: newest / relevance | no | not declared | Sets the sorting order to newest or relevance for post search and comment fetching. Because these actions target different object types, this parameter does not sort people, companies, or job listings. |
| limit | integer (1–50) | no | 10 | The most rows to return in this call, an integer from 1 to 50. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| author_name | Author's display name. |
| author_username | Author's username (@handle), usually usable in URLs. |
| author_headline | platform-native meaning |
| author_id | Numeric member ID of the post author (search). |
| author_url | Profile link of the post author (search), without tracking parameters. |
| author_avatar_url | Avatar link of the post author (search). |
| author_type | platform-native meaning |
| reactions | Reaction counts by type (search): each entry has type (like, appreciation, empathy and so on) and count. |
| attachment | Card attached to the post (search): type (for example job or article), title, description, subtitle, url and image_url. |
| like_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
| comment_count | Comments. null means not disclosed, not 0. |
| share_count | Number of times the post was reshared. |
| hashtags | Hashtag list of the company page or post. |
| is_reshare | Whether the post is a reshare of another post. |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "linkedin",
  "action": "search",
  "params": {
    "keyword": "data engineer"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "linkedin",
        "action": "search",
        "params": {
            "keyword": "data engineer",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 10. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "linkedin",
  "action": "search",
  "results": [
    {
      "id": "•••",
      "url": "https://www.linkedin.com/posts/triveni-p-186b23245_hiring-immediatejoiners-itjobs-activity-7509276127224463360-gDVu?utm_source=social_share_send&utm_medium=member_desktop_web&rcm=ACoAAG7RZS4Be0lZ9Txw3UPxtvjwYlh3m2T4qFQ",
      "text": "🚀 MULTIPLE IT OPENINGS | NOW HIRING\nHi All! 👋\nWe are looking for immediate to 15-day joiners for the below opportunities:\n📌 Open Positions\n▪️ Full Stack Data Engineer – 6–9 Yrs\n▪️ ETL + Automation Tester – 7–10 Yrs\n▪️ Informatica IDMC / MDM Consultant – 6+ Yrs\n▪️ GCP Data Enginee…",
      "author_name": "•••",
      "author_username": "•••",
      "like_count": 11,
      "comment_count": 0,
      "posted_at": "2026-09-25T17:42:24+00:00",
      "platform": "linkedin"
    },
    {
      "id": "•••",
      "url": "https://www.linkedin.com/posts/swapnilbandgar_dataengineer-hiring-aws-activity-7509255941473841153-s1yJ?utm_source=social_share_send&utm_medium=member_desktop_web&rcm=ACoAAG7RZS4Be0lZ9Txw3UPxtvjwYlh3m2T4qFQ",
      "text": "We’re hiring! Looking for a Data Engineer to join our team.\n📍 Location: Pune (Hybrid - 3 days/week)\n💻 Tech Stack: SQL, Python, AWS\n📈 Experience: 4+ years hands-on\n\nInterested? Shoot me a DM or tag someone who might be a great fit!\n\n#DataEngineer #Hiring #AWS #Python #SQL",
      "author_name": "•••",
      "author_username": "•••",
      "like_count": 19,
      "comment_count": 3,
      "posted_at": "2026-09-25T16:22:11+00:00",
      "platform": "linkedin"
    }
  ],
  "count": 10,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### Can this search people or jobs?

No, it searches posts. For people, use LinkedIn Profile search, which looks people up by current job title; for job postings, use LinkedIn Jobs, which takes a job search term or a LinkedIn job search URL. Each capability returns its own kind of record, so pick the one that matches what you want to count.

### How do I get only the latest posts on a topic?

Set `date_range` to `past_1_hour`, `past_24_hours`, `past_week` or `past_month`, and `sort` to `newest`; `no_filter` applies no time window. The window applies to when posts were published, not to job validity or anyone's employment dates. Parse `posted_at` defensively, since non-standard time strings are passed through as is.

### How do I read the comments on a post I found?

Pass the post's link from `url` to the LinkedIn Comments capability, which takes a full post link and returns the comments under it. `comment_count` tells you beforehand how many comments a post has, so you can skip posts that drew no discussion.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=linkedin
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md