Everything you need to integrate the RichAPI API into your product.
Resolve a location name to a LinkedIn Geo ID for use with profile and lead search filters.
/api/v1/geo_id_searchParameters
| Field | Type | Required | Description |
|---|---|---|---|
search | string | Yes | Location name to search (e.g. 'San Francisco', 'London') |
Example response
{
"elements": [
{
"geoId": "example",
"title": "example"
}
]
}Code
curl -X POST https://dev-api.richapi.ai/api/v1/geo_id_search \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"search": "San Francisco"
}'Try it
Sign in to test this endpoint with your API key.
Sign in to tryScrape Google Search results synchronously.
/api/v1/google_search_scraper_syncParameters
| Field | Type | Required | Description |
|---|---|---|---|
search_query | string | Yes | Search query string |
limit | int | No | Maximum number of result pages to fetch (max 100) |
Example response
{
"url": "example",
"title": "example",
"description": "example"
}Code
curl -X POST https://dev-api.richapi.ai/api/v1/google_search_scraper_sync \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"search_query": "best CRM software 2025",
"limit": 2
}'Try it
Sign in to test this endpoint with your API key.
Sign in to trySearch for employees of a specific company using its LinkedIn URL.
/api/v1/linkedin_company_employees_searchParameters
| Field | Type | Required | Description |
|---|---|---|---|
company_linkedin_url | string | Yes | LinkedIn URL of the company |
page | int | No | Page number for pagination |
Example response
{
"elements": [
{
"name": "example",
"position": "example",
"linkedinUrl": "example"
}
],
"pagination": {}
}Code
curl -X POST https://dev-api.richapi.ai/api/v1/linkedin_company_employees_search \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"company_linkedin_url": "https://www.linkedin.com/company/google",
"page": 1
}'Try it
Sign in to test this endpoint with your API key.
Sign in to trySearch LinkedIn companies by name, location, size, and industry. Returns company profiles with follower counts and summaries.
/api/v1/linkedin_company_searchParameters
| Field | Type | Required | Description |
|---|---|---|---|
page | int | No | Page number for pagination (1-based, default 1). |
search_query | text | No | Keywords to search for in company names. |
location | text | No | Filter companies by location (LinkedIn autocomplete; may be ambiguous - use geoId for precision). |
geo_id | text | No | LinkedIn Geo ID - overrides location; use geo_id_search to resolve. |
company_size | text | No | Comma-separated size ranges: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+. |
linkedin_industry_id | text | No | LinkedIn industry ID. Comma-separated for multiple. |
Example response
{
"error": null,
"query": {
"page": 1,
"search": "Google",
"location": "United States"
},
"status": 200,
"elements": [
{
"id": "123456",
"logo": "https://media.licdn.com/dms/image/example-logo.jpg",
"name": "TexAu",
"summary": "Automation platform for growth teams.",
"industry": "Software Development",
"location": {
"linkedinText": "United States"
},
"followers": "2K followers",
"linkedinUrl": "https://www.linkedin.com/company/texauhq/",
"universalName": "texauhq"
}
],
"pagination": {
"pageNumber": 1,
"totalPages": 1,
"totalElements": 1
}
}Code
curl -X POST https://dev-api.richapi.ai/api/v1/linkedin_company_search \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"page": 1,
"search_query": "Google",
"location": "United States",
"geo_id": "103644278",
"company_size": "51-200,201-500",
"linkedin_industry_id": "96"
}'Try it
Sign in to test this endpoint with your API key.
Sign in to trySearch LinkedIn jobs by title, company, location, and more.
/api/v1/linkedin_job_searchParameters
| Field | Type | Required | Description |
|---|---|---|---|
title | string | No | Job title keyword |
company | string | No | Company name or LinkedIn company URL |
location | string | No | Location text filter |
geoId | string | No | LinkedIn Geo ID for precise location filtering |
jobType | string | No | full_time, part_time, contract, temporary, internship, volunteer, other |
experienceLevel | string | No | internship, entry_level, associate, mid_senior_level, director, executive |
page | int | No | Page number for pagination |
Example response
{
"elements": [
{
"id": "example",
"title": "example",
"location": {
"linkedinText": "example"
},
"companyName": "example"
}
]
}Code
curl -X POST https://dev-api.richapi.ai/api/v1/linkedin_job_search \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Software Engineer",
"company": "example",
"location": "San Francisco",
"geoId": "example",
"jobType": "example",
"experienceLevel": "example",
"page": 1
}'Try it
Sign in to test this endpoint with your API key.
Sign in to trySearch LinkedIn profiles by company/account and contact filters such as domain, industry, employee size, job title, and location.
/api/v1/people_searchParameters
| Field | Type | Required | Description |
|---|---|---|---|
page | int | Yes | Page number, zero-based. |
limit | int | Yes | Number of items per page. |
linkedin | array | No | LinkedIn account URLs. |
domain | array | No | Company domains. |
industry | array | No | Industry names. |
employee_size_start | int | No | Minimum employee count. |
employee_size_end | int | No | Maximum employee count. |
job_title | array | No | Job titles to match. |
location | array | No | Locations to match. |
Example response
{
"last": true,
"size": 10,
"first": true,
"number": 0,
"content": [
{
"url": "example",
"headline": "example",
"lastname": "example",
"firstname": "example"
}
],
"totalPages": 1,
"totalElements": 1,
"numberOfElements": 1
}Code
curl -X POST https://dev-api.richapi.ai/api/v1/people_search \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"page": 0,
"limit": 10,
"linkedin": [
"https://www.linkedin.com/company/openai/"
],
"domain": [
"openai.com"
],
"industry": [
"Software Development"
],
"employee_size_start": 50,
"employee_size_end": 500,
"job_title": [
"CTO",
"VP Engineering"
],
"location": [
"United States"
]
}'Try it
Sign in to test this endpoint with your API key.
Sign in to tryGet likes, comments and reactions on a specific LinkedIn post.
/api/v1/post_activitiesParameters
| Field | Type | Required | Description |
|---|---|---|---|
urn | string | Yes | LinkedIn activity URN, e.g. urn:li:activity:7458532524865232896. |
type | string | No | Activity type to return: COMMENT or REACTION. |
page | int | No | Page number, zero-based. |
limit | int | No | Number of items per page. |
Example response
{
"last": false,
"first": true,
"content": [
{
"id": "urn:li:comment:(activity:7247006450986688512,7247533617868873728)",
"url": "https://www.linkedin.com/feed/update/...",
"comment": "Congratulations! It's inspiring to see...",
"commenter": {
"lastName": "Smith",
"firstName": "Jane",
"profileId": "jane-smith"
},
"reactionType": {
"like": 1
},
"totalComments": 0,
"totalReactions": 1
}
],
"totalPages": 20,
"totalElements": 382,
"numberOfElements": 10
}Code
curl -X POST https://dev-api.richapi.ai/api/v1/post_activities \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urn": "urn:li:activity:7458532524865232896",
"type": "COMMENT",
"page": 0,
"limit": 10
}'Try it
Sign in to test this endpoint with your API key.
Sign in to tryGet full post details including text, media, comments and reaction counts.
/api/v1/post_detailsParameters
| Field | Type | Required | Description |
|---|---|---|---|
urn | string | Yes | LinkedIn activity URN, e.g. urn:li:activity:7458532524865232896. |
comments | bool | No | Include comments list in response. Defaults to true. |
reactions | bool | No | Include reactions list in response. Defaults to true. |
Example response
{
"urn": "example",
"actor": {},
"content": {
"document": {}
},
"comments": [
{
"commenter": {}
}
],
"shareUrl": "example",
"shareUrn": "example",
"reactions": [
{
"reactor": {}
}
],
"sponsored": true,
"threadUrn": "example",
"commentary": "example",
"numComments": 1,
"numReactions": 1,
"reactionType": {}
}Code
curl -X POST https://dev-api.richapi.ai/api/v1/post_details \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urn": "urn:li:activity:7458532524865232896",
"comments": true,
"reactions": true
}'Try it
Sign in to test this endpoint with your API key.
Sign in to trySearch LinkedIn posts by keyword to discover trending content and engagement opportunities.
/api/v1/post_keyword_searchParameters
| Field | Type | Required | Description |
|---|---|---|---|
keyword | string | Yes | Keyword or phrase to search LinkedIn posts for. |
page | int | No | Page number, zero-based. |
limit | int | No | Results per page, 1-50. |
sort | string | No | Sort order: RELEVANCE or DATE_POSTED. |
datePosted | string | No | Date filter: PAST_24_HOURS, PAST_WEEK, or PAST_MONTH. |
contentType | string | No | Content type: VIDEO, IMAGE, JOB, LIVE_VIDEO, DOCUMENT, or COLLABORATIVE_ARTICLE. |
fromPerson | array | No | Filter by person entity URNs |
fromCompany | array | No | Filter by company entity URNs |
authorKeyword | array | No | Filter by author job titles |
authorIndustry | array | No | Filter by author industry |
Example response
{
"last": true,
"first": true,
"content": [
{
"urn": "urn:li:activity:7429959579599532032",
"time": "2 hours ago",
"actor": {
"url": "https://www.linkedin.com/in/...",
"name": "Jane Smith",
"profileType": "PERSON",
"followerCount": 15000
},
"content": {
"image": null
},
"shareUrl": "https://www.linkedin.com/posts/...",
"commentary": "Just published my deep dive into AI trends...",
"numComments": 16,
"numReactions": 108,
"reactionType": {
"like": 101,
"interest": 2,
"appreciation": 3
}
}
],
"totalPages": 1,
"totalElements": 1,
"numberOfElements": 1
}Code
curl -X POST https://dev-api.richapi.ai/api/v1/post_keyword_search \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keyword": "artificial intelligence",
"page": 0,
"limit": 10,
"sort": "DATE_POSTED",
"datePosted": "PAST_WEEK",
"contentType": "VIDEO",
"fromPerson": [],
"fromCompany": [],
"authorKeyword": [],
"authorIndustry": []
}'Try it
Sign in to test this endpoint with your API key.
Sign in to trySearch LinkedIn profiles by name, title, company, location and more.
/api/v1/profile_searchParameters
| Field | Type | Required | Description |
|---|---|---|---|
search | string | No | Name to search (supports fuzzy matching) |
first_name | string | No | Strict first-name filter |
last_name | string | No | Strict last-name filter |
title | string | No | Job title filter |
current_company | string | No | Company ID or LinkedIn URL; comma-separated for multiple |
past_company | 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) |
geo_id | string | No | LinkedIn Geo ID — overrides location; use geo_id_search to resolve |
industry_id | string | No | Industry ID; comma-separated for multiple |
page | int | No | Page number for pagination (1-based) |
follower_of | string | No | Filter profiles following a LinkedIn profile. URL or ID. Comma-separated. |
keywords_company | string | No | Keyword filter on company name |
keywords_school | string | No | Keyword filter on school name |
Example response
{
"elements": [
{
"name": "example",
"position": "example",
"linkedinUrl": "example",
"publicIdentifier": "example"
}
],
"pagination": {}
}Code
curl -X POST https://dev-api.richapi.ai/api/v1/profile_search \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"search": "John Doe",
"first_name": "example",
"last_name": "example",
"title": "CEO",
"current_company": "example",
"past_company": "example",
"school": "example",
"location": "example",
"geo_id": "example",
"industry_id": "example",
"page": 1,
"follower_of": "example",
"keywords_company": "example",
"keywords_school": "example"
}'Try it
Sign in to test this endpoint with your API key.
Sign in to trySearch Bing and get structured SERP results with titles, URLs, and descriptions.
/api/v1/search_bingParameters
| Field | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query string |
limit | int | Yes | Number of results to return (default 10, max 50) |
page | int | No | Page number for pagination |
Example response
{
"results": [
{
"url": "example",
"title": "example",
"position": 1,
"description": "example"
}
]
}Code
curl -X POST https://dev-api.richapi.ai/api/v1/search_bing \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "texau automation",
"limit": 10,
"page": 1
}'Try it
Sign in to test this endpoint with your API key.
Sign in to tryGet Google Trends data: interest over time, related queries, and rising queries for any keyword.
/api/v1/search_google_trendsParameters
| Field | Type | Required | Description |
|---|---|---|---|
keyword | string | Yes | Keyword to fetch trend data for |
geo | string | No | Country code to filter by (e.g. US, GB); omit for worldwide |
timeframe | string | No | Time range (e.g. today 12-m, today 5-y); default today 12-m |
Example response
{
"relatedTopics": {},
"relatedQueries": {},
"interestOverTime": []
}Code
curl -X POST https://dev-api.richapi.ai/api/v1/search_google_trends \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keyword": "chatgpt",
"geo": "US",
"timeframe": "example"
}'Try it
Sign in to test this endpoint with your API key.
Sign in to tryReturns all valid filter labels (seniority levels, industries, functions, etc.) for use with Lead Search.
/api/v1/search_reference_dataExample response
{
"function": [],
"industry": [],
"geography": [],
"seniority": [],
"companySize": []
}Code
curl -X POST https://dev-api.richapi.ai/api/v1/search_reference_data \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'Try it
Sign in to test this endpoint with your API key.
Sign in to try