The various “fetch” methods of the connector all take the same parameters:

Parameter Data type Description
uri string

URI of the JSON resource to read. This may be any of the following syntaxes:

  • absolute file path: /var/foo/web/fileadmin/import/bar.json (within the TYPO3 root path or TYPO3_CONF_VARS[BE][lockRootPath])
  • file path relative to the TYPO3 root: fileadmin/import/foo.json
  • file path using EXT:: EXT:foo/Resources/Private/Data/bar.json
  • fully qualified URL, e.g.
  • FAL reference with storage ID and file identifier: FAL:2:/foo.json
  • custom syntax: MYKEY:whatever_you_want, see Connector Services
encoding string Encoding of the data found in the file. This value must match any of the encoding values recognized by the PHP libray “mbstring”. See
headers array

Key-value pairs of headers that should be sent along with the request. The syntax is as follows:


'headers' => [
    'User-Agent' => 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:75.0) Gecko/20100101 Firefox/75.0'
    'Accept' => 'application/json'
useragent string

This parameter was removed. Please use “headers” instead.

User agent to fake. This is sometimes necessary to bypass access restrictions on some sites. Don’t include the “User-Agent:” part of the header.


Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-US; rv: Gecko/20101203 Firefox/3.6.13

accept string

This parameter was removed. Please use “headers” instead.

Type of content accepted. This is sometimes necessary to really get the data in JSON format. Don’t include the “Accept:” part of the header.




When using this connector with external_import, please mind that the JSON data may not fit the structure expected by external_import. Indeed this extension expects data of type array to be purely two-dimensional, i.e. an indexed list of associative sub-arrays.

Use a hook like processArray in svconnector_json to transform the data’s structure before feeding it into external_import.