Import/Export API

Important: Read the introduction before proceeding.

Import API

The Import API allows importing a list of visits into woopra. The visits can then be seamlessly accessed in reporting, visitor profiles, schemas, labels…

Details

As described in the HTTP tracking API, events can be pushed into woopra with custom timestamps, simply by adding a unix timestamp (in Milliseconds) to the tracking request.

Example:


http://www.woopra.com/track/ce/

?host=mywebsite.com
&id=john@mail.com
&response=json
&cookie=AH47DHS5SF182DIQZJD
&timeout=300000
&cv_username=John+Smith
&cv_email=john@mail.com
&event=purchase
&ce_amount=149.95 
&timestamp=1381968226977

Important:

  • The imported data will be permanently written to the system, and the operation cannot be rolled back.

Export API

the Export API allows exporting a list of visits from Woopra.

Details

The data export API allows exporting visits on a daily basis only.
To export, a GET request has to be sent to https://www.woopra.com/rest/export/auth/logs

Parameters

Name Description
website The project name as registered in Woopra
day The day of the log file ex: 2015-01-01
format (optional) The downloaded file format. Supported formats are “json” and “default” (line-separated \n visit JSON texts for streaming)

Example (command line):

curl --user appID:secretKey 'https://www.woopra.com/rest/export/auth/logs?website=mybusiness.com&day=2014-01-01' > 2014-01-01.logs

Example (browser):


https://www.woopra.com/rest/export/auth/logs

?website=mybusiness.com
&day=2014-01-01
&access-secret=Z6iwneq...
&access-id=NI09...

Output:

{"date":"2014-03-20","country":"US","os":"Win","city":"Los Angeles","ip":"99.141.29.9","language":"English","pid":"rpE...
{"date":"2014-03-20","country":"UK","os":"Win","city":"London","ip":"99.188.29.9","language":"English","pid":"nXe...
{"date":"2014-03-20","country":"US","os":"Mac","city":"San Francisco","ip":"101.11.9.18","language":"English","pid":"nTu...
...

Important

Woopra data logs are incremental; the logs for a certain date are the collection of all logged events during that day- even if they were logged with different timestamps or with special functions such as deleting the visitor.

Your parser should be able to process inserts and deletes. When a visitor is deleted, the visit log will have the following properties:

  • type: system
  • method: delete

This is handled by deleting your copy of the visitor, and expecting a clone of the profile history data under a different ID further in the log file.

Do you know what your customers are doing?
Find out in 5 minutes.

Start your 30-day free trial. No credit cards. No obligations.

Try it out