Skip to main content

Creating Your User-Agent

Open Library asks every API client to identify itself with a User-Agent header. You create this value yourself; it is not issued by Open Library. No portal login is required — you simply choose a name and email to identify your application.

1

Format your User-Agent string

Combine your product or service name (the name of the application that will be making API calls to Open Library) with a contact email address in parentheses.

  • Format: AppName (contact@example.com)
  • Example: AcmeBooksBot (admin@acme.com)
  • Open Library uses this to identify your traffic and apply per-client rate limits (identified clients get higher limits than anonymous ones)
  • A missing or generic value may cause your requests to be throttled or blocked
1

Connect

  • Click Connect.
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup.
2

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.