POST /find_website_by_company_name • Credits: 0.2 credits per call that finds a website

Find Website by Company Name resolves a company name to the website URL of that company. Send a POST request with the company_name parameter. The response holds the website URL in data.Website and a message value. A call that finds a website costs 0.2 credits. A call that finds none returns 404 and costs nothing.

What does Find Website by Company Name do?

A CRM record often holds a company name and nothing else. Almost every enrichment endpoint needs a URL or a domain, not a name. Find Website by Company Name closes that gap. The endpoint takes one company name and returns one website URL. RichAPI resolves the name through an upstream domain-finder provider and returns the result in the same response. One call covers one company name.

Which endpoint does Find Website by Company Name use?

Method: POST
URL: https://api.richapi.ai/api/v1/find_website_by_company_name
Authentication: x-api-key header
Response: synchronous JSON
Credits: 0.2 credits per call that finds a website. A call that finds none costs nothing.

How to send a Find Website by Company Name request

Copy your API key from the RichAPI dashboard.
Set the company_name parameter to the company name.
Send a POST request to https://api.richapi.ai/api/v1/find_website_by_company_name.
Send the API key in the x-api-key header.
Read the data.Website field from the response.
Store that URL against the company record.

CAUTION: Each Find Website by Company Name call that finds a website costs 0.2 credits. Deduplicate the company names in your list before you send the requests.

cURL

curl -X POST https://api.richapi.ai/api/v1/find_website_by_company_name   
  -H "x-api-key: YOUR_API_KEY"   
  -H "Content-Type: application/json"   
  -d '{
    "company_name": "Microsoft"
  }'

Python

import requests

response = requests.post(
    "https://api.richapi.ai/api/v1/find_website_by_company_name",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={"company_name": "Microsoft"},
    timeout=60,
)
response.raise_for_status()
print(response.json())

Node.js

const response = await fetch(
  "https://api.richapi.ai/api/v1/find_website_by_company_name",
  {
    method: "POST",
    headers: {
      "x-api-key": "YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      company_name: "Microsoft",
    }),
  },
);

const data = await response.json();
console.log(data);

Which parameters does Find Website by Company Name accept?

Parameter	Type	Required	Default	Description
`company_name`	string	Yes	`""`	The company name to resolve, for example `Microsoft`.
`company_domain`	string	No	`""`	The company website domain, for example `stripe.com`. It tells apart companies with similar names.

The endpoint accepts these two parameters and no other. A request body with any other key returns a 400 error. The error response then holds a supported_fields object that names the accepted parameters.

What does the Find Website by Company Name response look like?

The block below is an example response for the request body {"company_name": "Microsoft"}. The field names are exact. The URL value is illustrative.

{
  "data": {
    "Website": "https://www.microsoft.com/"
  },
  "message": "success"
}

When no website matches, the response has the HTTP status 404 and this body. The call costs no credit.

{
  "data": {
    "Website": null
  },
  "message": "not_found"
}

RichAPI also adds a richapi_meta object to every response, with the request ID and the credits charged.

Which fields does the Find Website by Company Name response hold?

Field	Type	Description
`data`	object	The result of the lookup.
`data.Website`	string or null	The official company website URL. The field name starts with a capital `W`. `null` when no website matches.
`message`	string	`success` when a website matches. `not_found` when none matches.

What happens when a company name is ambiguous?

Find Website by Company Name takes the company name and an optional company_domain hint. The endpoint takes no country and no industry. If you know the domain, send it in company_domain, and RichAPI prefers the website on that domain. A short or generic name matches more than one real company, and the response still holds one data.Website value. RichAPI returns that single value without a ranked list and without alternatives.

Three habits keep an ambiguous match under control.

Send the full legal name, and not the trading short form.
Verify the returned URL before you write it to the CRM.
Compare the company name in the verification response with the name that you sent.

To verify a returned URL for 1 extra credit, send it to Social Links Finder API. Read the data.links.linkedin value. For a deeper check at 5 extra credits, send the URL to Website Intelligence API. Read the meta tags of the page.

Does Find Website by Company Name return a confidence score?

No. The Find Website by Company Name response holds data.Website and message, and it holds no confidence field, no score and no match probability. Treat every returned URL as a candidate until a second call verifies it.

How to reach firmographics from a bare company name

A company name alone unlocks nothing. A website URL unlocks the whole RichAPI web family, because Website Intelligence API and Social Links Finder API both take a url parameter. Find Website by Company Name is the first call in that chain, and it costs 0.2 credits when it finds a website.

How to get a full website report from a company name

Step	Endpoint	Input	Credits
1	`find_website_by_company_name`	The company name	0.2
2	`website_intelligence`	The `data.Website` value from step 1	5
Total			5.2

One company costs 5.2 credits, and 5.2 credits cost $0.104. 1,000 companies cost 5,200 credits, and 5,200 credits cost $104.00.

How to get social profiles from a company name

