SchoberAPI (1)

Download OpenAPI specification:Download

Authentication

APIKeyHeader

Security Scheme Type	API Key
Header parameter name:	X-APIKEY

b2b

Search B2B

With this endpoint you can search and enrich Companydata

Authorizations:

APIKeyHeader

query Parameters

country_code	string Default: "DE" Value: "DE" Countrycode of the company
company_name required	string (Company Name) Company_name
zipcode required	string (Zipcode) Zipcode
fuzzy	boolean (Fuzzy) Default: false Activate Fuzzy search for company name
proximity	boolean (Proximity) Default: true Are the different Words in the Company name in proximity
package	Array of strings (B2BPackage) Items Enum: "industry_sector" "potential_data" "geo_data" "activity_info" "decision_maker" "identity_data" "communication_data" Name of Package to include, can appear multiple times
max_result	integer (Max Result) [ 1 .. 3 ] Default: 1 Maximum Amount of Results

Responses

Response samples

Content type

application/json

{"matched": true,
"result_count": 1,
"tokens_used": 8,
"result": [{"ebi": 1023456789123,
"company_name": "XXXXX XXXXX XXXXX",
"zipcode": "XXXXX",
"city": "XXXXXXXXXXXXXXXXX",
"street": "XXXXXXXXXXXX",
"packages": {"industry_sector": [{"direct_branches": [{"value": "661",
"text_de": "Direktmarketingunternehmen"
},
{"value": "662",
"text_de": "Direktwerbefirmen und Adressenverlage"
},
{"value": "1855",
"text_de": "Adressenvermittler"
},
{"value": "3427",
"text_de": "Marketingunternehmen"
},
{"value": "3553",
"text_de": "Werbe- und Marketingunternehmen"
},
{"value": "4398",
"text_de": "Datenbanken-Anbieter"
},
{"value": "5826",
"text_de": "Deutscher Dialogmarketing-Verband, Mitglieder (Listcouncil)"
},
{"value": "11827",
"text_de": "Deutscher Dialogmarketing-Verband, Mitglieder (CRM)"
}
]
},
{"ebc_industry_sector": {"value": "3553",
"text_de": "Werbe- und Marketingunternehmen"
}
},
{"wz2008_industry_sector": {"value": "73.1",
"text_de": "Werbung"
}
}
],
"potential_data": [{"revenue_class": {"value": "4",
"text_de": "5 Mio. bis 24,99 Mio."
}
},
{"employee_class": {"value": "5",
"text_de": "50-99 Beschäftigte"
}
}
],
"geo_data": [{"country_state": {"value": "08",
"text_de": "Baden-Württemberg (DE)"
}
},
{"city_code": {"value": "8116078",
"text_de": "8116078"
}
},
{"city_size": {"value": "5",
"text_de": "20.001 - 50.000 Einwohner"
}
},
{"wgs84": [{"value": "XXXXXXXXXXX",
"text_de": "latitude"
},
{"value": "XXXXXXXXXXX",
"text_de": "longitude"
}
]
}
],
"activity_info": [{"founding_year": {"value": "1984",
"text_de": "1984"
}
},
{"company_type": {"value": "13",
"text_de": "Zentrale"
}
}
],
"decision_maker": [{"decision_maker_level_1": [{"first_name": "XXXXX",
"last_name": "XXXXX",
"function": "Geschäftsführer"
},
{"first_name": "XXXXX",
"last_name": "XXXXX",
"function": "Geschäftsführer"
},
{"first_name": "XXXXX",
"last_name": "XXXXX",
"function": "Prokurist"
},
{"first_name": "XXXXX",
"last_name": "XXXXX",
"function": "Prokurist"
},
{"first_name": "XXXXX",
"last_name": "XXXXX",
"function": "Geschäftsführer"
},
{"first_name": "XXXXX",
"last_name": "XXXXX",
"function": "Geschäftsführer"
}
]
}
],
"identity_data": [{"vat": {"value": "DEXXXXXXXXX",
"text_de": "DEXXXXXXXXX"
}
},
{"company_register_nr": {"value": "HRB XXXXXX",
"text_de": "HRB XXXXXX"
}
},
{"ebi": {"value": "1023456789123",
"text_de": "1023456789123"
}
}
],
"communication_data": [{"url": {"value": "XXXXXXX.de",
"text_de": "XXXXXXX.de"
}
},
{"phone": {"value": "XXXXXXXX",
"text_de": "XXXXXXXX"
}
},
{"fax": {"value": "XXXXXXXX",
"text_de": "XXXXXXXX"
}
},
{"email": {"value": "XXXXX@XXXXX.de",
"text_de": "XXXXX@XXXXX.de"
}
}
]
}
}
]
}

