Enrich your account list with LinkedIn company data
Turn company LinkedIn URLs or names into JSON with description, industry, size, headquarters, website and followers, to enrich CRM accounts and score them.
Your CRM has account names, but the fields that decide who gets a call (industry, size, headquarters, website) are blank or years old. Filling them by hand takes a minute per account. Lovely Router reads the LinkedIn company page for you. Send company URLs or names, get one JSON object per company, pay per company from a prepaid balance. Run it on a new import or on a schedule, from a script or an AI agent.
Hand it to your AI agent
Copy this prompt into Claude Code, Cursor, Codex or any coding agent. It tells the agent where the docs are and how to use your API key.
Enrich your account list with LinkedIn company data. Use the Lovely Router data tools: each returns JSON and is billed per result.
- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.
My task: <the inputs (links, keywords or accounts) and how many results you need>How it works
Collect the accounts
Export the LinkedIn company URLs you have, or just the company names for the ones you do not.
Run the tool with a cap
Send URLs in
companiesand names insearchestoPOST /v1/tools/linkedin-company/runwithmax_results. The run holds its maximum cost from your balance.Write the fields back
Match each result to its account and update industry, size, headquarters, website and followers. Keep the run date so you know how fresh the data is.
Enrich accounts with one request
Get LinkedIn companies takes company page URLs in companies, or company names in searches for the ones you cannot link. One run reads up to 50 companies:
curl https://lovelyrouter.com/v1/tools/linkedin-company/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"companies": [
"https://www.linkedin.com/company/google"
]
},
"max_results": 3
}'Check names you passed in searches against the result before you write them back, since a name can match more than one company. A run still going after 60 seconds returns 202; Run a tool shows how to poll.
What each company holds
| Field group | What you get |
|---|---|
| Identity | Company name and description |
| Classification | Industry and company size |
| Location | Headquarters |
| Web | Website |
| Reach | Followers |
This is firmographic data from the company page. People at the company are a separate job; see the pairings below.
Recipes
Export accounts missing industry or size, run their LinkedIn URLs in batches of 50, and write the fields back with a script.
Use industry and size as the first filter of your ideal customer profile, and sort the rest by followers as a rough sign of brand reach.
Put a list of company names in searches and check the website and headquarters of each match before you add it to your territory.
Group a trade-show attendee list by industry and size, so each segment gets copy written for it.
Re-run the whole account base once a quarter and flag accounts whose size band or headquarters changed.
Prefer plain words? Connect the MCP server and tell Claude Code or Cursor: "Read these 40 company URLs from accounts.csv with the linkedin-company tool, and give me a table of name, industry, size, headquarters and website. Set max_results to 40."
Pair it with account and people data
A company page tells you who the account is. These tools tell you who to talk to and what is happening there:
LinkedIn company pages: description, industry, size, headquarters, website, followers.
Search LinkedIn companies by keyword, location and size: name, industry, size, URL.
Employees of LinkedIn companies, filterable by job title, location and keyword: name, headline, position, profile URL.
Crawl websites and extract emails, phone numbers and social profile links. One result = one website (up to 5 of its pages crawled, contacts merged).
linkedin-company-searchfinds new accounts by keyword, location and size to add to the list.linkedin-company-employeeslists the people at an enriched account.website-contactsreads the company website for contact details.
For the full prospecting workflow, see lead generation.
What you pay
You pay per company: starting a run holds its maximum cost, the per-call fee plus the per-company fee times max_results, and the run settles to what it returned. The rest of the hold goes back to your balance. A run that fails or times out pays only for the companies it delivered, and a run refused at the start costs nothing.
Enriching 500 accounts is billed as 500 companies. There is no subscription and no monthly minimum: top up from $5, and one balance pays for tools and models. The card above shows today's price; pricing lists every tool.
Frequently asked questions
Can I look up a company by name?+
Yes. Put names in searches and the tool searches LinkedIn for them. If you have the page URL, pass it in companies instead, which avoids a wrong match.
How many companies can one run read?+
Up to 50. For a bigger list, start several runs; up to 10 can be in progress on your account at once.
Does it list a company's employees?+
No. It returns the company page fields. To list people, use linkedin-company-employees.
How fresh is the data?+
Each run reads the page at the time of the run, so the fields are as current as LinkedIn's own page.
Do I need a subscription?+
No. You add credit to a prepaid balance and each run draws it down. Failed runs pay only for the results they delivered, and nothing renews automatically.
Building the account list from scratch? See lead generation, and the rest of the tool catalog. Run settings are in Run a tool.