Get your first result

Quickstart

Prefer no code? Open the dashboard to run requests and download results.

Using the API? Get your API key and replace key_live_xxxx below. You get $6 of free usage each month, no card required.

curl "https://crustapi.com/v1/linkedin?type=refresh&url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fdharmesh" \
  -H "x-api-key: key_live_xxxx"

{
  "publicIdentifier": "dharmesh",
  "accessible": true,
  "profileState": "accessible",
  "firstName": "Dharmesh",
  "lastName": "Shah",
  "headline": "Founder and CTO at HubSpot. Helping millions grow better.",
  "currentTitle": "Founder and CTO",
  "titleSource": "headline",
  "currentCompany": {
    "name": "HubSpot",
    "slug": "hubspot",
    "linkedInUrl": "https://www.linkedin.com/company/hubspot",
    "linkedInId": "68529"
  },
  "currentSchool": {
    "name": "Massachusetts Institute of Technology",
    "slug": "mit",
    "linkedInUrl": "https://www.linkedin.com/school/mit",
    "linkedInId": "1503"
  }
}

LinkedIn

Refresh people records, read profiles and companies, or search people, posts and jobs. All LinkedIn data comes from public, logged-out sources.

People database refresh

Send the LinkedIn URLs you already have. Refresh returns available current employers, company and school IDs, names, headline/title data, photo and profile status. Compare the response with your stored record to identify changes.

Refresh fields are at the response root. Use batch requests for a list, or try Refresh in the app. For employment history and other profile sections, use type=person.

Choose a LinkedIn operation

Fields vary by profile and operation. Null values and empty sections mean the information was not returned; they do not prove it does not exist. The OpenAPI reference describes the response structures.

Billing

Person, Company, Posts, People and Jobs each use their endpoint’s rate per successful request. People with enrich=true bills per full profile returned. Refresh bills per accessible profile. Work email lookup is included; a successful profile is billable even if no email is found. See current prices.

Google

One endpoint, one parameter that picks the Google surface. Change type, keep everything else the same.

The surfaces you can ask for:

Google Maps response fields

For type=maps, businesses are returned in places. Field availability varies by listing, category and country. A missing phone or website stays empty.

Common parameters

The full machine-readable spec lives at /v1/openapi.json. Point your tooling or your agent at it.

Freshness

Every search is fetched when you ask for it. We never return an older result in place of a failed fetch: if we cannot complete your search, you get an error, it is free, and you can retry. The one exception is small and always disclosed. If you send the same search again within 60 seconds, you may get the answer from the first one, and when that happens the response says so with "cached": true and "cacheAgeSeconds". Add &fresh=1 to force a new fetch every time.

Rate limits

Some search types take longer to fetch than others, so each key has a limit on how many of them can be in flight at the same time. Send up to the limit, wait for the responses, then send more. Requests over the limit get a 429 with a Retry-After header. If we are briefly at capacity, your request may wait a few seconds before it is served or returned as a 429. Rate-limited calls are never charged.

Maps, places, reviews, autocomplete, patents, webpage and the LinkedIn endpoints have no in-flight limit. If your project needs more than the paid limit, talk to us and we will set it up.

Bulk lists and webhooks

Send up to 100 URLs to POST /v1/linkedin/batch. Supported types are refresh, person (alias profile), company and posts. Results stay in input order, with a separate success or error for each row.

The response contains a results array. Each row includes url, ok, and data or error. data contains the operation’s payload without the single-request billing/timing envelope. Inaccessible rows are uncharged; inspect data.accessible or notAccessible when present.

Async delivery, up to 10,000 URLs

Add a public HTTPS webhook URL. The API returns HTTP 202 with a jobId, then POSTs the completed batch to your webhook. The X-Crustapi-Job header identifies the delivery.

Large result sets may be delivered as resultsUrl with resultsBytes and resultsExpireAt. Download the JSON before that expiry; the temporary file is then deleted. Save inline webhook results in your own system.

The status endpoint returns job status, counts and delivery information, not result rows. Use the same account’s API key. Webhooks must have no embedded credentials; redirects are not followed and a failed delivery is retried once.

Options: member: true for Refresh and comments: true for posts. Batch does not support employees=true. Each successfully delivered row uses the chosen endpoint’s rate; unavailable results and malformed URLs are uncharged.

CLI

Prefer the terminal? Install the CLI and get the same data from your shell, as JSON or CSV.

Output is JSON by default and pipes cleanly, the status line goes to stderr so your pipes stay clean. Pass --csv for CSV. It's on npm as crustapi-cli.

MCP for AI assistants

Give Claude Desktop, Cursor, Cline, or any MCP client Google and public LinkedIn data. With Node.js installed, npx runs it. Add this to your client config and restart it.

Four tools appear. search is the whole menu behind one call, scrape_webpage turns any URL into clean text you can feed straight to an AI (RAG), and get_reviews pulls Google reviews for a business. The package is on npm as crustapi-mcp. The fourth, linkedin, is the LinkedIn menu: profiles, companies, jobs, posts and people search.

For People Refresh, call /v1/linkedin?type=refresh through your agent’s HTTP tool. The published MCP package currently exposes profile, company, posts, jobs and people search.

Integrations

Use CrustAPI from any tool that supports HTTP requests and custom headers.

Connect with HTTP requests

Add an HTTP request step in your tool. Choose GET, enter the endpoint and query parameters below, and add your API key in the x-api-key header. Replace the values in {{braces}} with fields from your workflow.

Refresh a person

Pass a LinkedIn profile URL as url. Map currentCompany.name, currentCompany.linkedInId, currentTitle, titleSource and profileState into your workflow or spreadsheet. Compare against your saved employer/title and preserve existing values when the result is unavailable.

Find a local business

Map places[0].website, places[0].phone, places[0].address, places[0].totalScore and places[0].reviewsCount. Check the returned name, address and website before accepting a match. This is a business search; the first result is not a guaranteed domain-to-company match.

Keep API keys in your tool’s credential settings. Use the returned JSON fields in the next step of your workflow.

AI agents

Use the MCP server for its supported tools, or the HTTP API for Refresh and other endpoint options. Give your agent llms.txt for usage guidance and the OpenAPI specification for request and response schemas.

Agent payments (x402)

Your agent doesn't need a signup, a card, or a key to start. It can buy its own credits with x402, the open HTTP payment standard. If your agent framework already speaks x402, this works with no extra code from you.

Here's the whole handshake.

From there the key works like any other. The agent calls /v1/search and spends the credits it just bought.

The 402 challenge

Call the top-up endpoint with no key and you get back the payment terms.

After payment

Your x402 client signs the authorization and retries. We settle it and return a key that's ready to use.

A few things worth knowing:

• Payment is USDC on Base, and it's gasless. Your agent signs an authorization, so it doesn't need ETH to pay for gas.
• The agent pack is a $5 first deposit for 2,500 credits. The bigger packs work the same way, just pass a different pack as you scale up.
• This keyless x402 path uses its own credit packs and creates a separate agent key. It does not add USD funds to an existing dashboard wallet. Its returned pack price and credit quantity remain authoritative. Empty results are free.

Ask your AI

Still have questions? Copy this md file with detailed product description to ask your agent about it.

Get product description

Download as markdown Open in browser

Agents can fetch it directly at crustapi.com/llms.txt.