TDTradeData

Company Info API

Retrieve a company profile by name keyword, including basic profile, social links, team contacts and website information.
ENDPOINTS
POST /api/v1/company/companyInfo

Request parameters

keyword

string

Company name keyword

  • Required: Yes
  • Example: Acme Corp

refresh

boolean

Force a refresh from the upstream source instead of returning the cached profile

  • Required: No
  • Example: false
Request Example
{
    "keyword": "Acme Corp",
    "refresh": false
}

curl https://api.tradedata.io/api/v1/company/companyInfo \
  -H "Authorization: Bearer yourTokenHere" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "Acme Corp", "refresh": false}'

Response parameters

code

int

Status code

  • Example: 200

data

object

Result container

data.dig

string

Opaque identifier for this profile

  • Example: IVwU4gSc4U9rYR9+V6jM6A==

data.profiles

array

Company profiles assembled from the upstream sources. The field set differs from one profile to the next: only origin, name and website appear consistently, every other field may be missing, and the same fact can arrive under different spellings depending on the source. Read the fields you need defensively rather than assuming a fixed shape

data.profiles.origin

int

Source identifier of this profile

  • Example: 1

data.profiles.name

string

Company name

  • Example: Acme Corp

data.profiles.website

string

Company website

  • Example: https://example.com

data.profiles — other common fields

Present depending on the source. Grouped here by what they carry, since several sources use different names for the same fact:

FactField names seen
Descriptiondescription, overview, about
Legal namelegal name
Addressaddress, location, hq, headquarters, headquarters regions
Countrycountry, countryCode
Industryindustry, industries, industryEn, sectors
Productsproduct, productEn
Foundedfounded, founded date
Foundersfounders
Key peoplekey_people
Employeesemployees, number of employees, empNum
Emailemail, contact email
Phonephone, phone number, tel, whatsapp
Company typetype, com_type, company type
Statusstatus, operating status
Fundinglast funding type, number of exits, stock symbol
Revenuerevenue
Tax codetax_code
Logologo
Social linksfacebook, twitter, linkedin, instagram, youtube, crunchbase, bloomberg, rocketreach, zoominfo

data.socials

object

Company social links grouped by platform. Each value is an array of URLs. Keys observed: linkedin, facebook, twitter, instagram, youtube, ok

data.memberSocial

array

Social profiles of people associated with the company

data.memberSocial.name

string

Full name

  • Example: John Doe

data.memberSocial.position

string

Job title

  • Example: Sales Manager

data.memberSocial.location

string

Location of the person

  • Example: Example City

data.memberSocial.linkUrl

string

Profile URL

  • Example: https://www.linkedin.com/in/example-profile

data.memberSocial.linkedin_url

string

LinkedIn profile URL, same value as linkUrl when type is linkedin

  • Example: https://www.linkedin.com/in/example-profile

data.memberSocial.profile_pic

string

Profile picture URL

  • Example: https://example.com/photo.jpg

data.memberSocial.type

string

Social platform

  • Example: linkedin

data.memberSocial.company

string

Company the person is associated with

  • Example: Acme Corp

data.memberSocial.company_id

int

Identifier of that company

  • Example: 787807

data.memberSocial.company_website

string

Website of that company

  • Example: https://example.com

data.memberSocial.company_linkedin_url

string

LinkedIn page of that company

  • Example: https://www.linkedin.com/company/example-corp

data.websites

array

Web pages related to the company

data.websites.title

string

Page title

  • Example: Trade Data - Acme Corp

data.websites.link

string

Page URL

  • Example: https://example.com/

data.websites.content

string

Page snippet

  • Example: Acme Corp offers a marketplace for buyers and suppliers to find and verify each other.

data.websites.domain

string

Domain of the page

  • Example: example.com

string

Site logo. Not always present

  • Example: https://example.com/logo.png

data.time

string

Time the profile was collected

  • Example: 2026-03-29 16:00:00
Response Example
{
    "code": 200,
    "success": true,
    "data": {
        "dig": "IVwU4gSc4U9rYR9+V6jM6A==",
        "profiles": [
            {
                "origin": 1,
                "name": "Acme Corp",
                "website": "https://example.com",
                "description": "Acme Corp is a B2B trade platform connecting global buyers and verified suppliers.",
                "address": "123 Example Street, Example City",
                "country": "Singapore",
                "industry": "Internet Media & Services",
                "founded": "2010",
                "number of employees": "1-100",
                "email": "[email protected]",
                "phone number": "+1 555-000-0000",
                "key_people": [
                    {
                        "name": "John Doe",
                        "position": "CEO"
                    }
                ],
                "linkedin": "https://www.linkedin.com/company/example-corp"
            }
        ],
        "socials": {
            "linkedin": [
                "https://www.linkedin.com/company/example-corp"
            ]
        },
        "memberSocial": [
            {
                "name": "John Doe",
                "position": "Sales Manager",
                "location": "Example City",
                "linkUrl": "https://www.linkedin.com/in/example-profile",
                "linkedin_url": "https://www.linkedin.com/in/example-profile",
                "profile_pic": "https://example.com/photo.jpg",
                "type": "linkedin",
                "company": "Acme Corp",
                "company_id": 787807,
                "company_website": "https://example.com",
                "company_linkedin_url": "https://www.linkedin.com/company/example-corp"
            }
        ],
        "websites": [
            {
                "title": "Trade Data - Acme Corp",
                "link": "https://example.com/",
                "content": "Acme Corp offers a marketplace for buyers and suppliers to find and verify each other.",
                "domain": "example.com",
                "logo": "https://example.com/logo.png"
            }
        ],
        "time": "2026-03-29 16:00:00"
    }
}

Company Map Info API

Retrieve map data (coordinates, address, country) for a single company.

Biz-KYC Company Search API

Search Biz-KYC company records by company name or registration number, with pagination.