Name: Company Info API: Global Lookup via Wikidata | Free & Fast
Brand: viv-data
SKU: api-viv-data-company-info
Availability: InStock
Author: API Market

gia ly bui

# Company Info Lookup — Wikidata, Global Coverage

## Overview
The Company Info Lookup API provides instant access to comprehensive company information for organizations worldwide, leveraging the vast knowledge base of Wikidata. This powerful search API allows developers and AI engineers to programmatically retrieve essential details such as industry classification, employee count, founding date, headquarters location, official website, and more, for virtually any company with a Wikipedia/Wikidata entry. It serves as a robust and free alternative to commercial company data providers, offering structured JSON responses for seamless integration into applications. With global coverage and a 24-hour response cache, this API is designed for speed and reliability, enabling developers to enrich business intelligence, power CRM systems, validate company data, or build innovative search experiences without the need for API keys from the data source.

## Features
*   **Global Company Coverage:** Access information for companies across the globe, wherever they have a Wikidata entry.
*   **Comprehensive Data Points:** Retrieve company name, description, industry, employee count, founding date, headquarters, website, country, and Wikidata ID.
*   **Structured JSON Output:** Clean, easy-to-parse JSON responses eliminate the need for complex web scraping.
*   **Free and Open Data Source:** Utilizes Wikidata, a free and open knowledge base, for unparalleled accessibility.
*   **High Performance:** Responses are cached for 24 hours, ensuring instant retrieval for repeat lookups and optimizing performance.
*   **No API Key Required for Data Source:** Simplifies integration by removing external API key dependencies for the underlying data.
*   **Synchronous Processing:** Get immediate results directly in the API response without polling.

## Use Cases
1.  **Business Intelligence & Research:** Enhance market analysis platforms by automatically fetching detailed company profiles, including industry, employee size, and founding year, for competitive analysis or investment research.
2.  **CRM Enrichment & Sales Enablement:** Integrate the API with CRM systems to automatically populate or update company records with accurate data like headquarters, website, and industry, enabling sales teams to personalize outreach.
3.  **Data Validation & Verification:** Use the API to validate user-provided company names or website URLs, ensuring data accuracy in applications, forms, or databases.
4.  **Supply Chain & Vendor Management:** Quickly look up potential suppliers or partners to assess their operational details, industry, and founding history, streamlining due diligence processes.
5.  **Educational & Developer Tools:** Build interactive learning tools, company directories, or internal utilities that require instant access to publicly available company facts.


## API Documentation

### Base URL
All API requests should be made to: `https://prod.api.market/api/v1/viv-data/company-info`

### Authentication
Authentication is handled via API key. Include your API key in the request header:
```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Processing Mode
**Synchronous Processing**
This API operates in a synchronous processing mode. This means that when you send a request to an endpoint, the API processes your request immediately and returns the final result directly in its response. There are no job IDs, no polling loops, and no status checks required. Your client code should expect a direct response containing the requested data or an error message. For longer-running requests (though most company lookups are fast), it's advisable to set an appropriate client-side request timeout to prevent indefinite waiting.

### Endpoints

#### GET /lookup
**Summary:** Lookup Company
**Description:** Retrieves detailed information for the best-matching company based on a given query string. This endpoint is ideal for getting specific details about a single company.

**Parameters:**
*   `q` (query, **required**, string): The company name to look up. Returns the best match. Example: `Tesla`

**Example Request:**
```bash
curl -X GET "https://prod.api.market/api/v1/viv-data/company-info/lookup?q=Tesla" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK):**
```json
{
  "name": "Tesla, Inc.",
  "description": "American electric vehicle and clean energy company",
  "industry": "automotive industry",
  "employees": 70757,
  "founded": "2003-07-01",
  "headquarters": "Austin",
  "website": "https://www.tesla.com",
  "country": "United States of America",
  "wikidata_id": "Q478214"
}
```

#### GET /search
**Summary:** Search Companies
**Description:** Performs a broader search for companies based on a query string and returns a list of matching companies. Useful for finding multiple potential matches or when the exact company name is unknown.