b2c

Search B2C

Authorizations:

APIKeyHeader

query Parameters

country_code	string Default: "DE" Value: "DE" Countrycode of the person
first_name required	string (First Name) First name
last_name required	string (Last Name) Last name
zipcode required	string (Zipcode) Zipcode
city	string (City) City
street required	string (Street) Street
street_nr	string (Street Nr) Street Nr
fuzzy	boolean (Fuzzy) Default: false Activate Fuzzy search for Person
fuzzy_cut	number (Fuzzy Cut) Default: 0.5 Activate Fuzzy search for company name
packages	Array of strings (B2CPackage) Items Enum: "social_demographics" "ocean" "travel" "lifestyle" "living_environment" "shopping" "automotive" "finance" "energy" "media" packages
max_result	integer (Max Result) [ 1 .. 3 ] Default: 1 Maximum Amount of Results

Responses

Response samples

Content type

application/json

{"matched": true,
"result_count": 1,
"tokens_used": 11,
"result": [{"first_name": "XXXXXX",
"last_name": "XXXXXX",
"street": "XXXXXX",
"street_number": "XXXXXX",
"zipcode": "XXXXXX",
"packages": {"social_demographics": [{"family_status": {"value": "1",
"text_de": "Singles"
}
},
{"age_class": {"value": "3",
"text_de": "40 bis 49"
}
},
{"age": {"value": "45",
"text_de": "45"
}
},
{"income_class": {"value": "7",
"text_de": "4.000 bis 5.000 EUR"
}
},
{"title_holder": {"value": "1",
"text_de": "geringer Anteil"
}
},
{"salutation": {"value": "1",
"text_de": "Herr"
}
},
{"small_office": {"value": "1",
"text_de": "keine Firma "
}
}
],
"ocean": [{"openness": {"value": "5",
"text_de": "hohe Affinität bekannt"
}
},
{"extraversion": {"value": "4",
"text_de": "überdurchschnittliche Affinität bekannt"
}
},
{"conscientiousness": {"value": "4",
"text_de": "überdurchschnittliche Affinität bekannt"
}
},
{"neuroticism": {"value": "2",
"text_de": "unterdurchschnittliche Affinität bekannt"
}
},
{"agreeableness": {"value": "4",
"text_de": "überdurchschnittliche Affinität bekannt"
}
}
],
"travel": [{"long_distance": {"value": "1",
"text_de": "keine Affinität bekannt"
}
},
{"last_minute": {"value": "1",
"text_de": "keine Affinität bekannt"
}
},
{"cruise_passenger": {"value": "1",
"text_de": "keine Affinität bekannt"
}
},
{"wellness": {"value": "4",
"text_de": "überdurchschnittliche Affinität bekannt"
}
},
{"city_culture": {"value": "5",
"text_de": "hohe Affinität bekannt"
}
},
{"adventure": {"value": "1",
"text_de": "keine Affinität bekannt"
}
}
],
"lifestyle": [{"pets": {"value": "1",
"text_de": "keine Affinität bekannt"
}
},
{"dyi": {"value": "1",
"text_de": "geringe Affinität bekannt"
}
},
{"culture": {"value": "2",
"text_de": "Affinität bekannt"
}
},
{"regional": {"value": "1",
"text_de": "geringe Affinität bekannt"
}
},
{"donation": {"value": "4",
"text_de": "unbekannt"
}
},
{"product_innovations": {"value": "1",
"text_de": "geringe Affinität bekannt"
}
},
{"e_mobil": {"value": "2",
"text_de": "mittlere Affinität bekannt"
}
},
{"environmental": {"value": "3",
"text_de": "mittlere Affinität bekannt"
}
}
],
"living_environment": [{"building_type": {"value": "3",
"text_de": "Mehrfamilienhaus"
}
},
{"residential_area": {"value": "1",
"text_de": "gut"
}
},
{"maintenance_condition": {"value": "2",
"text_de": "gepflegt"
}
},
{"building_location": {"value": "2",
"text_de": "Ortslage"
}
},
{"living_space": {"value": "1",
"text_de": "bis 60qm"
}
},
{"coordinates": {"value": "9.1268539|48.7318993",
"text_de": "9.1268539|48.7318993"
}
}
],
"shopping": [{"brand_awareness": {"value": "3",
"text_de": "mittlere Affinität bekannt"
}
},
{"exclusive_fashion": {"value": "1",
"text_de": "geringe Affinität bekannt"
}
},
{"garden_products": {"value": "2",
"text_de": "mittlere Affinität bekannt"
}
},
{"installment_purchase": {"value": "3",
"text_de": "mittlere Affinität bekannt"
}
},
{"furniture": {"value": "5",
"text_de": "unbekannt"
}
},
{"technology": {"value": "3",
"text_de": "hohe Affinität bekannt"
}
},
{"customer_card": {"value": "5",
"text_de": "hohe Affinität bekannt"
}
},
{"online": {"value": "4",
"text_de": "überdurchschnittliche Affinität bekannt"
}
}
],
"automotive": [{"engine_displacement": {"value": "1",
"text_de": "sehr hoch"
}
},
{"purchase_price": {"value": "7",
"text_de": "eher hoch "
}
},
{"engine_power": {"value": "8",
"text_de": "hoch "
}
},
{"type_small": {"value": "3",
"text_de": "durschnittlich"
}
},
{"type_lower_midsize": {"value": "1",
"text_de": "sehr niedrig"
}
},
{"type_midsize": {"value": "4",
"text_de": "hoch "
}
},
{"type_upper_midsize": {"value": "3",
"text_de": "durchschnittlich"
}
},
{"type_upper_luxury": {"value": "1",
"text_de": "keine Affinität bekannt"
}
},
{"type_convertible": {"value": "2",
"text_de": "Affinität bekannt"
}
},
{"type_suv": {"value": "1",
"text_de": "keine Affinität bekannt"
}
},
{"type_natural_gas": {"value": "4",
"text_de": "hoch"
}
},
{"type_van": {"value": "3",
"text_de": "durchschnittlicher Anteil"
}
},
{"frequent_driver": {"value": "3",
"text_de": "durchschnittlich"
}
},
{"manufacturer_audi": {"value": "3",
"text_de": "durchschnittlicher Anteil"
}
},
{"manufacturer_bmw": {"value": "5",
"text_de": "hoher Anteil"
}
},
{"manufacturer_ford": {"value": "2",
"text_de": "unterdurchschnittlicher Anteil"
}
},
{"manufacturer_porsche_jaguar": {"value": "1",
"text_de": "keine Affinität bekannt"
}
},
{"manufacturer_opel": {"value": "3",
"text_de": "durchschnittlicher Anteil"
}
},
{"manufacturer_vw": {"value": "1",
"text_de": "geringer Anteil"
}
}
],
"finance": [{"direct_banking": {"value": "1",
"text_de": "keine Affinität bekannt"
}
},
{"investor": {"value": "5",
"text_de": "unbekannt"
}
},
{"household_wealth": {"value": "3",
"text_de": "80.000-200.000 EUR"
}
},
{"insurance_superconsumer": {"value": "4",
"text_de": "überdurchschnittliche Affinität bekannt"
}
},
{"account_switcher": {"value": "1",
"text_de": "keine Affinität bekannt"
}
}
],
"energy": [{"provider_switcher": {"value": "1",
"text_de": "geringe Affinität bekannt"
}
},
{"solar_energy": {"value": "1",
"text_de": "geringe Affinität bekannt"
}
},
{"gas_availability": {"value": "2",
"text_de": "Affinität bekannt"
}
},
{"energy_superconsumer": {"value": "2",
"text_de": "unterdurchschnittliche Affinität bekannt"
}
},
{"green_energy": {"value": "1",
"text_de": "geringe Affinität bekannt"
}
}
],
"media": [{"competion_print": {"value": "2",
"text_de": "unterdurchschnittliche Affinität bekannt"
}
},
{"competition_online": {"value": "3",
"text_de": "mittlere Affinität bekannt"
}
},
{"yellow_press": {"value": "1",
"text_de": "keine Affinität bekannt"
}
},
{"national_newspaper": {"value": "5",
"text_de": "hohe Affinität bekannt"
}
},
{"online_media": {"value": "4",
"text_de": "überdurchschnittliche Affinität bekannt"
}
}
]
}
}
]
}

