apidirect-io Account API

openapi: 3.2.0
info:
  title: Direct Account API
  version: 1.9.1
  description: 'Real-time public data from LinkedIn, Twitter/X, Reddit, YouTube, Instagram, TikTok, Facebook, Threads, Bluesky, Substack, Truth Social, Google Search, Google Maps, news sites, forums, Amazon and Trustpilot, through one REST API with one API key.


    ## Authentication


    Send your API key in the `X-API-Key` header on every request. Create a free account at apidirect.io, then copy a key from the dashboard.


    ## Pricing


    Pay per request with no subscription. Every endpoint has a monthly free tier, and each operation below lists its price. See Pricing.


    ## Errors


    Every error is JSON with an HTTP status, a human-readable `error` and a machine-readable `code`, for example `{"error": "Missing API key", "code": "missing_api_key"}`. Retry 502, 503 and 504 responses, and 429 `concurrency_limit_exceeded` or `upstream_rate_limit`, with exponential backoff. See Error Handling.


    ## Limits


    Up to 10 concurrent requests per endpoint per account; requests to different endpoints are counted separately. Use `POST /v1/batch` to run up to 100 calls in one request. See Rate Limits.'
  termsOfService: https://apidirect.io/terms
  contact:
    name: API Direct support
    url: https://apidirect.io
    email: support@apidirect.io
  x-logo:
    url: https://apidirect.io/static/A.png
    altText: API Direct
servers:
- url: https://apidirect.io
  description: Production
security:
- ApiKeyAuth: []
tags:
- name: Account
  description: Check that an API key works.
paths:
  /v1/time:
    get:
      tags:
      - Account
      operationId: getTime
      summary: Check API Key
      description: 'Returns the current server time. Integrations use it to check that an API key works.


        **Price:** $0.001 per request after the free tier.'
      responses:
        '200':
          description: The key is valid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TimeResponse'
              example:
                timestamp: '2026-10-03T22:30:00.000000+00:00'
                unix: 1791066600
                formatted: 2026-10-03 22:30:00 UTC
        '401':
          description: Missing or invalid API key (`missing_api_key`, `invalid_api_key`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: Free tier used up for this endpoint and no payment method on file (`payment_required`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Account blocked after a failed payment (`account_blocked`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Too many concurrent requests (`concurrency_limit_exceeded`), a spending limit reached (`daily_limit_exceeded`, `monthly_limit_exceeded`), or the data source is rate limiting (`upstream_rate_limit`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      required:
      - error
      - code
      properties:
        error:
          type: string
          description: Human-readable error message.
        code:
          type: string
          description: Machine-readable error code, such as `missing_parameter`, `invalid_parameter`, `missing_api_key`, `invalid_api_key`, `payment_required`, `account_blocked`, `not_found`, `concurrency_limit_exceeded`, `daily_limit_exceeded`, `monthly_limit_exceeded`, `upstream_rate_limit`, `upstream_error`, `upstream_timeout`, `service_unavailable`, `endpoint_suspended`, `payload_too_large` or `rate_limited`. New codes may be added.
      example:
        error: 'Missing required parameter: query'
        code: missing_parameter
    TimeResponse:
      type: object
      properties:
        timestamp:
          type: string
          description: ISO 8601 UTC time.
        unix:
          type: integer
          description: Unix time in seconds.
        formatted:
          type: string
          description: Human-readable UTC time.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Your API key (starts with `ak_live_`), from https://apidirect.io/dashboard/keys.
externalDocs:
  description: API Direct documentation
  url: https://apidirect.io/docs