Diffbot

Diffbot Account API

The Account API from Diffbot — 1 operation(s) for account.

GitHub OpenAPI

Operations 1

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /account View account plan, usage and child tokens · Get Account Details #
Ask an LLM
“What plan is my Diffbot account on and how many API calls have I used?”
“Can I see my API call volume over the last year instead of the default month?”
Tell an agent
Show my account plan, usage and child tokens.
Report my API call volumes for the last {days} days.

Documentation

📖
Documentation
https://www.diffbot.com/docs/bulk/
📖
APIReference
https://www.diffbot.com/docs/bulk/create
📖
Documentation
https://www.diffbot.com/docs/dql/
📖
APIReference
https://www.diffbot.com/docs/dql/get
📖
Documentation
https://www.diffbot.com/docs/enhance/
📖
APIReference
https://www.diffbot.com/docs/enhance/get
📖
Documentation
https://www.diffbot.com/docs/web-search/
📖
APIReference
https://www.diffbot.com/docs/web-search/get
📖
Documentation
https://www.diffbot.com/docs/account
📖
APIReference
https://www.diffbot.com/docs/account

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/diffbot/refs/heads/main/openapi/diffbot-account-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/diffbot:diffbot-account-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

diffbot-account-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Account API
  description: Returns account plan, usage, child tokens, and other account details.
  termsOfService: https://www.diffbot.com/terms/
  contact:
    email: support@diffbot.com
  version: '1.1'
servers:
- url: https://api.diffbot.com/v4
tags:
- name: Account
paths:
  /account:
    get:
      summary: Get Account Details
      description: Returns account plan, usage, child tokens, and other account details.
      operationId: account
      parameters:
      - name: days
        in: query
        description: Pass the number of days (`&days=365`) for which you would like to retrieve API call volumes (default = 31).
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: Successful API Response
          content:
            application/json:
              example:
                created: '2020-04-22'
                usage:
                - date: '2022-05-04'
                  subtitles: 0
                  nlp: 0
                  entities: 10
                  credits: 258
                  refresh: 0
                  proxies: 0
                  videos: 0
                  extractions: 8
                  facets: 0
                - date: '2022-05-03'
                  subtitles: 0
                  nlp: 0
                  entities: 75
                  credits: 1875
                  refresh: 0
                  proxies: 0
                  videos: 0
                  extractions: 0
                  facets: 0
                name: Diffy
                childTokens:
                - xxxx
                - xxxx
                plan: diffy-plans-to-hangout-all-day
                email: sales@diffbot.com
                token: xxxx
                status: active
              schema:
                type: object
                properties:
                  name:
                    type: string
                    description: Name associated with the token.
                  email:
                    type: string
                    description: Email address associated with the token.
                  plan:
                    type: string
                    description: Current plan for the token.
                  planCredits:
                    type: integer
                    description: Amount of monthly calls included.
                  status:
                    type: string
                    description: Status of the token.
                  created:
                    type: string
                    format: date
                  token:
                    type: string
                  childTokens:
                    type: array
                    items:
                      type: string
                    description: List of child or sub-tokens, if there are any associated with your account.
                  usage:
                    type: array
                    description: An array of days and call volume amounts for each day. By default this will return data from the most recent 31 days. Use the `days` argument to adjust the response window. Dates prior to token becoming active will not be returned.
                    items:
                      type: object
                      properties:
                        date:
                          type: string
                          format: date
                          description: Date, e.g. `2019-12-01`.
                        nlp:
                          type: integer
                          description: Total number of Natural Language API calls made.
                        credits:
                          type: integer
                          description: Total number of credits consumed.
                        extractions:
                          type: integer
                          description: Total number of Extraction API calls made.
                        proxies:
                          type: integer
                          description: Total number of calls made using proxy servers. [Read more](/docs/extract/using-proxies).
                        entities:
                          type: integer
                          description: Total number of entities downloaded from the Diffbot Knowledge Graph.
                        refresh:
                          type: integer
                          description: Total number of entity refreshes requested.
                        facets:
                          type: integer
                          description: Total number of facet values returned.
                        videos:
                          type: integer
                          description: Total number of videos downloaded.
                        subtitles:
                          type: integer
                          description: Total number of subtitles requested.
        '401':
          description: Unauthorized
          content:
            application/json:
              example:
                errorCode: 401
                error: Not authorized API token.
              schema:
                type: object
                properties:
                  errorCode:
                    type: integer
                    example: 401
                  error:
                    type: string
                    example: Not authorized API token.
      security:
      - tokenscheme: []
      tags:
      - Account
components:
  securitySchemes:
    tokenscheme:
      type: apiKey
      name: token
      in: query
      description: Your Diffbot API token.