Domains
When Addressfinder receives a query, the verification service checks if the provided license key is valid and if the domain the query comes from is listed in your organisation's Portal.
This ensures that if someone else tries to use your license key, only websites and domains you allow are able to use your Addressfinder subscription.
- Agile organisations can use Addressfinder on up to 10 domains at once.
- Business organisations can use Addressfinder on up to 30 domains at once.
Custom domain allowances can be made available on request as an add-on.
Using domains to identify usage
Domains can be used for tracking within the Addressfinder web portal where your various API activity occurs.
When using the widget, the address lookups used are counted against the domain of the website.
When using the API, the lookups are not necessarily coming from a website and lookups would be attributed to the “unknown” domain within the portal. By including a domain in each API string, the activity of the API would be attributed to that domain.
If you are using the API in a number of places within your organisation, we suggest you include a different domain for each different use case.
For example: domain=iphoneapp.crm, domain=androidapp.crm, domain=callcentre.crm
Subdomains
Adding a domain name without subdomains will allow all queries from that domain and is the best option for most organisations.
You can use subdomains to fine tune access or split usage records in the Portal. For example, if you add shop.example.com and internal.example.com to your domains, you will be able to control and see usage for each subdomain individually.
Each subdomain you add to your account will count towards your domains limit.
Best practices
Do not add www in front of your domain
No. Including the www prefix is not required and in most cases.
Keep portal.addressfinder.net in your allowlist
By default, we add the Addressfinder Portal as one of your organisation domains. This allows you to use the verification tools inside the Portal.
If you remove it, the verification tools in the Portal will stop working and return errors. This doesn't affect your integrations.
You can add portal.addressfinder.net back to your listed domains anytime to enable it again.
What is localhost?
localhost is a special domain that refers to your own computer when testing software locally instead of on a website. We add it to your organisation domains by default to help developers test their advanced integrations on their own machines.
You can safely remove it from your allowlist without affecting your integrations.
How do I deactivate a domain from Addressfinder?
You can remove a domain in the Domains section in the Portal. Removing a domain will immediately stop queries from that domain from being accepted by Addressfinder.