IsraBase Stats API

openapi: 3.2.0
info:
  title: IsraBase Stats API
  version: 1.0.0
  contact:
    name: IsraBase
    url: https://israbase.com/developers
    email: api@israbase.com
  license:
    name: 'Data: data.gov.il open data'
    url: https://data.gov.il
  x-logo:
    url: https://israbase.com/icon.svg
    altText: IsraBase
  summary: Israeli companies, nonprofits, partnerships and the business-for-sale board.
  description: 'Read-only JSON API for the IsraBase registry (ישראבייס). Data comes from data.gov.il. Credit IsraBase and data.gov.il when you reuse it. Anonymous clients: 5 requests per minute and 50 per UTC day. A free API key: 5 per minute and 50 per UTC day. Send the key as Authorization: Bearer or as X-API-Key. A key is optional. A free key uses the same limits. Request a free key at https://israbase.com/developers/key. For a higher quota, write to api@israbase.com. Query q is at most 100 characters. Query limit is at most 100, except marketplace listings which allow at most 50. A 401, a 429, and a response to a request with an API key include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset. Those responses are Cache-Control: private, no-store. An anonymous 200 may be cached and does not include those counters. A 429 response also includes Retry-After.'
servers:
- url: https://israbase.com
security:
- bearerAuth: []
- apiKeyHeader: []
- {}
tags:
- name: Stats
paths:
  /api/v1/stats:
    get:
      operationId: getStats
      summary: Registry totals, status breakdown and top cities
      responses:
        '200':
          description: Same helpers as the statistics page, plus nonprofit total.
          content:
            application/json:
              example:
                data:
                  companies: 726138
                  active_companies: 400000
                  partnerships: 28605
                  nonprofits: 75230
                  status:
                  - status: פעילה
                    n: 400000
                  top_cities:
                  - city: תל אביב - יפו
                    n: 100000
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      tags:
      - Stats
components:
  schemas:
    ErrorObject:
      type: object
      required:
      - error
      properties:
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
            message:
              type: string
            retry_after:
              type: integer
              description: Seconds. Present when code is rate_limited.
    RateLimited:
      type: object
      required:
      - error
      properties:
        error:
          type: object
          required:
          - code
          - message
          - retry_after
          properties:
            code:
              const: rate_limited
            message:
              type: string
              examples:
              - Rate limit exceeded. Retry after 12 seconds.
            retry_after:
              type: integer
              examples:
              - 12
  responses:
    TooManyRequests:
      description: Minute or UTC-day quota exceeded.
      headers:
        Retry-After:
          schema:
            type: integer
          description: Seconds until the client may retry.
        RateLimit-Limit:
          schema:
            type: integer
        RateLimit-Remaining:
          schema:
            type: integer
        RateLimit-Reset:
          schema:
            type: integer
          description: Seconds until this window resets.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RateLimited'
          example:
            error:
              code: rate_limited
              message: Rate limit exceeded. Retry after 12 seconds.
              retry_after: 12
    Unauthorized:
      description: The API key is missing a match, empty, or revoked.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorObject'
          example:
            error:
              code: invalid_api_key
              message: Invalid API key.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Optional free API key. An invalid key returns 401.
    apiKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
      description: Optional API key. Same key as bearerAuth.