Search B2C Email

Authorizations:

APIKeyHeader

query Parameters

country_code	string Default: "DE" Value: "DE" Countrycode of the person
email required	string (Email) email
packages	Array of strings (B2CPackage) Items Enum: "social_demographics" "ocean" "travel" "lifestyle" "living_environment" "shopping" "automotive" "finance" "energy" "media" packages

Responses

Response samples

Content type

application/json

{"matched": true,
"result_count": 1,
"tokens_used": 11,
"result": [{"first_name": "XXXXXX",
"last_name": "XXXXXX",
"street": "XXXXXX",
"street_number": "XXXXXX",
"zipcode": "XXXXXX",
"packages": {"social_demographics": [{"family_status": {"value": "1",
"text_de": "Singles"
}
},
{"age_class": {"value": "3",
"text_de": "40 bis 49"
}
},
{"age": {"value": "45",
"text_de": "45"
}
},
{"income_class": {"value": "7",
"text_de": "4.000 bis 5.000 EUR"
}
},
{"title_holder": {"value": "1",
"text_de": "geringer Anteil"
}
},
{"salutation": {"value": "1",
"text_de": "Herr"
}
},
{"small_office": {"value": "1",
"text_de": "keine Firma "
}
}
],
"ocean": [{"openness": {"value": "5",
"text_de": "hohe Affinität bekannt"
}
},
{"extraversion": {"value": "4",
"text_de": "überdurchschnittliche Affinität bekannt"
}
},
{"conscientiousness": {"value": "4",
"text_de": "überdurchschnittliche Affinität bekannt"
}
},
{"neuroticism": {"value": "2",
"text_de": "unterdurchschnittliche Affinität bekannt"
}
},
{"agreeableness": {"value": "4",
"text_de": "überdurchschnittliche Affinität bekannt"
}
}
],
"travel": [{"long_distance": {"value": "1",
"text_de": "keine Affinität bekannt"
}
},
{"last_minute": {"value": "1",
"text_de": "keine Affinität bekannt"
}
},
{"cruise_passenger": {"value": "1",
"text_de": "keine Affinität bekannt"
}
},
{"wellness": {"value": "4",
"text_de": "überdurchschnittliche Affinität bekannt"
}
},
{"city_culture": {"value": "5",
"text_de": "hohe Affinität bekannt"
}
},
{"adventure": {"value": "1",
"text_de": "keine Affinität bekannt"
}
}
],
"lifestyle": [{"pets": {"value": "1",
"text_de": "keine Affinität bekannt"
}
},
{"dyi": {"value": "1",
"text_de": "geringe Affinität bekannt"
}
},
{"culture": {"value": "2",
"text_de": "Affinität bekannt"
}
},
{"regional": {"value": "1",
"text_de": "geringe Affinität bekannt"
}
},
{"donation": {"value": "4",
"text_de": "unbekannt"
}
},
{"product_innovations": {"value": "1",
"text_de": "geringe Affinität bekannt"
}
},
{"e_mobil": {"value": "2",
"text_de": "mittlere Affinität bekannt"
}
},
{"environmental": {"value": "3",
"text_de": "mittlere Affinität bekannt"
}
}
],
"living_environment": [{"building_type": {"value": "3",
"text_de": "Mehrfamilienhaus"
}
},
{"residential_area": {"value": "1",
"text_de": "gut"
}
},
{"maintenance_condition": {"value": "2",
"text_de": "gepflegt"
}
},
{"building_location": {"value": "2",
"text_de": "Ortslage"
}
},
{"living_space": {"value": "1",
"text_de": "bis 60qm"
}
},
{"coordinates": {"value": "9.1268539|48.7318993",
"text_de": "9.1268539|48.7318993"
}
}
],
"shopping": [{"brand_awareness": {"value": "3",
"text_de": "mittlere Affinität bekannt"
}
},
{"exclusive_fashion": {"value": "1",
"text_de": "geringe Affinität bekannt"
}
},
{"garden_products": {"value": "2",
"text_de": "mittlere Affinität bekannt"
}
},
{"installment_purchase": {"value": "3",
"text_de": "mittlere Affinität bekannt"
}
},
{"furniture": {"value": "5",
"text_de": "unbekannt"
}
},
{"technology": {"value": "3",
"text_de": "hohe Affinität bekannt"
}
},
{"customer_card": {"value": "5",
"text_de": "hohe Affinität bekannt"
}
},
{"online": {"value": "4",
"text_de": "überdurchschnittliche Affinität bekannt"
}
}
],
"automotive": [{"engine_displacement": {"value": "1",
"text_de": "sehr hoch"
}
},
{"purchase_price": {"value": "7",
"text_de": "eher hoch "
}
},
{"engine_power": {"value": "8",
"text_de": "hoch "
}
},
{"type_small": {"value": "3",
"text_de": "durschnittlich"
}
},
{"type_lower_midsize": {"value": "1",
"text_de": "sehr niedrig"
}
},
{"type_midsize": {"value": "4",
"text_de": "hoch "
}
},
{"type_upper_midsize": {"value": "3",
"text_de": "durchschnittlich"
}
},
{"type_upper_luxury": {"value": "1",
"text_de": "keine Affinität bekannt"
}
},
{"type_convertible": {"value": "2",
"text_de": "Affinität bekannt"
}
},
{"type_suv": {"value": "1",
"text_de": "keine Affinität bekannt"
}
},
{"type_natural_gas": {"value": "4",
"text_de": "hoch"
}
},
{"type_van": {"value": "3",
"text_de": "durchschnittlicher Anteil"
}
},
{"frequent_driver": {"value": "3",
"text_de": "durchschnittlich"
}
},
{"manufacturer_audi": {"value": "3",
"text_de": "durchschnittlicher Anteil"
}
},
{"manufacturer_bmw": {"value": "5",
"text_de": "hoher Anteil"
}
},
{"manufacturer_ford": {"value": "2",
"text_de": "unterdurchschnittlicher Anteil"
}
},
{"manufacturer_porsche_jaguar": {"value": "1",
"text_de": "keine Affinität bekannt"
}
},
{"manufacturer_opel": {"value": "3",
"text_de": "durchschnittlicher Anteil"
}
},
{"manufacturer_vw": {"value": "1",
"text_de": "geringer Anteil"
}
}
],
"finance": [{"direct_banking": {"value": "1",
"text_de": "keine Affinität bekannt"
}
},
{"investor": {"value": "5",
"text_de": "unbekannt"
}
},
{"household_wealth": {"value": "3",
"text_de": "80.000-200.000 EUR"
}
},
{"insurance_superconsumer": {"value": "4",
"text_de": "überdurchschnittliche Affinität bekannt"
}
},
{"account_switcher": {"value": "1",
"text_de": "keine Affinität bekannt"
}
}
],
"energy": [{"provider_switcher": {"value": "1",
"text_de": "geringe Affinität bekannt"
}
},
{"solar_energy": {"value": "1",
"text_de": "geringe Affinität bekannt"
}
},
{"gas_availability": {"value": "2",
"text_de": "Affinität bekannt"
}
},
{"energy_superconsumer": {"value": "2",
"text_de": "unterdurchschnittliche Affinität bekannt"
}
},
{"green_energy": {"value": "1",
"text_de": "geringe Affinität bekannt"
}
}
],
"media": [{"competion_print": {"value": "2",
"text_de": "unterdurchschnittliche Affinität bekannt"
}
},
{"competition_online": {"value": "3",
"text_de": "mittlere Affinität bekannt"
}
},
{"yellow_press": {"value": "1",
"text_de": "keine Affinität bekannt"
}
},
{"national_newspaper": {"value": "5",
"text_de": "hohe Affinität bekannt"
}
},
{"online_media": {"value": "4",
"text_de": "überdurchschnittliche Affinität bekannt"
}
}
]
}
}
]
}

status

Get Api Status

Authorizations:

APIKeyHeader

Responses

Response samples

Content type

application/json

null

Get Current User Info

Authorizations:

APIKeyHeader

Responses

Response samples

Content type

application/json

{"customer_id": "string",
"name": "string",
"active": true,
"package": {"id": "string",
"name": "string",
"description": "string",
"monthly_request_tokens": 0,
"date_created": "2019-08-24T14:15:22Z"
},
"token_usage": {"monthly_request_tokens": 0,
"addon_tokens": [{"addon_id": "string",
"tokens": 0,
"tokens_used": 0,
"tokens_left": 0,
"expiring": true,
"expired": true,
"expire_date": "2019-08-24T14:15:22Z",
"date_created": "2019-08-24T14:15:22Z"
}
],
"monthly_tokens_used": 0,
"addon_tokens_used": 0,
"monthly_tokens_left": 0,
"addon_tokens_left": 0,
"tokens_left": 0
},
"date_created": "2019-08-24T14:15:22Z"
}