comp-syn API (1.0.0)

Download OpenAPI specification:Download

E-mail: [email protected] License: Apache 2.0

This is an API for accessing data and analysis generated by the comp-syn python package and the comp-syn group.

search

Access analysis data by query

Find Hits by text matching a query

path Parameters
query
required
string
Examples:
  • shark - Hits with a `query` field matching this value will be returned
  • deep+space - Spaces must be replaced with url-encoded %20 character, or +

Text to match

query Parameters
include_in_response
string
Default: "colorgram"
Enum: "all" "colorgram" "vectors"

Which attributes to include in the returned data

filter
string

(internal) Extra filter to include in the query in lucene query syntax

size
number [ 1 .. 100 ]
Default: 12

Maximum number of hits to return

format
string
Default: "json"
Enum: "json" "html"

Format of response, facilitates a nice browser experience with the API

Responses

Response samples

Content type
application/json
{
  • "hits": [
    ]
}

Find Hits by color similarity to a query

path Parameters
query
required
string

Text to match

query Parameters
include_in_response
string
Default: "colorgram"
Enum: "all" "colorgram" "vectors"

Which attributes to include in the returned data

filter
string

(internal) Extra filter to include in the query in lucene query syntax

size
number [ 1 .. 100 ]
Default: 12

Maximum number of hits to return

format
string
Default: "json"
Enum: "json" "html"

Format of response, facilitates a nice browser experience with the API

use_field
string
Default: "jzazbz_dist"
Enum: "jzazbz_dist" "jzazbz_dist_std" "rgb_dist"

Which dense_vector field to use for finding similar hits

score_function
string
Default: "min_js_divergence"
Enum: "l1norm" "l2norm" "cosineSimilarity" "min_js_divergence" "max_js_divergence"

Which scoring function to use for comparing embeddings. The js_divergence scoring methods use a similar implementation as comp-syn. For the other scoring functions, see the elasticsearch documentation

Responses

Response samples

Content type
application/json
{
  • "hits": [
    ]
}