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/homecastr-com:homecastr-com-auth-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

openapi: 3.2.0
info:
  title: Homecastr Auth API
  version: 1.12.0
  description: Probabilistic home value forecasts and canonical public-data resources for US addresses and geographies. Public read endpoints allow anonymous demo access. An API key provides higher limits and account features. Catalog records distinguish metadata, samples, queryable rows, bulk downloads, restricted assets, and unavailable assets.
  contact:
    name: Homecastr Support
    url: https://www.homecastr.com/support
    email: support@homecastr.com
  termsOfService: https://www.homecastr.com/legal
  license:
    name: Proprietary
    url: https://www.homecastr.com/legal
servers:
- url: https://www.homecastr.com
  description: Production
tags:
- name: Auth
  description: API key management and usage tracking
paths:
  /api/v1/keys:
    post:
      operationId: createApiKey
      summary: Request a free API key verification link
      description: Starts email verification for a free API key. The key is shown once only after the email link is confirmed.
      security: []
      tags:
      - Auth
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - email
              properties:
                email:
                  type: string
                  format: email
                attribution:
                  type: object
                  properties:
                    utm_source:
                      type: string
                    utm_medium:
                      type: string
                    utm_campaign:
                      type: string
                    landing_url:
                      type: string
                    referrer:
                      type: string
      responses:
        '200':
          description: Verification request accepted
          content:
            application/json:
              schema:
                type: object
                required:
                - email
                - verification_required
                - verification_sent
                - expires_at
                properties:
                  email:
                    type: string
                    format: email
                  verification_required:
                    type: boolean
                    const: true
                  verification_sent:
                    type: boolean
                  expires_at:
                    type: string
                    format: date-time
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: API key verification request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: API key verification request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: API key verification request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/v1/usage:
    get:
      operationId: getUsage
      summary: API usage stats for your key
      description: 'Returns usage statistics for the authenticated API key: request counts, breakdown by endpoint, source, and status. Requires a non-demo API key.'
      security:
      - ApiKeyAuth: []
      tags:
      - Auth
      responses:
        '200':
          description: Usage stats
          content:
            application/json:
              schema:
                type: object
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        tip:
          type: string
        example:
          type: string
      required:
      - error
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Include your Homecastr API key. Omit (or use `hc_demo_public_readonly`) for the free demo tier (50 req/hr per IP). Get a free key and integration docs at https://www.homecastr.com/docs