List random companies

get/v1/companies

Request

  • Base URL: https://random-profiles.com
  • URL: https://random-profiles.com/v1/companies
  • Auth: API key in header X-API-Key

Query parameters

countinteger

Number of companies to return

fieldsstring

Comma-separated field groups (name, industry, size, location, contact, social, financial, tech, leadership, legal, operations, product, relationships, meta). The relationships group returns employee_uuids — a sample of up to 30 profiles assigned to the company.

logo_size'64' | '128' | '256' | '512' | '1024'

Size of the meta.logo_url variant returned (64, 128, 256, 512, 1024 — default 1024)

logo_format'jpg' | 'webp'

Image format for the meta.logo_url URL. WebP is ~30% smaller with the same perceived quality.

industrystring

Filter by industry

countrystring

Comma-separated country codes (US, GB, DE, FR, AU, BR, JP, IN, NG)

sizestring

Comma-separated size brackets (1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5000+)

seedinteger

Seed for deterministic results

format'json' | 'csv'

Response format

Response

List of companies

Example response

{
  "companies": [
    {
      "name": "Acme Cloud",
      "legal_name": "Acme Cloud Inc.",
      "legal_form": "Inc.",
      "location": {
        "country": "US"
      },
      "financial": {
        "currency": "USD"
      },
      "meta": {
        "cover_color": "#3a86ff"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.