Getting Started


The bobbil API is a straightforward REST service that allows developers to access data in the bobbil database.

1. Request an API Key


We review every request for access to the bobbil Dataset and provision API Keys manually.
To get started and request an API key, please contact a bobbil administrator at admin@bobbil.com.

2. Learn How the API Works


The REST API is very consistent in the way it accepts parameters and in the way in formats responses.
Please take a moment to read Using the API to make sure you understand the core principals guiding all interaction with the bobbil REST API.

3. Ask for Help


Having issues and can’t find an answer in the documentation? Write to us at admin@bobbil.com.

Using the API


Introduction


The bobbil API is a RESTful service that enables approved developers to retrieve data from the bobbil Dataset.

The bobbil API can be accessed programmatically (the most common use case) but for simple testing or inspection, the bobbil API can also be accessed through any developer tools that allow the user to set HTTP Request Headers and URL parameters such as Postman for Google Chrome.

Authentication


The bobbil API uses token-based authentication, which means that developers must pass their individual ApiAccessKey parameter with every request via the HTTP Request Header. Developers should set the ApiAccessKey HTTP Request Header parameter to their own unique access key.

This ApiAccessKey is used to validate each developer's access to the API and ensure that any rate limits or quotas are respected.

If a developer omits the ApiAccessKey, overruns a rate limit, or exceeds a quota, the system will respond with an error message.

Developers can learn about access to the API and requesting ApiAccessKey in the Getting Started section.

Collections


The bobbil API provides Collection endpoints to retrieve the entire set and core properties of many of the important Item types in the bobbil Dataset, as follows:


Collection

Endpoint


Company
/companies

Product
/products

Companies


Definition:

https://www.bobbil.com/api/companies


Parameters

All parameters are optional.
TrackingToken String (max 20 chars) optional

A developer can issue their own tracking token with each request. This is returned with the response.

Example Values: 7sEmF0mGYE

SearchString String (max 40 chars) optional

A full-text query of name and description of a company.

Example Values: BIG DATA

Rating Integer (exact as shown) optional

Return only companies that have a rating value equal to that specified.

Example Values:
0 (companies with no rating)
1 (companies with 1 star rating and greater)
2 (companies with 2 star rating and greater)
3 (companies with 3 star rating and greater)
4 (companies with 4 star rating and greater)
5 (companies with 5 star rating)

Location String (exact as shown) optional

Return only companies that have an office location equal to that specified.

Example Values:
North America
South America
Europe
Middle East & Africa
Asia
Australasia

NumberOfEmployees String (exact as shown) optional

Return only companies that have an office location equal to that specified.

Example Values:
Any
Unspecified
1-10 Employees
11-100 Employees
101-1,000 Employees
1,001-10,000 Employees
>10,000 Employees

ProductsOnBobbil Integer (exact as shown) optional

Return only companies that have products on bobbil.

Example Values:
0 (Return companies without products on bobbil)
1 (Return companies with products on bobbil)

FinancialOrg Integer (exact as shown) optional

Return finanical organisations only.

Example Values:
0 (Non-Financial Institution)
1 (Financial Institution)

KeywordList String (max 250 chars total) optional

This parameter can be used up to 10 times to specify 10 keywords to be used in search company keywords. The length of all terms combined must not exceed 250 characters.

Example Values: cloud

CompanyId String (max 40 chars) optional

Return the company that matches the company id issued.

Example Values: BF343E10-6F2E-4A8E-A4AB-0013D4AAD7C9


get
{{resultMessage}}
{{companyMessage}}
Company request results

Products


Definition:

https://www.bobbil.com/api/products


Parameters

All parameters are optional.
ApprovedFlag Integer (exactly as shown) optional

Return only products that have been approved.

Example Values:
0 (Search all)
1 (Search approved products only)

TrackingToken String (max 20 chars) optional

A developer can issue their own tracking token with each request. This is returned with the response.

Example Values: 7sEmF0mGYE

SearchString String (max 40 chars) optional

A full-text query of name and description of a product.

Example Values: Cloud

KeywordList String (max 250 chars total) optional

This parameter can be used up to 10 times to specify 10 keywords to be used in search product keywords. The length of all terms combined must not exceed 250 characters.

Example Values: SQL

ProductId String (max 20 chars) optional

Return the product that matches the product id issued.

Example Values: 54578


get
{{resultMessage}}
{{productMessage}}
Product request results

Appendix


Below is a list of all available RoleGroups and their respective Roles which can be passed as parameters when querying the bobbil Dataset via the API for both companies and products.