Step	Endpoint	Input	Credits
1	`find_website_by_company_name`	The company name	0.2
2	`web_social_links`	The `data.Website` value from step 1	1
Total			1.2

One company costs 1.2 credits, and 1.2 credits cost $0.024. 1,000 companies cost 1,200 credits, and 1,200 credits cost $24.00.

How to get LinkedIn firmographics from a company name

Company Enrichment API accepts a LinkedIn company URL and no other identifier. Social Links Finder returns that URL under the linkedin key, so three calls take a bare name to a full company record.

Step	Endpoint	Input	Credits
1	`find_website_by_company_name`	The company name	0.2
2	`web_social_links`	The `data.Website` value from step 1	1
3	`enrich_company`	The first `data.links.linkedin` value from step 2	1
Total			2.2

One company costs 2.2 credits, and 2.2 credits cost $0.044. 1,000 companies cost 2,200 credits, and 2,200 credits cost $44.00.

How to deduplicate the chain before you pay for it

Two CRM records that name the same company resolve to the same website. A duplicate then pays the full chain price a second time. Clean Domain API costs 0.5 credits and returns the root domain of a URL.

Send one Find Website by Company Name request for each company name.
Send the data.Website value of each response to Clean Domain.
Group the records by the clean_domain value.
Keep one record for each group.
Send the chain step 2 request once for each group.

CAUTION: Do not send a 5-credit Website Intelligence call for a duplicate company. One 0.5-credit Clean Domain call that removes one duplicate saves 4.5 credits.

How much does Find Website by Company Name cost?

Find Website by Company Name costs 0.2 credits for a call that finds a website. One credit costs $0.02 on the 1,000 and 5,000 credit packs, so one call costs $0.004 there. Larger packs cost less per credit. A call that finds no website returns 404 and costs nothing. A 4xx error and a 5xx error cost no credit.

Calls that find a website	Credits	Cost
1	0.2	$0.004
100	20	$0.40
1,000	200	$4.00
10,000	2,000	$40.00

CAUTION: A 200 response is a billed call, even when the website is not the company you meant. Verify the returned URL before you pay for the next step of a chain.

Which errors can Find Website by Company Name return?

Status	Meaning	What to do
`400`	The request body is not valid JSON, `company_name` is missing, or the body holds a field other than `company_name` and `company_domain`.	Send a JSON object with `company_name`, and `company_domain` if you have it. Read the `supported_fields` object in the error response.
`401`	The API key is missing, wrong or revoked.	Send a valid key in the `x-api-key` header.
`402`	`Insufficient credits`: the organization has too few credits. Or `Monthly spend limit reached`: the team hit its monthly spend limit.	Buy credits in the RichAPI dashboard, or ask the organization owner to raise the spend limit.
`403`	`Endpoint not available on your plan`: this API key has no access to this endpoint.	Call `GET /api/v1/my-endpoints` to list the endpoints this key can use. Contact support for access.
`404`	No website matches the name, and `message` is `not_found`. Or the endpoint name is wrong.	Check the company name, or add `company_domain`. Check that the request goes to `/find_website_by_company_name`.
`405`	The request used a method other than `POST`.	Send the request again with the `POST` method.
`429`	The account passed its rate limit.	Read the `Retry-After` header. Wait that many seconds, then send the request again.
`500`	The API failed.	Send the request again. If the failure repeats, contact support.
`503`	The lookup is temporarily unavailable, and `message` is `unavailable`.	Send the request again after a short wait.

Every error response holds a text message that names the problem. None of these errors costs a credit.

Frequently asked questions

How do I find a company website from only a company name?

Send a POST request to https://api.richapi.ai/api/v1/find_website_by_company_name with the body {"company_name": "Microsoft"}. The response holds the website URL in data.Website. A call that finds a website costs 0.2 credits, and 0.2 credits cost $0.004 on the 1,000 and 5,000 credit packs.

Does Find Website by Company Name return a confidence score for the match?

No. The response holds data.Website and message only. To confirm a match, send the returned URL to Website Intelligence API for 5 credits or to Social Links Finder API for 1 credit.

What does Find Website by Company Name cost for 1,000 companies?

1,000 calls that each find a website cost 200 credits, and 200 credits cost $4.00. Calls that find no website cost nothing. A full chain to a website report costs 5.2 credits per company, so 1,000 companies cost 5,200 credits and $104.00.

Can I send a company name straight to Company Enrichment?

No. Company Enrichment API accepts a LinkedIn company URL only. Send Find Website by Company Name first, then send the website to Social Links Finder API. Send the linkedin value from that response to Company Enrichment.

Is Find Website by Company Name synchronous?

Yes. Find Website by Company Name returns the website URL in the same response. The endpoint needs no second call, no polling and no webhook.

Does the endpoint return a bare domain or a full URL?

The data.Website field holds a full URL, such as https://www.microsoft.com/. For the root domain alone, send that value to Clean Domain API and read the clean_domain field.

Find Website by Company Name API