Search APIs

Search across LinkedIn profiles and posts with powerful filters. Includes post details and post activity feeds.

People Search

Search across our enriched LinkedIn profiles by account and contact filters.

Endpoint: POST /people_search Credits: 0.1 per result returned

Request

curl -X POST https://v3-api.texau.com/api/v1/people_search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account": {
      "industry": ["software development"],
      "employeeSize": {"start": 50, "end": 500}
    },
    "contact": {
      "jobTitle": ["CTO", "VP Engineering"],
      "location": ["united states"]
    },
    "page": 0,
    "size": 25
  }'

Parameters

Field	Type	Required	Description
`account`	object	No	Company-level filters
`account.linkedin`	string[]	No	LinkedIn company URLs
`account.domain`	string[]	No	Company domains (e.g. `google.com`)
`account.industry`	string[]	No	Industry names
`account.employeeSize`	object	No	`{start, end}` employee count range
`contact`	object	No	Person-level filters
`contact.jobTitle`	string[]	No	Job titles to match
`contact.location`	string[]	No	Locations (country, city, or region)
`page`	integer	Yes	Page number (zero-based)
`size`	integer	Yes	Results per page (1-100)

Response

{
  "content": [
    {
      "url": "https://www.linkedin.com/in/...",
      "firstname": "Jane",
      "lastname": "Smith",
      "headline": "CTO at Acme Inc",
      "industry": "Software Development",
      "location": {
        "country": "United States",
        "city": "San Francisco",
        "state": "California"
      },
      "positionGroups": [...],
      "educations": [...],
      "skills": [...]
    }
  ],
  "totalElements": 83001,
  "totalPages": 3321,
  "numberOfElements": 25,
  "first": true,
  "last": false,
  "size": 25,
  "number": 0
}

Pagination

Use page and size to paginate through results:

# Page 1 (first 25 results)
{"page": 0, "size": 25}

# Page 2 (next 25 results)
{"page": 1, "size": 25}

# Page 3
{"page": 2, "size": 25}

Credit Calculation

Credits = numberOfElements (results returned) x 0.1

Results	Credits
10	1
25	2.5
50	5
100	10

Post Keyword Search

Search LinkedIn posts by keyword with filters for date, content type, and author.

Endpoint: POST /post_keyword_search Credits: 6 per call

Request

curl -X POST https://v3-api.texau.com/api/v1/post_keyword_search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "artificial intelligence",
    "sort": "DATE_POSTED",
    "datePosted": "PAST_WEEK",
    "page": 0,
    "size": 10
  }'

Parameters

Field	Type	Required	Description
`keyword`	string	Yes	Search keyword
`sort`	string	No	`RELEVANCE` (default) or `DATE_POSTED`
`datePosted`	string	No	`PAST_24_HOURS`, `PAST_WEEK`, or `PAST_MONTH`
`contentType`	string	No	`VIDEO`, `IMAGE`, `JOB`, `LIVE_VIDEO`, `DOCUMENT`, `COLLABORATIVE_ARTICLE`
`fromPerson`	string[]	No	Filter by person entity URNs
`fromCompany`	string[]	No	Filter by company entity URNs
`authorIndustry`	string[]	No	Filter by author industry
`authorKeyword`	string[]	No	Filter by author job titles
`page`	integer	No	Page number (zero-based, default 0)
`size`	integer	No	Results per page (1-50, default 10)

Response

{
  "content": [
    {
      "urn": "urn:li:activity:7429959579599532032",
      "commentary": "Just published my deep dive into AI trends...",
      "numComments": 16,
      "numReactions": 108,
      "reactionType": {
        "like": 101,
        "interest": 2,
        "appreciation": 3
      },
      "shareUrl": "https://www.linkedin.com/posts/...",
      "time": "2 hours ago",
      "actor": {
        "name": "Jane Smith",
        "url": "https://www.linkedin.com/in/...",
        "followerCount": 15000,
        "profileType": "PERSON"
      },
      "content": {
        "image": null,
        "video": {...},
        "article": null,
        "document": null
      }
    }
  ],
  "totalElements": 483,
  "totalPages": 49,
  "numberOfElements": 10
}

Profile Activities

Fetch recent posts, comments, or reactions for a LinkedIn profile.

Endpoint: POST /profile_activities Credits: 2 per call

Request

curl -X POST https://v3-api.texau.com/api/v1/profile_activities \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urn": "ACoAACcJ11oB9WoP2-S-clw3Q64H9_WmNjCJbbk",
    "type": "POST",
    "size": 10
  }'

