Leadfeeder Discover API v1 Authentication Companies Schemas API Versioning Changelog Industry names reference Leadfeeder Discover API v1 Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu. Leadfeeder Discover API allows you to uncover company information related to an IPv4 or IPv6 address. Description of this API's endpoints can also be downloaded in OpenAPI format. Looking for Leadfeeder API documentation? You can access it here. Base URLs: https://api.lf-discover.com Authentication API Key (ApiKeyAuth) Parameter Name: X-API-KEY, in: header. Companies get__companies Code samples # You can also use wget curl -X GET https://api.lf-discover.com/companies?ip=string \ -H 'Accept: application/json' \ -H 'X-API-KEY: API_KEY' GET /companies Returns company information based on the IP parameter. Parameters Name In Type Required Description ip query string true A valid IPv4 or IPv6 address. Detailed descriptions ip: A valid IPv4 or IPv6 address. For IPv6, shortened notation is supported, but literal addresses as a part of URI are not. I.e. 2620:0:862:ed1a::1 will succeed, but [2620:0:862:ed1a::1] will return an error response with HTTP status code 400. Example responses 200 Response { "id": "beb6f4e2-52c1-11e8-9800-2f635e37af1b", "ip_address": "185.70.216.139", "company": { "revenue": { "year": "2018", "amount": "2588745.28" }, "business_ids": [ { "country_code": "FI", "key": "business_id", "value": "2457101-9" } ], "social": { "twitter": "https://twitter.com/leadfeederapp", "facebook": "https://facebook.com/Leadfeeder", "linkedin": "https://linkedin.com/company/3833060" }, "domain": "leadfeeder.com", "industries": { "name": "Internet", "sic": [ "7374" ], "naics": [ "string" ] }, "name": "Leadfeeder", "employees_range": { "min": "51", "max": "200" } }, "location": { "city": "Písek", "region": "Jihocesky Kraj", "country_code": "CZ" } } Responses Status Meaning Description Schema 200 OK Success Company 400 Bad Request The request contains wrong or incorrectly formatted arguments. Error 401 Unauthorized The incoming request could not be authenticated. Error 403 Forbidden The client whose API key is used does not have the required privileges to perform the request, or the key is no longer valid. Error 404 Not Found The company information tied to this IP address was not found. Error 429 Too Many Requests The limit of the number of requests per minute has been exceeded, or the quota associated with the given API key has been exhausted. Error 500 Internal Server Error There was an error processing the request. Error 502 Bad Gateway Bad gateway error. There was a problem connecting to the backend.. Error 504 Gateway Time-out Gateway timeout error. The backend did not respond within the time out limit. Error To perform this operation, you must be authenticated by means of one of the following methods: ApiKeyAuth Schemas Company { "id": "beb6f4e2-52c1-11e8-9800-2f635e37af1b", "ip_address": "185.70.216.139", "company": { "revenue": { "year": "2018", "amount": "2588745.28" }, "business_ids": [ { "country_code": "FI", "key": "business_id", "value": "2457101-9" } ], "social": { "twitter": "https://twitter.com/leadfeederapp", "facebook": "https://facebook.com/Leadfeeder", "linkedin": "https://linkedin.com/company/3833060" }, "domain": "leadfeeder.com", "industries": { "name": "Internet", "sic": [ "7374" ], "naics": [ "string" ] }, "name": "Leadfeeder", "employees_range": { "min": "51", "max": "200" } }, "location": { "city": "Písek", "region": "Jihocesky Kraj", "country_code": "CZ" } } Properties Name Type Required Restrictions Description id string false none none ip_address string false none none company object false none Company profile information. » revenue object false none Latest available company revenue information. »» year string¦null false none Year when the revenue was reported. »» amount string¦null false none Amount in USD. » business_ids [object] false none Company business IDs. Can have multiple entries If the company is registered in more countries. »» country_code string false none An ISO 3166-1 alpha-2 country code. »» key string false none A short, country-specific business ID identifier. »» value string false none A business ID in the company registry in the specified country. » social object false none Company's social media URLs. »» twitter string¦null false none none »» facebook string¦null false none none »» linkedin string¦null false none none » domain string false none none » industries object false none none »» name string¦null false none Industry name. A complete list is available in the reference table. »» sic [string] false none SIC industry codes. The list of valid codes is available here. »» naics [string] false none NAICS industry classification codes. The list of valid codes is available here. » name string false none none » employees_range object false none Latest available employee count information. Valid ranges: * null - null * 1 - 1 * 2 - 10 * 11 - 50 * 51 - 200 * 201 - 500 * 501 - 1000 * 1001 - 5001 * 5001 - 10000 * 10001 - null A min value of 10_001, and max value being null means that the company has more than 10001 employees. Both min and max equal to null signify there is currently no available employee count information. »» min string¦null false none none »» max string¦null false none none location object false none Geographic location of the IP address. » city string false none none » region string false none none » country_code string false none A two-letter country code, possible values are ISO 3166-1 alpha-2 codes. Error { "message": "Unauthorized." } Properties Name Type Required Restrictions Description message string false none A human-readable error description. API Versioning As the API is being rapidly developed, there are no versioning or backwards-compatibility guarantees right now, although we try to avoid introducing breaking changes unless absolutely necessary. We will notify our clients about upcoming changes in a timely manner and also publish a list of significant changes and new development in the changelog. Changelog 2021/02/07 - Initial release. Industry names reference This is a list of industry names, as returned by the API. Name Accounting Airlines/Aviation Alternative Dispute Resolution Alternative Medicine Animation Apparel & Fashion Architecture & Planning Arts and Crafts Automotive Aviation & Aerospace Banking Biotechnology Broadcast Media Building Materials Business Supplies and Equipment Capital Markets Chemicals Civic & Social Organization Civil Engineering Commercial Real Estate Computer & Network Security Computer Games Computer Hardware Computer Networking Computer Software Construction Consumer Electronics Consumer Goods Consumer Services Cosmetics Dairy Defense & Space Design Education Management E-Learning Electrical/Electronic Manufacturing Entertainment Environmental Services Events Services Executive Office Facilities Services Farming Financial Services Fine Art Fishery Food & Beverages Food Production Fund-Raising Furniture Gambling & Casinos Glass, Ceramics & Concrete Government Administration Government Relations Graphic Design Health, Wellness and Fitness Higher Education Hospital & Health Care Hospitality Human Resources Import and Export Individual & Family Services Industrial Automation Information Services Information Technology and Services Insurance International Affairs International Trade and Development Internet Investment Banking Investment Management Judiciary Law Enforcement Law Practice Legal Services Legislative Office Leisure, Travel & Tourism Libraries Logistics and Supply Chain Luxury Goods & Jewelry Machinery Management Consulting Maritime Market Research Marketing and Advertising Mechanical or Industrial Engineering Media Production Medical Devices Medical Practice Mental Health Care Military Mining & Metals Motion Pictures and Film Museums and Institutions Music Nanotechnology Newspapers Non-Profit Organization Management Oil & Energy Online Media Outsourcing/Offshoring Package/Freight Delivery Packaging and Containers Paper & Forest Products Performing Arts Pharmaceuticals Philanthropy Photography Plastics Political Organization Primary/Secondary Education Printing Professional Training & Coaching Program Development Public Policy Public Relations and Communications Public Safety Publishing Railroad Manufacture Ranching Real Estate Recreational Facilities and Services Religious Institutions Renewables & Environment Research Restaurants Retail Security and Investigations Semiconductors Shipbuilding Sporting Goods Sports Staffing and Recruiting Supermarkets Telecommunications Textiles Think Tanks Tobacco Translation and Localization Transportation/Trucking/Railroad Utilities Venture Capital & Private Equity Veterinary Warehousing Wholesale Wine and Spirits Wireless Writing and Editing shell