Skip to main content

Bring in data from any tool through Marvin’s import APIs

Build custom integrations and import surveys, video, audio, documents, and unstructured data into Marvin

How can I use Marvin’s import APIs?

Marvin provides access to its import APIs so your team can

  1. Build custom integrations between your tools and Marvin. You can do this by writing code or using a third-party connector, such as Make or Zapier.

  2. Import data stored on a device or drive. For example, you could bring in app store reviews, social media metrics, surveys with audio and video responses, etc. You can do bulk uploads and also write code to automatically sync data between tools.

Only Admins on Pro and Enterprise plans can create and share credentials with their team to connect to Marvin’s import APIs.

Which APIs can I access?

You can call Marvin’s APIs to

  1. Login

  2. Create a project

  3. List projects

  4. List files

  5. Import audio, video, and text files

  6. Import CSV files (including unstructured, audio, and video responses)

  7. List Insights

  8. Import Insights

How does it work?

Marvin authorizes every user before they can call the APIs to transfer data.

If you’re a developer, you must reach out to an Admin in Marvin to share credentials. You can exchange these for a temporary access token. If an Admin has already shared the client ID and secret key, follow these instructions to authenticate your access.

If you’re an Admin in Marvin, you must generate and share a Client ID and Secret key with your engineers or developers. You can generate the credentials from the Developer tab in Marvin.

Select Settings > Developer in the left navigation menu. Go to the Marvin API tab.

Click Create API key to generate a new set of credentials. If you’ve already generated a key before, you’ll see the list below.

Specify a name and how long you want the credentials to stay valid. Click Generate to proceed.

You’ll see a client ID and secret key. Make sure you copy the secret key, because it will not be shown again. If you lose the secret key, you will have to generate a new set of credentials.

If you miss copying the Client ID, you can still access it from the Marvin API tab in Developer.

Share the client ID and secret key with your developers/engineering team. They will be able to exchange these for a temporary access token.

Once you and your team can access the APIs from your application, they must follow these instructions to import data:

Which file types can I import?

You can import the following file types into Marvin.

  • Video: mp4, mov, avi, webm, mkv, m4v, wmv, mpeg

  • Audio: mp3, m4a, wav, flac, ogg, aac, aiff, aif, amr

  • Documents: pdf, ppt, pptx, doc, docx, xls, xlsx, txt

  • Images: png, jpg, jpeg, gif, bmp, tiff, webp

You can import up to 10 GB of audio and video and 500MB of documents and images in a single transfer.

Did this answer your question?