**Parameters:**
*   `q` (query, **required**, string): The company name or a partial name to search for. Example: `stripe`
*   `limit` (query, optional, integer): The maximum number of search results to return. Minimum is 1, maximum is 10. Default is 5.

**Example Request:**
```bash
curl -X GET "https://prod.api.market/api/v1/viv-data/company-info/search?q=stripe&limit=3" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK):**
```json
[
  {
    "name": "Stripe",
    "description": "Irish-American financial services and software as a service company",
    "industry": "FinTech",
    "employees": 7000,
    "founded": "2009-09",
    "headquarters": "San Francisco",
    "website": "https://stripe.com",
    "country": "United States of America",
    "wikidata_id": "Q7624647"
  },
  {
    "name": "Stripe (software)",
    "description": "Image editing software",
    "industry": "image editing software",
    "employees": null,
    "founded": null,
    "headquarters": null,
    "website": null,
    "country": null,
    "wikidata_id": "Q121226768"
  },
  {
    "name": "Stripe M",
    "description": null,
    "industry": null,
    "employees": null,
    "founded": null,
    "headquarters": null,
    "website": null,
    "country": null,
    "wikidata_id": "Q111758550"
  }
]
```

## Status Codes
*   **200 OK:** Request successful. The response body contains the requested company information or search results.
*   **400 Bad Request:** Invalid input parameters or a malformed request. Check the request body and query parameters for correctness.
*   **401 Unauthorized:** Missing or invalid API key in the `x-api-market-key` header. Ensure your API key is correctly provided.
*   **403 Forbidden:** Valid API key but insufficient permissions to access the resource. Contact support if you believe this is an error.
*   **404 Not Found:** The requested resource (e.g., a specific company not found for the lookup query) was not found. For `/lookup`, this might indicate no match, though typically an empty object would be returned if no match. For `/search`, an empty array might be returned.
*   **422 Unprocessable Entity:** Validation Error. The request was well-formed but could not be processed due to semantic errors in the input, such as an invalid `limit` value for `/search`.
*   **429 Too Many Requests:** Rate limit exceeded. You have sent too many requests in a given amount of time. Implement back-off and retry strategies.
*   **500 Internal Server Error:** A generic server-side error occurred. This indicates an unexpected issue on the API's side. Please report persistent 500 errors to support.
*   **503 Service Unavailable:** The service is temporarily unavailable, usually due to maintenance or high load. Retry the request after a short delay.


## Implementation Guide

### Example Code
These examples demonstrate how to make synchronous API requests to the Company Info Lookup API using JavaScript, Python, and cURL. Since the API is synchronous, a single request returns the final result.

#### JavaScript
```javascript
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/viv-data/company-info";

async function lookupCompany(query) {
  try {
    const response = await fetch(`${baseUrl}/lookup?q=${encodeURIComponent(query)}`, {
      method: "GET",
      headers: {
        "x-api-market-key": apiKey,
        "Accept": "application/json"
      }
    });

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`API error: ${response.status} ${response.statusText} - ${JSON.stringify(errorData)}`);
    }

    const companyInfo = await response.json();
    console.log("Lookup result:", companyInfo);
    return companyInfo;
  } catch (error) {
    console.error("Error looking up company:", error);
    throw error;
  }
}

async function searchCompanies(query, limit = 5) {
  try {
    const response = await fetch(`${baseUrl}/search?q=${encodeURIComponent(query)}&limit=${limit}`, {
      method: "GET",
      headers: {
        "x-api-market-key": apiKey,
        "Accept": "application/json"
      }
    });

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`API error: ${response.status} ${response.statusText} - ${JSON.stringify(errorData)}`);
    }

    const searchResults = await response.json();
    console.log("Search results:", searchResults);
    return searchResults;
  } catch (error) {
    console.error("Error searching companies:", error);
    throw error;
  }
}

