get /v2/data-fields

Get data fields

Provides a list of all industries and industry categories, technologies and regions searchable by Ocean.io.

Calling this endpoint does not consume any credits.

Authorizations

apiToken string

x-api-token string

Responses

200 Successful Response

List of industries

Array of PublicIndustries

List of industries

Array of string

industryCategory string

Industry category name

List of Linkedin industries

Array of string

List of technologies

Array of PublicTechnology

name string

The technology name

Technology categories

Array of string

List of regions per country

object

List of seniorities computed from the job title of the person

Array of Seniority

enum

"Owner""Founder""Board Member""C-Level""Partner""VP""Head""Director""Manager""Other"

List of departments computed from the job title of the person

Array of Department

enum

"Accounting and Finance""Board""Business Support""Customer Relations""Design""Editorial Personnel""Engineering""Founder/Owner""Healthcare""HR""Legal""Management""Manufacturing""Marketing and Advertising""Operations""PR and Communications""Procurement""Product""Quality Control""R&D""Sales""Security""Supply Chain""Other"

400 Bad Request

detail enum Required

"Conflicting API tokens provided in query parameters and headers"

402 Payment Required

detail enum Required

"Insufficient email credits"

"Some email verifications are already in progress and might use all your remaining email credits. Please try again later."

"Insufficient phone credits"

"Some phone verifications are already in progress and might use all your remaining phone credits. Please try again later."

"Insufficient credits"

403 Forbidden

detail enum Required

"API token should be provided in headers or query parameters""Current API token is not registered in our database"

404 Not found

422 Validation Error

Array of ValidationError

Array of string | integer

string | integer

msg string Required

type string Required

input any

object

API token

Session only — cleared when you close the tab.

Request

cURL

Python

JavaScript

curl -X GET 'https://api.ocean.io/v2/data-fields' \
  -H 'x-api-token: <YOUR_API_TOKEN>'

Response

200

400

402

403

422

{
  "industries": [
    {
      "industries": [
        "Advertising Platforms",
        "Biopharma"
      ],
      "industryCategory": "Administrative Services"
    }
  ],
  "linkedinIndustries": [
    "Accounting",
    "Airlines/Aviation",
    "Alternative Dispute Resolution"
  ],
  "technologies": {
    "categories": [
      "Chat"
    ],
    "name": "ChatStack"
  },
  "regions": {
    "nl": [
      {
        "code": "NH",
        "englishName": "North Holland",
        "localName": "Noord-Holland"
      }
    ]
  },
  "seniorities": [
    "C-Level",
    "Manager"
  ],
  "departments": [
    "Management",
    "Marketing and Advertising"
  ]
}