* RoleGroups
* Roles

  • ANALYTICS SOFTWARE
    • ANALYTICS as a SERVICE
    • ANALYTICS TOOLS
    • BIG DATA INFRASTRUCTURE
    • BUSINESS INTELLIGENCE SOFTWARE
    • DATA GATHERING SOLUTIONS
    • MARKETING/SALES ANALYTICS
    • MEDICAL ANALYTICS
    • PREDICTIVE ANALYTICS SOFTWARE
    • SOCIAL MEDIA ANALYTICS
    • VISUALIZATION SOLUTIONS
    • WEBSITE ANALYTICS
  • CLOUD PLATFORMS
    • CLOUD DATA-CENTER SUPPORT
    • CLOUD ENABLEMENT
    • CLOUD INFRASTRUCTURE SERVICES
    • CLOUD PLATFORM SERVICES
    • CLOUD SECURITY
    • CLOUD STORAGE & FILE SHARING
  • COMMERCIAL ENGAGEMENT
    • BUSINESS COMMS SOLUTIONS
    • BUSINESS SUPPORT SYSTEMS
    • CRM
    • CUSTOMER EXPERIENCE MGMT
    • CUSTOMER INFORMATION SYS (CIS)
    • GENERAL B2B RETAIL
    • LEAD GENERATION
    • MARKETING PLATFORM
    • SURVEY & POLL SOLUTIONS
  • CONSUMER WEB & RETAIL
    • AUCTION SITES
    • CLASSIFIED ADS
    • DEAL SOLUTIONS
    • GIFTING
    • PERSONAL LIFESTYLE
    • PRICE COMPARISON
    • REFERRAL BASED RETAIL
    • SWAPPING / SHARING
    • TRAVEL & EVENT LIFESTYLE
  • CORE BUSINESS SOFTWARE
    • BUSINESS SERVICES
    • COLLABORATION TOOLS
    • EFFICIENCY TOOLS
    • ENTERPRISE RESOURCE PLANNING (ERP)
    • FINANCE & GOVERNANCE SYSTEMS
    • HUMAN RESOURCES
    • INDUSTRY ASSOCIATIONS
    • MOBILE WORKFORCE MANAGEMENT
    • PARTNER AND SUBCONTRACT SUPPORT
    • RESEARCH SERVICES
  • DEVICES
    • ADVANCED METERING INFRA(AMI)
    • AUTOMATED METER READER(AMR)
    • GAMING DEVICES
    • HEALTHCARE DEVICES
    • METER DATA READERS
    • MOBILE DEVICES
    • SEMICONDUCTOR DEVICES & DESIGN
    • SET TOP BOX
    • UI DEVICES
    • WELLNESS DEVICES
  • DIGITAL ADVERTISING
    • AD CAMPAIGN MGMT
    • AD NETWORKS & EXCHANGE
    • AD SERVERS
    • AFFILIATE MARKETING
    • DEMAND SIDE PLATFORMS
    • INTEGRATED ADVERTISING SOLUTIONS
    • MEDIA MGMT SYSTEMS
    • RETARGETTING SOLUTIONS
    • SOCIAL MEDIA ADVERTISING
    • SUPPLY SIDE PLATFORMS
  • DIGITAL EDUCATION
    • DIGITAL EDUCATION SERVICES
    • EDUCATION PLATFORMS
    • EDUCATION RESOURCES
    • EDUCATION SUPPORT NETWORKS
  • eCOMMERCE PLATFORMS
    • INFORMATION TRADING
    • MOBILE COMMERCE PLATFORM
    • ONLINE BOOKING
    • PAYMENTS SOLUTIONS
    • REFERRAL PLATFORM
    • RETAIL PERFORMANCE MGMT
    • RETAIL PLATFORM
    • TRADING & LOGISTICS PLATFORM
  • eFINANCE SOFTWARE
    • eMONEY SOLUTIONS
    • FINANCIAL MANAGEMENT SOLUTIONS
    • MOBILE PROXIMITY PAYMENTS
    • REPUTATION MGMT
    • SOCIAL PAYMENT SOLUTIONS
  • eHEALTH & WELLNESS
    • EHR/EHM SOLUTIONS
    • HEALTH AND WELLNESS APPS
    • HEALTH FINANCE AND INSURANCE
    • HEALTHCARE INFORMATION SYSTEMS
    • HEALTHCARE PROVIDER SYSTEMS
    • PATIENT ENGAGEMENT
    • PHARMACY SOLUTIONS
    • REMOTE PATIENT MONITORING
    • SOCIAL HEALTHCARE PLATFORMS
    • TELEMEDICINE SOLUTIONS
  • ENABLING TECHNOLOGIES
    • ARTIFICIAL INTELLIGENCE
    • BATTERY TECHNOLOGIES
    • BIOMETRIC TECHNOLOGY
    • BROWSERS & OS
    • DISPLAY TECHNOLOGY
    • LOCATION RELATED TECHNOLOGY
    • MOTION & PROXIMITY SENSING
    • SPEECH TECHNOLOGY
    • STORAGE TECHNOLOGIES
    • VIDEO & MULTIMEDIA TECHNOLOGY
  • ENERGY & UTILITIES
    • FACILITY MANAGEMENT SOFTWARE
    • METER DATA ANALYTICS (MDA)
    • METER DATA MANAGEMENT (MDM)
    • REGULATORY SUPPORT
    • SMART ENERGY MGMT
    • SMART GRID PLATFORMS
    • UTILITIES MGMT SOLUTIONS
  • FIXED & MOBILE COMMS
    • COMMS SERVICE PROVIDER
    • COMMUNICATIONS SOLUTIONS
    • LOCATION BASED SERVICES
    • MOBILE PASS SOLUTIONS
    • OVER THE AIR MANAGEMENT
  • GAMING
    • CONSOLE GAMES DEVELOPER
    • GAMBLING
    • GAME DEVELOPMENT TOOLS
    • GAME MONETIZATION PLATFORM
    • GAME PUBLISHER / AGGREGATOR
    • MOBILE GAME DEVELOPER
    • MULTI-PLAYER ONLINE GAMING
    • SOCIAL GAMING
  • INFRASTRUCTURE SOLUTIONS
    • DATA CENTER INFRASTRUCTURE
    • HOME AREA NETWORK(HAN)
    • MANAGED SERVICE PROVISION
    • NETWORK EQUIPMENT PROVIDERS
    • NETWORK MANAGEMENT
    • NETWORK OPERATORS
    • NETWORK SECURITY
    • SDN / NFV
    • SERVICE & PERFORMANCE MGMT
  • M2M SOLUTIONS
    • COMMERCIAL AND INDUSTRIAL TELEMATICS
    • CONNECTED CITY
    • M2M INFRASTRUCTURE
    • NFC SOLUTIONS
    • RFID SOLUTIONS
    • SMART HOME
  • MEDIA & ENTERTAINMENT
    • CONTENT CREATION & MANAGEMENT
    • CONTENT DELIVERY NETWORKS
    • CONTENT EDITING
    • CONTENT PUBLISHING
    • CONTENT SERVICE PROVIDER
    • MEDIA ANALYTICS
    • NEWS SITES
    • SOCIAL TV
  • SEARCH SOLUTIONS
    • GEOLOCATE SEARCH
    • INNOVATIVE SEARCH ENGINES
    • MOBILE SEARCH
    • PERSONALIZATION SOLUTIONS
    • Q&A SOLUTIONS
    • SEARCH ENGINE OPTIMIZATION SEO
    • SOCIAL TOOLS /SEARCH
    • VERTICAL MARKET SEARCH
    • VIDEO & PHOTO CATEGORIZATION
  • SECURITY SOFTWARE
    • DIGITAL ASSET TRACKING
    • ENTERPRISE IT MONITORING
    • ENTERPRISE RISK MGMT
    • ENTERPRISE SECURITY MGMT
    • IDENTITY ACCESS MGMT
    • MOBILE SECURITY
    • PERSONAL DATA SECURITY
    • SURVEILLANCE
  • SOCIAL NETWORK ENABLEMENT
    • ENTERPRISE SOCIAL PLATFORMS
    • SOCIAL MEDIA MANAGEMENT TOOLS
    • SOCIAL NETWORK PLATFORMS
    • SOCIAL RISK AND COMPLIANCE
  • SOCIAL NETWORKING
    • BLOGGING & MICROBLOGGING
    • BUSINESS NETWORKING
    • HYPERLOCAL CONTENT
    • LOYALTY & REWARDS SOLUTIONS
    • NICHE SOCIAL COMMUNITY
    • SOCIAL CONTENT SHARING
    • SOCIAL CROWDSOURCING
    • SOCIAL INFLUENCE
    • SOCIAL NETWORKS
    • SOCIAL RECOMMENDATION
    • SOCIAL TAGGING & BOOKMARKS
  • SOFTWARE DEVELOPMENT
    • APP SOLUTIONS
    • DATABASE TOOLS & SOLUTIONS
    • DESIGN TOOLS
    • DEVELOPMENT COMMUNITIES
    • DEVELOPMENT PLATFORMS
    • INTEGRATION & DEVELOPMENT TOOLS
    • SOFTWARE DEVELOPMENT SERVICES
    • TEST TOOLS
    • WEB DEVELOPMENT TOOL
  • SOURCES OF CAPITAL
    • EARLY STAGE (Series A, B)
    • GROWTH (Series C, D)
    • INCUBATORS & ACCELERATORS
    • OTHER
    • SEED
  • TRANSPORT SOLUTIONS
    • CONNECTED VECHICLES
    • MAPPING & TRAFFIC SOLUTION
    • SAFETY SOLUTIONS
    • TRANSPORT INFRASTRUCTURE
}