Page tree
Skip to end of metadata
Go to start of metadata

The Squirro iFrame is used to embed Squirro into any web system.

Table of Contents


The iFrame is served from the following URL: $CLUSTER/app/bulk/iframe

The $CLUSTER part in the URL is replaced with your cluster endpoint, resulting for example in the URL http://localhost:8300/app/bulk/iframe for your local Squirro in a Box installation. See Endpoint Mapping for more information.


The following sections define all supported query string parameters.

All values must be encoded according to Character Data.

The iFrame can select objects.


Parameter Documentation
project_id (mandatory) The identifier of the selected Squirro project.
token iFrame token for authentication which can be generated on behalf of a specific user by visiting (see Endpoint Mapping for more information).


Parameter Documentation

Tabs to show in the iframe.

The following values are supported. Multiple values are separated by comma:

Value Tab Description
read Read Show items from the selected project.
info Essentials Search for and display companies. This is recommended if your items are companies.
sources Sources Display and manage sources.
settings Settings Manage social connections and user profile details.

The tab bar is hidden if the value is specified but left empty.


Allows to customize the date formatting. The following values are supported:

  • timeago (default): Uses relative date format. Examples “1 day ago”, “3 weeks ago”, etc.

  • calendar: Uses relative date format for all dates within the past week, absolute ones for everything else. Examples: “Today 3:43 AM”, “Yesterday 2:29 PM”, “Last Monday 11:44 PM”.

  • custom format: A custom format can be specified. See the table below for all supported tokens. Values are escaped with square brackets. For example [on] dddd results in “on Monday”, “on Tuesday”, etc.

      Token Output
    Month M 1 2 ... 11 12
      Mo 1st 2nd ... 11th 12th
      MM 01 02 ... 11 12
      MMM Jan Feb ... Nov Dec
      MMMM January February ... November December
    Day of Month D 1 2 ... 30 30
      Do 1st 2nd ... 30th 31st
      DD 01 02 ... 30 31
    Day of Year DDD 1 2 ... 364 365
      DDDo 1st 2nd ... 364th 365th
      DDDD 001 002 ... 364 365
    Day of Week d 0 1 ... 5 6
      do 0th 1st ... 5th 6th
      ddd Sun Mon ... Fri Sat
      dddd Sunday Monday ... Friday Saturday
    Week of Year w 1 2 ... 52 53
      wo 1st 2nd ... 52nd 53rd
      ww 01 02 ... 52 53
    ISO Week of Year W 1 2 ... 52 53
      Wo 1st 2nd ... 52nd 53rd
      WW 01 02 ... 52 53
    Year YY 70 71 ... 29 30
      YYYY 1970 1971 ... 2029 2030
      a am pm
    Hour H 0 1 ... 22 23
      HH 00 01 ... 22 23
      h 1 2 ... 11 12
      hh 01 02 ... 11 12
    Minute m 0 1 ... 58 59
      mm 00 01 ... 58 59
    Second s 0 1 ... 58 59
      ss 00 01 ... 58 59
    Fractional Second S 0 1 ... 8 9
      SS 0 1 ... 98 99
      SSS 0 1 ... 998 999
      ss 00 01 ... 58 59
    Timezone Z -07:00 -06:00 ... +06:00 +07:00
      ZZ -0700 -0600 ... +0600 +0700
    Unix Timestamp X 1360013296

Limits the smart filter list that is shown to the user to those matching this tag. Specified multiple times for multiple tags which are OR-combined.

Example: smartfilterTag=banks&smartfilterTag=insurances.

Object Selection

The objects are specified by the following parameters. Different selection modes are supported and are mutually exclusive:

Selection by External Identifier

Parameter Documentation

The external identifier of the object for which the project is selected. This is the external object identifier used during bulk object creation. If a single external_id is provided the object will enter the api_reference_iframe_object_creation mode.

Specified multiple times to show items from multiple objects. Example: &external_id=Squirro&external_id=Oracle.

Selection by Squirro Identifier

Parameter Documentation

The Squirro object identifier. This can be retrived by the project API.

Specified multiple times to show items from multiple objects. Example: &object_id=H0ZdsRhokqod8vDw&object_id=ioLWXX2t9OJlsXTg.

Selection by Object Name

Parameter Documentation

Selects all objects within the corresponding name.

Specified multiple times to show items from multiple objects. Example: &object_name=Insurance&object_name=Banking.

Item Filtering

Squirro filters the displayed item list according to the following parameters.

Parameter Documentation
created_before datetime value which limits the returned items to items that have been created before this date.
created_after datetime value which limits the returned items to items that have been created after this date.

Limit the returned items to those matching this query.

The query string is displayed in the iFrame and can be modified by the user.


Restrict the returned items to a specific geographic region. This parameter can take three different forms:

  • lat,lon for searching on one spot
  • lat,lon,radius to search within a circle (radius unit is kilometer)
  • lat1,lon1,lat2,lon2 to search in an envelope (top right, bottom left)

Character Data

The representation of character data is such that characters are converted to bytes according to UTF-8, and then percent-encoded (e.g. Zürich Versicherung becomes Z%C3%BCrich+Versicherung). For more information, see:

  • No labels