// Example usage:
(async () => {
  console.log("--- Looking up Tesla ---");
  await lookupCompany("Tesla");

  console.log("\n--- Searching for Stripe (limit 2) ---");
  await searchCompanies("Stripe", 2);
})();
```

#### Python
```python
import requests
import json

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/viv-data/company-info"

def lookup_company(query):
    headers = {
        "x-api-market-key": API_KEY,
        "Accept": "application/json"
    }
    
    try:
        response = requests.get(
            f"{BASE_URL}/lookup?q={query}",
            headers=headers
        )
        response.raise_for_status() # Raises HTTPError for bad responses (4xx or 5xx)
        company_info = response.json()
        print("Lookup result:", json.dumps(company_info, indent=2))
        return company_info
    except requests.exceptions.HTTPError as e:
        print(f"HTTP error occurred: {e.response.status_code} {e.response.text}")
        raise
    except requests.exceptions.RequestException as e:
        print(f"Request error occurred: {e}")
        raise

def search_companies(query, limit=5):
    headers = {
        "x-api-market-key": API_KEY,
        "Accept": "application/json"
    }
    
    try:
        response = requests.get(
            f"{BASE_URL}/search?q={query}&limit={limit}",
            headers=headers
        )
        response.raise_for_status() # Raises HTTPError for bad responses (4xx or 5xx)
        search_results = response.json()
        print("Search results:", json.dumps(search_results, indent=2))
        return search_results
    except requests.exceptions.HTTPError as e:
        print(f"HTTP error occurred: {e.response.status_code} {e.response.text}")
        raise
    except requests.exceptions.RequestException as e:
        print(f"Request error occurred: {e}")
        raise

# Example usage:
if __name__ == "__main__":
    print("--- Looking up Google ---")
    lookup_company("Google")

    print("\n--- Searching for Apple (limit 2) ---")
    search_companies("Apple", limit=2)
```

#### cURL

### Look up a company

Retrieve detailed information about a specific company.

```bash
curl -X GET "https://prod.api.market/api/v1/viv-data/company-info/lookup?q=Microsoft" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -H "Accept: application/json"
```

**Example Response**

```json
{
  "name": "Microsoft",
  "domain": "microsoft.com",
  "industry": "Technology",
  "country": "United States"
}
```

---

### Search for companies

Search for companies matching a query and limit the number of results.

```bash
curl -X GET "https://prod.api.market/api/v1/viv-data/company-info/search?q=Meta&limit=2" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -H "Accept: application/json"
```

**Example Response**

```json
[
  {
    "name": "Meta Platforms",
    "domain": "meta.com"
  },
  {
    "name": "Meta AI",
    "domain": "ai.meta.com"
  }
]
```


## FAQ
**Q: What is the source of the company information?**

A: The API leverages Wikidata, a free and open knowledge base maintained by a community of volunteers, which also powers Wikipedia.

**Q: Is an API key required to use the data source (Wikidata)?**

A: No, an API key is only required for accessing this API via API.market. The underlying Wikidata source does not require a separate API key.

**Q: How fresh is the data?**

A: Results from Wikidata are typically very current. Additionally, this API caches results for 24 hours to provide faster responses on repeat lookups.

**Q: What happens if a company is not found?**

A: For the `/lookup` endpoint, if no suitable match is found for the query, the API will return a 200 OK response with a JSON object where most fields might be `null`, except for `name` which might be the closest interpretation or an empty string, or it might return a 404 Not Found error if no match can be derived. For the `/search` endpoint, if no companies match your query, an empty array `[]` will be returned.

**Q: Can I request more than 10 search results?**

A: The `/search` endpoint currently has a maximum `limit` of 10 results per request. If you need to perform more extensive searches, you might need to refine your query or consider alternative approaches.

**Q: Is there a free tier?**

A: Yes, there is a Basic tier that offers 5,000 requests per month completely free.

## Contact Us
If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.

Search any company worldwide via Wikidata. Get industry, employees, founding date, headquarters, website. Free and unlimited.