Clarivate · Schema
SearchCreateParams
AnalyticsBibliometricsCitationsDataDrug PipelineInsightsIntellectual PropertyLife SciencesPatentsPublicationsResearchScholarly Communication
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/clarivate/main/json-schema/clarivate-search-create-params-schema.json",
"title": "SearchCreateParams",
"x-generated": "2026-10-12",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/clarivate-searches-antibody-api-openapi.yml#/components/schemas/SearchCreateParams",
"oneOf": [
{
"$ref": "#/$defs/SearchCreateSingleQueryParams"
},
{
"$ref": "#/$defs/SearchCreateMultiSequenceParams"
}
],
"$defs": {
"SearchCreateMultiSequenceParams": {
"type": "object",
"required": [
"search"
],
"properties": {
"search": {
"type": "object",
"required": [
"program",
"queries",
"mss"
],
"properties": {
"title": {
"type": "string",
"maxLength": 255,
"description": "Search title"
},
"program": {
"type": "string",
"enum": [
"blastn",
"blastp",
"blastx",
"tblastn",
"tblastx",
"swn",
"swp",
"cdrn",
"cdrp",
"motifn",
"motifp",
"bestseqn",
"bestseqp",
"keyword",
"modification",
"modificationn",
"modificationp"
],
"description": "Search algorithm"
},
"databases": {
"type": "array",
"items": {
"type": "string",
"enum": [
"usgene_patents",
"usgene_applications",
"geneseq",
"fastalert",
"wogene",
"genbank",
"genbank_pat"
]
},
"description": "Convenience shorthand for enabling specific databases (maps to search_options)"
},
"exclude_geneseq_from": {
"type": "array",
"items": {
"type": "string",
"enum": [
"usgene",
"wogene"
]
},
"description": "Exclude GeneSeq documents from specified databases"
},
"search_options": {
"type": "object",
"description": "Search-level options (thresholds, database toggles, date filters, etc.)",
"properties": {
"query_coverage_threshold": {
"type": "number",
"description": "Minimum query coverage (%)"
},
"identities_percent_threshold": {
"type": "number",
"description": "Minimum identity (%)"
},
"auto_params_for_short_sequences": {
"type": "boolean",
"description": "Auto-tune parameters for short sequences (blastn/blastp)"
},
"search_usgene_patents": {
"type": "boolean"
},
"search_usgene_applications": {
"type": "boolean"
},
"search_geneseq": {
"type": "boolean"
},
"search_fastalert": {
"type": "boolean"
},
"search_wipo": {
"type": "boolean"
},
"search_genbank": {
"type": "boolean"
},
"search_genbank_pat": {
"type": "boolean"
},
"exclude_geneseq_documents_from_usgene": {
"type": "boolean"
},
"exclude_geneseq_documents_from_wipo": {
"type": "boolean"
},
"exclude_mega_patents": {
"type": "boolean"
},
"exclude_non_published_applications": {
"type": "boolean"
},
"patent_priority_date_from": {
"type": "string",
"description": "Filter by patent priority date (start)"
},
"patent_priority_date_to": {
"type": "string",
"description": "Filter by patent priority date (end)"
},
"patent_application_date_from": {
"type": "string",
"description": "Filter by patent application date (start)"
},
"patent_application_date_to": {
"type": "string",
"description": "Filter by patent application date (end)"
},
"patent_publication_date_from": {
"type": "string",
"description": "Filter by patent publication date (start)"
},
"patent_publication_date_to": {
"type": "string",
"description": "Filter by patent publication date (end)"
},
"cdr_mismatches": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Mismatch counts allowed per CDR region (heavy/light chains)"
},
"heavy_chain_identity": {
"type": "number",
"description": "Heavy chain identity threshold (%)"
},
"light_chain_identity": {
"type": "number",
"description": "Light chain identity threshold (%)"
},
"individual_identities": {
"type": "boolean",
"description": "Whether to evaluate individual identities (MSS)"
},
"individual_coverage": {
"type": "boolean",
"description": "Whether to evaluate individual query coverages (MSS)"
}
}
},
"program_options": {
"type": "object",
"description": "Program-specific options (varies by program). Common options include evalue, gapopen, gapextend, max_target_seqs, word_size, strand, matrix, etc.",
"properties": {
"evalue": {
"type": "number",
"description": "Expectation value threshold (BLAST programs)"
},
"gapopen": {
"type": "integer",
"description": "Gap opening penalty (BLAST programs)"
},
"gapextend": {
"type": "integer",
"description": "Gap extension penalty (BLAST programs)"
},
"max_target_seqs": {
"type": "integer",
"minimum": 1,
"description": "Max target sequences (BLAST programs)"
},
"word_size": {
"type": "integer",
"description": "Word size for initial match"
},
"strand": {
"type": "string",
"enum": [
"both",
"minus",
"plus"
],
"description": "Query strand (nucleotide programs)"
},
"matrix": {
"type": "string",
"description": "Scoring matrix (protein programs: PAM30, PAM70, BLOSUM45, BLOSUM62, BLOSUM80)"
},
"task": {
"type": "string",
"description": "BLAST sub-task (e.g. blastn, megablast)"
},
"subject_length_min": {
"type": "integer",
"minimum": 1,
"maximum": 100000,
"description": "Minimum subject length"
},
"subject_length_max": {
"type": "integer",
"minimum": 1,
"maximum": 100000,
"description": "Maximum subject length"
},
"ungapped": {
"type": "boolean",
"description": "Perform ungapped alignment (BLAST programs)"
},
"mat": {
"type": "string",
"description": "Scoring matrix (SW programs: DNA, NUC.4.4)"
},
"gapo": {
"type": "integer",
"description": "Gap opening penalty (SW programs)"
},
"gape": {
"type": "integer",
"description": "Gap extension penalty (SW programs)"
},
"min_score": {
"type": "integer",
"minimum": 1,
"description": "Minimum alignment score (SW programs)"
},
"topscore_num": {
"type": "integer",
"minimum": 1,
"description": "Number of top scoring sequences (SW programs)"
},
"reverse": {
"type": "boolean",
"description": "Search reverse complement (SW nucleotide)"
},
"sequences_type": {
"type": "string",
"enum": [
"protein",
"nucleotide"
],
"description": "Sequences type for keyword/FTS search"
},
"max_documents_per_source": {
"type": "integer",
"description": "FTS limit on documents per database source"
}
}
},
"query_builder": {
"type": "object",
"description": "Advanced query builder filters for refining search scope"
},
"seqmod_query_builder": {
"type": "object",
"description": "Sequence modification query builder configuration (type, position, name)"
},
"monitor_options": {
"type": "object",
"description": "Search monitoring configuration for recurring searches"
},
"queries": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Multiple sequence queries in FASTA format"
},
"mss": {
"type": "boolean",
"enum": [
true
],
"description": "Must be true for multi-sequence search mode"
}
}
}
}
},
"SearchCreateSingleQueryParams": {
"type": "object",
"required": [
"search"
],
"properties": {
"search": {
"type": "object",
"required": [
"program",
"query"
],
"properties": {
"title": {
"type": "string",
"maxLength": 255,
"description": "Search title"
},
"program": {
"type": "string",
"enum": [
"blastn",
"blastp",
"blastx",
"tblastn",
"tblastx",
"swn",
"swp",
"cdrn",
"cdrp",
"motifn",
"motifp",
"bestseqn",
"bestseqp",
"keyword",
"modification",
"modificationn",
"modificationp"
],
"description": "Search algorithm"
},
"databases": {
"type": "array",
"items": {
"type": "string",
"enum": [
"usgene_patents",
"usgene_applications",
"geneseq",
"fastalert",
"wogene",
"genbank",
"genbank_pat"
]
},
"description": "Convenience shorthand for enabling specific databases (maps to search_options)"
},
"exclude_geneseq_from": {
"type": "array",
"items": {
"type": "string",
"enum": [
"usgene",
"wogene"
]
},
"description": "Exclude GeneSeq documents from specified databases"
},
"search_options": {
"type": "object",
"description": "Search-level options (thresholds, database toggles, date filters, etc.)",
"properties": {
"query_coverage_threshold": {
"type": "number",
"description": "Minimum query coverage (%)"
},
"identities_percent_threshold": {
"type": "number",
"description": "Minimum identity (%)"
},
"auto_params_for_short_sequences": {
"type": "boolean",
"description": "Auto-tune parameters for short sequences (blastn/blastp)"
},
"search_usgene_patents": {
"type": "boolean"
},
"search_usgene_applications": {
"type": "boolean"
},
"search_geneseq": {
"type": "boolean"
},
"search_fastalert": {
"type": "boolean"
},
"search_wipo": {
"type": "boolean"
},
"search_genbank": {
"type": "boolean"
},
"search_genbank_pat": {
"type": "boolean"
},
"exclude_geneseq_documents_from_usgene": {
"type": "boolean"
},
"exclude_geneseq_documents_from_wipo": {
"type": "boolean"
},
"exclude_mega_patents": {
"type": "boolean"
},
"exclude_non_published_applications": {
"type": "boolean"
},
"patent_priority_date_from": {
"type": "string",
"description": "Filter by patent priority date (start)"
},
"patent_priority_date_to": {
"type": "string",
"description": "Filter by patent priority date (end)"
},
"patent_application_date_from": {
"type": "string",
"description": "Filter by patent application date (start)"
},
"patent_application_date_to": {
"type": "string",
"description": "Filter by patent application date (end)"
},
"patent_publication_date_from": {
"type": "string",
"description": "Filter by patent publication date (start)"
},
"patent_publication_date_to": {
"type": "string",
"description": "Filter by patent publication date (end)"
},
"cdr_mismatches": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Mismatch counts allowed per CDR region (heavy/light chains)"
},
"heavy_chain_identity": {
"type": "number",
"description": "Heavy chain identity threshold (%)"
},
"light_chain_identity": {
"type": "number",
"description": "Light chain identity threshold (%)"
},
"individual_identities": {
"type": "boolean",
"description": "Whether to evaluate individual identities (MSS)"
},
"individual_coverage": {
"type": "boolean",
"description": "Whether to evaluate individual query coverages (MSS)"
}
}
},
"program_options": {
"type": "object",
"description": "Program-specific options (varies by program). Common options include evalue, gapopen, gapextend, max_target_seqs, word_size, strand, matrix, etc.",
"properties": {
"evalue": {
"type": "number",
"description": "Expectation value threshold (BLAST programs)"
},
"gapopen": {
"type": "integer",
"description": "Gap opening penalty (BLAST programs)"
},
"gapextend": {
"type": "integer",
"description": "Gap extension penalty (BLAST programs)"
},
"max_target_seqs": {
"type": "integer",
"minimum": 1,
"description": "Max target sequences (BLAST programs)"
},
"word_size": {
"type": "integer",
"description": "Word size for initial match"
},
"strand": {
"type": "string",
"enum": [
"both",
"minus",
"plus"
],
"description": "Query strand (nucleotide programs)"
},
"matrix": {
"type": "string",
"description": "Scoring matrix (protein programs: PAM30, PAM70, BLOSUM45, BLOSUM62, BLOSUM80)"
},
"task": {
"type": "string",
"description": "BLAST sub-task (e.g. blastn, megablast)"
},
"subject_length_min": {
"type": "integer",
"minimum": 1,
"maximum": 100000,
"description": "Minimum subject length"
},
"subject_length_max": {
"type": "integer",
"minimum": 1,
"maximum": 100000,
"description": "Maximum subject length"
},
"ungapped": {
"type": "boolean",
"description": "Perform ungapped alignment (BLAST programs)"
},
"mat": {
"type": "string",
"description": "Scoring matrix (SW programs: DNA, NUC.4.4)"
},
"gapo": {
"type": "integer",
"description": "Gap opening penalty (SW programs)"
},
"gape": {
"type": "integer",
"description": "Gap extension penalty (SW programs)"
},
"min_score": {
"type": "integer",
"minimum": 1,
"description": "Minimum alignment score (SW programs)"
},
"topscore_num": {
"type": "integer",
"minimum": 1,
"description": "Number of top scoring sequences (SW programs)"
},
"reverse": {
"type": "boolean",
"description": "Search reverse complement (SW nucleotide)"
},
"sequences_type": {
"type": "string",
"enum": [
"protein",
"nucleotide"
],
"description": "Sequences type for keyword/FTS search"
},
"max_documents_per_source": {
"type": "integer",
"description": "FTS limit on documents per database source"
}
}
},
"query_builder": {
"type": "object",
"description": "Advanced query builder filters for refining search scope"
},
"seqmod_query_builder": {
"type": "object",
"description": "Sequence modification query builder configuration (type, position, name)"
},
"monitor_options": {
"type": "object",
"description": "Search monitoring configuration for recurring searches"
},
"query": {
"type": "string",
"description": "Single sequence query string"
}
}
}
}
}
}
}Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.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.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/clarivate-search-create-params"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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.
A second provider on the same verified email joins the account you already have.