Parameters

Field	Type	Required	Description
`urn`	string	Yes	LinkedIn profile entity URN (from enrichment response `entityUrn` field)
`type`	string	No	`POST` (default), `COMMENT`, or `REACTION`
`paginationToken`	string	No	Token from previous response for next page
`size`	integer	No	Results per page (default 10)

Response

{
  "content": [
    {
      "id": "urn:li:activity:7253037834318532608",
      "commentary": "Excited to announce our new product launch...",
      "totalComments": 12,
      "totalReactions": 61,
      "totalShares": 3,
      "reactionType": {
        "like": 53,
        "appreciation": 2,
        "praise": 6
      },
      "url": "https://www.linkedin.com/feed/update/...",
      "time": "2 weeks ago",
      "author": {
        "profileId": "janesmith",
        "firstName": "Jane",
        "lastName": "Smith"
      }
    }
  ],
  "paginationToken": "dXJuOmxpOmFjdGl2aXR5..."
}

Pagination

Use the paginationToken from the response to fetch the next page:

curl -X POST https://v3-api.texau.com/api/v1/profile_activities \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urn": "ACoAACcJ11oB9WoP2-S-clw3Q64H9_WmNjCJbbk",
    "type": "POST",
    "size": 10,
    "paginationToken": "dXJuOmxpOmFjdGl2aXR5..."
  }'

LinkedIn Profile Search

Search LinkedIn profiles by name, title, company, location, and more. Returns a ranked list of matching profiles with pagination.

Endpoint: GET /profile_search Credits: 0.1 per result returned (billed per page)

Request

curl "https://v3-api.texau.com/api/v1/profile_search?currentCompany=13018048&title=Co-Founder&page=1" \
  -H "x-api-key: YOUR_API_KEY"

Query Parameters

Parameter	Type	Required	Description
`search`	string	No	Name search with fuzzy matching
`firstName`	string	No	Strict first name filter
`lastName`	string	No	Strict last name filter
`title`	string	No	Job title filter (e.g. `Co-Founder`)
`currentCompany`	string	No	Company ID or LinkedIn company URL. Comma-separated for multiple
`pastCompany`	string	No	Past company ID or URL. Comma-separated for multiple
`school`	string	No	School ID or URL. Comma-separated for multiple
`location`	string	No	Location text (LinkedIn autocomplete)
`geoId`	string	No	LinkedIn Geo ID. Overrides `location` when both provided
`industryId`	string	No	LinkedIn industry ID. Comma-separated for multiple
`keywordsCompany`	string	No	Company name keyword filter
`keywordsSchool`	string	No	School name keyword filter
`followerOf`	string	No	Filter by followers of a profile URL/ID. Comma-separated for multiple
`page`	integer	No	Page number (1-based, default 1)

At least one query parameter should be provided.

Response

{
  "elements": [
    {
      "publicIdentifier": "janniseller",
      "id": "ACoAAAvXEYIB-lrqOxPPl65MtZ0cDyZTBk_Q3dw",
      "name": "Jannis Eller",
      "position": "Helping growing businesses find the right talent | Co-Founder @ Jomigo",
      "location": {
        "linkedinText": "Berlin"
      },
      "linkedinUrl": "https://www.linkedin.com/in/janniseller",
      "photo": "https://media.licdn.com/dms/image/...",
      "hidden": false
    },
    {
      "publicIdentifier": null,
      "id": "ACr___-spM4BrMlYZsWDBPmx0li6zZw1QccuGW0",
      "name": "LinkedIn Member",
      "position": "Co-founder @LeadsFactory",
      "location": {
        "linkedinText": "France"
      },
      "linkedinUrl": null,
      "photo": "https://media.licdn.com/dms/image/...",
      "hidden": true
    }
  ],
  "pagination": {
    "totalPages": 11,
    "totalElements": 107,
    "pageNumber": 1,
    "previousElements": 0,
    "pageSize": 10,
    "totalResultCount": 107
  },
  "status": 200,
  "error": null,
  "query": {
    "currentCompany": "13018048",
    "title": "Co-Founder"
  }
}

Response Fields

