Spock API Query Builder, Version 2

You must sign up for an API account for this query to function. You can get an API account here.

The query builder is an easy way to create URLs for the Spock API. Just fill in fields in the form below, and the query builder will show you the corresponding Spock API URL.

This query is updated as you fill in the fields:

Search fields

query

Freeform query string.

String [default = ""]

name_query

Limit search results to individuals with a specific name.

String [default = ""]

tag_query

Limit search results to individuals with a specific tag or set of tags.

String [default = ""]

location_query

Limit search results by location.

String [default = ""]

age_low

Limits search results to exclude individuals below a certain age.

Integer [default = ""]

age_high

Limits search results to exclude individuals above a certain age.

Integer [default = ""]

gender

Limits search results based on gender.

m or f (male or female) [default = ""]


require_picture

Indicates if pictures are required for results.

1 = Yes, 0 = No [default = 0]

Filter fields

limit

Limits the number of results returned.

Integer (1-10) [default = 10]

offset

Determines which result to begin with (zero-based). E.g., setting offset to 2 would exclude the first two results.

Integer (0-100) [default = 0]

show_age

Show birth and death dates, if available.

1 = Yes, 0 = No [default = 0]

show_blurb

Determines if the bio is returned.

1 = Yes, 0 = No [default = 0]

show_gender

Determines if the gender is returned.

1 = Yes, 0 = No [default = 0]

show_location

Determines if the location is returned.

1 = Yes, 0 = No [default = 0]

show_names

Return the top-voted name.

1 = Yes, 0 = No [default = 0]

show_picture

Return the top-voted picture.

1 = Yes, 0 = No [default = 0]

source

Restrict results to one source.

String [default = ""]

show_related_people

Determines number of related people returned in descending vote score order.

Integer (0-4) [default = 0]

show_tags

Determines number of tags returned in descending vote score order.

Integer (0-7) [default = 0]

show_websites

Determines number of websites returned in descending vote score order.

Integer (0-10) [default = 0]

id

Spock IDs of the people to display, or to constrain the search to.

Comma-separated list of strings, maximum of 10 [default = ""]