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/datagraph-city:datagraph-city-query-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: Datagraph City Query API
  version: 1.0.0
  description: 'Operations tagged Query across 2 of this provider''s published API definitions: openapi.json, datagraph-city-openapi.json. Each path carries the servers of the definition it was published in.'
tags:
- name: Query
paths:
  /api/{locality}/query:
    post:
      summary: Query Locality Data
      description: 'Query locality data using natural language

        Supports graph queries, vector search, and hybrid queries'
      operationId: query_locality_data_api__locality__query_post
      security:
      - HTTPBearer: []
      parameters:
      - name: locality
        in: path
        required: true
        schema:
          type: string
          title: Locality
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/QueryRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueryResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Query
components:
  schemas:
    QueryRequest:
      properties:
        query:
          type: string
          title: Query
        city:
          type: string
          title: City
          default: nyc
        category:
          anyOf:
          - type: string
          - type: 'null'
          title: Category
        limit:
          type: integer
          maximum: 100.0
          minimum: 1.0
          title: Limit
          default: 10
        cypher_query:
          anyOf:
          - type: string
          - type: 'null'
          title: Cypher Query
          description: 'Optional: Direct Cypher query for advanced users/LLMs. If provided, bypasses natural language translation.'
        cypher_params:
          anyOf:
          - type: object
          - type: 'null'
          title: Cypher Params
          description: 'Optional: Parameters for the Cypher query (parameterized queries recommended for security)'
      type: object
      required:
      - query
      title: QueryRequest
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    QueryType:
      type: string
      enum:
      - graph
      - vector
      - hybrid
      title: QueryType
    QueryResponse:
      properties:
        results:
          items:
            type: object
          type: array
          title: Results
        count:
          type: integer
          title: Count
        execution_time_ms:
          type: integer
          title: Execution Time Ms
        query_type:
          $ref: '#/components/schemas/QueryType'
        credits_used:
          type: integer
          title: Credits Used
      type: object
      required:
      - results
      - count
      - execution_time_ms
      - query_type
      - credits_used
      title: QueryResponse
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
x-refined-from:
- openapi.json
- datagraph-city-openapi.json