Field	Type	Description
`elements`	array	Array of matching profiles
`elements[].publicIdentifier`	string \| null	LinkedIn public identifier (null if hidden)
`elements[].id`	string	Internal LinkedIn profile ID
`elements[].name`	string	Full name (or "LinkedIn Member" if hidden)
`elements[].position`	string	Current headline / position text
`elements[].location.linkedinText`	string	Location as shown on LinkedIn
`elements[].linkedinUrl`	string \| null	Full LinkedIn profile URL (null if hidden)
`elements[].photo`	string \| null	Profile photo URL
`elements[].hidden`	boolean	Whether profile has limited visibility
`pagination.totalPages`	integer	Total pages available
`pagination.totalElements`	integer	Total matching profiles across all pages
`pagination.pageNumber`	integer	Current page (1-based)
`pagination.pageSize`	integer	Results per page
`status`	integer/string	HTTP status from upstream
`error`	string \| null	Error message (null on success)
`query`	object	Echo of resolved query parameters

Billing Note

Billed at 0.1 credit per result in the elements array. A page returning 10 results costs 1 credit.

Post Details

Fetch full details of a single LinkedIn post including its content, reactions with reactor profiles, and author metadata.

Endpoint: POST /post_details Credits: 1 per call

Request

curl -X POST https://v3-api.texau.com/api/v1/post_details \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urn": "urn:li:activity:7253037834318532608"
  }'

Parameters

Field	Type	Required	Description
`urn`	string	Yes	LinkedIn activity URN (e.g. `urn:li:activity:7253037834318532608`)

Response

{
  "urn": "urn:li:activity:7253037834318532608",
  "threadUrn": "urn:li:activity:7253037834318532608",
  "shareUrn": "urn:li:share:7253037833626546176",
  "commentary": "Excited to announce our Series B...",
  "numComments": 42,
  "numReactions": 318,
  "reactionType": {
    "like": 280,
    "appreciation": 15,
    "praise": 23
  },
  "shareUrl": "https://www.linkedin.com/posts/activity-7253037834318532608-...",
  "actor": {
    "profileId": "janesmith",
    "entityUrn": "ACoAACcJ11oB...",
    "firstName": "Jane",
    "lastName": "Smith",
    "headline": "CEO at Acme Corp",
    "profilePicture": "https://media.licdn.com/dms/image/...",
    "profileType": "PERSON"
  },
  "comments": [],
  "reactions": [
    {
      "reaction": "LIKE",
      "reactor": {
        "profileId": "alexchen",
        "entityUrn": "ACoAAADnqGgB...",
        "firstName": "Alex",
        "lastName": "Chen",
        "headline": "Engineering Manager at Stripe",
        "profilePicture": "https://media.licdn.com/dms/image/...",
        "profileType": "PERSON"
      }
    }
  ]
}

Response Fields

Field	Type	Description
`urn`	string	Activity URN
`threadUrn`	string	Thread URN (same as `urn` for top-level posts)
`shareUrn`	string	Share URN
`commentary`	string	Post text content
`numComments`	integer	Total comment count
`numReactions`	integer	Total reaction count
`reactionType`	object	Breakdown by reaction type (`like`, `appreciation`, `praise`, etc.)
`shareUrl`	string	Public post URL
`actor`	object	Post author profile
`comments`	array	Comments on the post
`reactions`	array	Reactions with full reactor profiles

Post Activities

Fetch paginated comments and reactions on a specific LinkedIn post. Returns a Spring-style paginated response.

Endpoint: POST /post_activities Credits: 3 per call

Request

curl -X POST https://v3-api.texau.com/api/v1/post_activities \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urn": "urn:li:activity:7253037834318532608",
    "type": "COMMENT",
    "size": 10
  }'

Parameters

Field	Type	Required	Description
`urn`	string	Yes	LinkedIn activity URN (e.g. `urn:li:activity:7253037834318532608`)
`type`	string	No	`POST` (default), `COMMENT`, or `REACTION`
`size`	integer	No	Results per page (default 10)
`page`	integer	No	Page number (zero-based, default 0)

Response

{
  "content": [
    {
      "commentary": "Congrats on the raise! Well deserved.",
      "author": {
        "profileId": "alexchen",
        "firstName": "Alex",
        "lastName": "Chen",
        "headline": "Engineering Manager at Stripe"
      },
      "numReactions": 5,
      "time": "2 days ago"
    }
  ],
  "totalElements": 42,
  "totalPages": 5,
  "numberOfElements": 10,
  "size": 10,
  "number": 0,
  "first": true,
  "last": false
}

Pagination

Use page and size to paginate through results (same pattern as people_search):

# Page 2
curl -X POST https://v3-api.texau.com/api/v1/post_activities \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urn": "urn:li:activity:7253037834318532608",
    "type": "COMMENT",
    "size": 10,
    "page": 1
  }'

Was this page helpful?

Last updated 2 weeks ago

Built with Documentation.AI