Make your first request

Your first search takes a few minutes, and test keys are free.

  1. Sign in to the developer console at https://play.fellowverse.app/developers with your email, and name your account. It starts with test keys.

  2. Under Keys, make a test key. Copy it now: it is shown once.

  3. Search:

    text
    export KEY=fv_test_...
    curl https://play.fellowverse.app/v1/search \
      -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
      -d '{"query": "rest for the weary", "limit": 3}'
    
  4. Check what you used, here or under Use in the console:

    text
    curl https://play.fellowverse.app/v1/usage -H "Authorization: Bearer $KEY"
    

Test keys call the same API as live keys, so the code you write now is the code you ship. When you are ready, see Go live.

Next: keep your key secure and check test allowances.


Need the contract? Download OpenAPI. Manage keys and account access in the developer console.

Start here · Guides · API reference