{"openapi":"3.1.0","jsonSchemaDialect":"https://spec.openapis.org/oas/3.1/dialect/base","info":{"title":"semanticscholar.org API — compiled by Unbrowse","version":"2026.09.28","summary":"Call semanticscholar.org's own capabilities over HTTP, without a browser.","description":"The first-party capabilities of semanticscholar.org, compiled from the site's own requests. Each tool is one POST with its inputs as a JSON body; the answer is the run, with the site's result when it is verified. Only verified results bill. The same tools are an MCP server at https://unbrowse.ai/api/v1/sites/semanticscholar.org/mcp. Unofficial: not made or endorsed by semanticscholar.org.","contact":{"name":"Unbrowse","url":"https://unbrowse.ai"}},"externalDocs":{"description":"Calling an indexed website","url":"https://unbrowse.ai/docs/site-apis"},"servers":[{"url":"https://unbrowse.ai","description":"Unbrowse"}],"security":[{"bearer":[]}],"tags":[{"name":"semanticscholar.org","description":"Tools compiled from semanticscholar.org"}],"paths":{"/api/v1/sites/semanticscholar.org/call/semanticscholar_org__get_paper_by_id":{"post":{"operationId":"semanticscholar_org__get_paper_by_id","summary":"Paper detail with citations and references","description":"Paper detail with citations and references. Compiled from semanticscholar.org's own requests and indexed by Unbrowse. Inputs: q; query_string. Also takes the site's own parameters, each optional (left out, the recorded value is sent): sort (recorded: \"relevance\"); page (recorded: 1); pageSize (recorded: 10); sort_post_search (recorded: \"relevance\"); yearFilter; requireViewablePdf (recorded: false). Mid-run it asks you to pick selected_result from the options it found (status input_required). Returns responseType, paper, citedPapers, figureExtractions, skipperExperiments, citationSortAvailability. Read-only on semanticscholar.org.","tags":["semanticscholar.org"],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Deadline"},{"$ref":"#/components/parameters/EndUser"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string","description":"q"},"query_string":{"type":"string","description":"query string"},"sort":{"type":"string","description":"Optional: the site's own sort parameter (get_search). Left out, \"relevance\" is sent, as recorded.","default":"relevance"},"page":{"type":"integer","description":"Optional: the site's own page parameter (post_search). Left out, 1 is sent, as recorded.","default":1},"pageSize":{"type":"integer","description":"Optional: the site's own pageSize parameter (post_search). Left out, 10 is sent, as recorded.","default":10},"sort_post_search":{"type":"string","description":"Optional: the site's own sort_post_search parameter (post_search). Left out, \"relevance\" is sent, as recorded.","default":"relevance"},"yearFilter":{"type":"string","description":"Optional: the site's own yearFilter parameter (post_search). Left out, null is sent, as recorded.","default":null},"requireViewablePdf":{"type":"string","description":"Optional: the site's own requireViewablePdf parameter (post_search). Left out, false is sent, as recorded.","default":false},"hydrateWithDdb":{"type":"string","description":"Optional: the site's own hydrateWithDdb parameter (post_search). Left out, true is sent, as recorded.","default":true},"includeTldrs":{"type":"string","description":"Optional: the site's own includeTldrs parameter (post_search). Left out, true is sent, as recorded.","default":true},"performTitleMatch":{"type":"string","description":"Optional: the site's own performTitleMatch parameter (post_search). Left out, true is sent, as recorded.","default":true},"includeBadges":{"type":"string","description":"Optional: the site's own includeBadges parameter (post_search). Left out, true is sent, as recorded.","default":true},"getQuerySuggestions":{"type":"string","description":"Optional: the site's own getQuerySuggestions parameter (post_search). Left out, false is sent, as recorded.","default":false},"includePdfVisibility":{"type":"string","description":"Optional: the site's own includePdfVisibility parameter (post_search). Left out, true is sent, as recorded.","default":true},"requireSlug":{"type":"string","description":"Optional: the site's own requireSlug parameter (get_paper_by_id). Left out, \"true\" is sent, as recorded.","default":"true"},"aggregateCitationsByIntent":{"type":"string","description":"Optional: the site's own aggregateCitationsByIntent parameter (get_paper_by_id). Left out, \"true\" is sent, as recorded.","default":"true"},"withEntitlements":{"type":"string","description":"Optional: the site's own withEntitlements parameter (get_paper_by_id). Left out, \"true\" is sent, as recorded.","default":"true"},"citedPapersLimit":{"type":"integer","description":"Optional: the site's own citedPapersLimit parameter (get_paper_by_id). Left out, \"10\" is sent, as recorded.","default":"10"},"select":{"type":"array","items":{"type":"string"},"description":"Keep only these parts of the result: dots walk keys, [] maps over a list, a final {a,b} keeps several keys (e.g. \"results[].{title,url}\"). Unmatched paths come back in selectMissing."},"deadlineMs":{"type":"integer","minimum":5000,"maximum":300000,"default":60000,"description":"Answer within this many ms (5,000–300,000). Past it: 504 run_timeout with a runId to poll; the run keeps going. The x-unbrowse-deadline-ms header wins."}},"required":["q","query_string"],"additionalProperties":false}}}},"responses":{"200":{"description":"The run finished: `status` succeeded carries the site's verified `result`; failed carries `error` (never billed).","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string","description":"The run, for unbrowse_inspect / resume / cancel"},"status":{"type":"string","enum":["succeeded","input_required","failed","outcome_unknown","cancelled","working","accepted","expired"],"description":"succeeded carries the site's result; input_required lists what to answer (unbrowse_resume)"},"capabilityId":{"type":["string","null"]},"result":{"type":"object","properties":{"responseType":{"type":"string"},"paper":{"type":"object","properties":{"id":{"type":"string"},"corpusId":{"type":"integer"},"title":{"type":"object","properties":{"text":{"type":"string"},"fragments":{"type":"array"}},"required":["text","fragments"]},"slug":{"type":"string"},"paperAbstract":{"type":"object","properties":{"text":{"type":"string"},"fragments":{"type":"array"}},"required":["text","fragments"]},"paperAbstractTruncated":{"type":"string"},"tldr":{"type":"object","properties":{"text":{"type":"string"},"abstractSimilarityScore":{"type":"integer"}},"required":["text","abstractSimilarityScore"]},"authors":{"type":"array","items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"ids":{"type":"array","items":{"type":"string"}},"slug":{"type":"string"},"structuredName":{"type":"object"},"optIsClaimed":{"type":"boolean"},"bitmap$0":{"type":"boolean"},"text":{"type":"string"},"fragments":{"type":"array"}},"required":[]}}},"structuredAuthors":{"type":"array","items":{"type":"object","properties":{"firstName":{"type":"string"},"middleNames":{"type":"array"},"lastName":{"type":"string"}},"required":["firstName","middleNames","lastName"]}},"year":{"type":"object","properties":{"text":{"type":"string"},"fragments":{"type":"array"}},"required":["text","fragments"]},"venue":{"type":"object","properties":{"text":{"type":"string"},"fragments":{"type":"array"}},"required":["text","fragments"]},"venueId":{"type":"string"},"citationContexts":{"type":"array"},"citationStats":{"type":"object","properties":{"citedByBuckets":{"type":"array","items":{"type":"object","properties":{"startKey":{"type":"integer"},"endKey":{"type":"integer"},"count":{"type":"integer"}},"required":["startKey","endKey","count"]}},"keyCitedByBuckets":{"type":"array"},"numCitations":{"type":"integer"},"estNumCitations":{"type":"number"},"numReferences":{"type":"integer"},"numKeyCitations":{"type":"integer"},"numKeyReferences":{"type":"integer"},"numViewableReferences":{"type":"integer"},"keyCitationRate":{"type":"number"},"citationVelocity":{"type":"number"},"citationAcceleration":{"type":"number"},"firstCitationVelocityYear":{"type":"integer"},"lastCitationVelocityYear":{"type":"integer"}},"required":["citedByBuckets","keyCitedByBuckets","numCitations","estNumCitations","numReferences","numKeyCitations","numKeyReferences","numViewableReferences","keyCitationRate","citationVelocity","citationAcceleration","firstCitationVelocityYear","lastCitationVelocityYear"]},"earliestAcquisitionsDate":{"type":"number"},"journal":{"type":"object","properties":{"name":{"type":"string"},"pages":{"type":"string"}},"required":["name","pages"]},"doiInfo":{"type":"object","properties":{"doi":{"type":"string"},"doiUrl":{"type":"string"}},"required":["doi","doiUrl"]},"links":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"linkType":{"type":"string"}},"required":["url","linkType"]}},"primaryPaperLink":{"type":"object","properties":{"url":{"type":"string"},"linkType":{"type":"string"}},"required":["url","linkType"]},"alternatePaperLinks":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"linkType":{"type":"string"},"publisherName":{"type":"string"}},"required":["url","linkType"]}},"entities":{"type":"array"},"entityRelations":{"type":"array"},"faqs":{"type":"array"},"scorecardStats":{"type":"array","items":{"type":"object","properties":{"typeKey":{"type":"string"},"citationCount":{"type":"integer"},"keyCitationCount":{"type":"integer"},"citationIntentCount":{"type":"object","properties":{"background":{"type":"integer"},"methodology":{"type":"integer"},"result":{"type":"integer"}},"required":["background","methodology","result"]},"score":{"type":"integer"}},"required":["typeKey","citationCount","keyCitationCount","citationIntentCount","score"]}},"fieldsOfStudy":{"type":"array","items":{"type":"string"}},"openAccessInfo":{"type":"object","properties":{"status":{"type":"string"}},"required":["status"]},"pubDate":{"type":"string"},"pubUpdateDate":{"type":"string"},"publisher":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]},"badges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}},"isPdfVisible":{"type":"boolean"},"cues":{"type":"object","properties":{},"required":[]}},"required":["id","corpusId","title","slug","paperAbstract","paperAbstractTruncated","tldr","authors","structuredAuthors","year","venue","venueId","citationContexts","citationStats","earliestAcquisitionsDate","journal","doiInfo","links","primaryPaperLink","alternatePaperLinks","entities","entityRelations","faqs","scorecardStats","fieldsOfStudy","openAccessInfo","pubDate","pubUpdateDate","publisher","badges","isPdfVisible","cues"]},"citedPapers":{"type":"object","properties":{"citationType":{"type":"string"},"citations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"corpusId":{"type":"integer"},"title":{"type":"object","properties":{"text":{"type":"string"},"fragments":{"type":"array"}},"required":["text","fragments"]},"slug":{"type":"string"},"venue":{"type":"object","properties":{"text":{"type":"string"},"fragments":{"type":"array"}},"required":["text","fragments"]},"venueId":{"type":"string"},"year":{"type":"integer"},"authors":{"type":"array","items":{"type":"array","items":{"type":"object"}}},"fieldsOfStudy":{"type":"array","items":{"type":"string"}},"numCiting":{"type":"integer"},"numCitedBy":{"type":"integer"},"citationContexts":{"type":"array","items":{"type":"object"}},"isKey":{"type":"boolean"},"badges":{"type":"array","items":{"type":"object"}},"paperAbstract":{"type":"object","properties":{"text":{"type":"string"},"fragments":{"type":"array"}},"required":["text","fragments"]},"tldr":{"type":"object","properties":{"text":{"type":"string"},"abstractSimilarityScore":{"type":"integer"}},"required":["text","abstractSimilarityScore"]},"isPdfVisible":{"type":"boolean"},"cues":{"type":"object","properties":{},"required":[]}},"required":["id","corpusId","title","slug","venue","venueId","year","authors","fieldsOfStudy","numCiting","numCitedBy","citationContexts","isKey","badges","paperAbstract","tldr","isPdfVisible","cues"]}},"requestedPageSize":{"type":"integer"},"pageNumber":{"type":"integer"},"totalCitations":{"type":"integer"},"totalPages":{"type":"integer"},"sort":{"type":"string"},"citationIntent":{"type":"string"},"citationIntentCount":{"type":"object","properties":{"background":{"type":"integer"},"methodology":{"type":"integer"},"result":{"type":"integer"}},"required":["background","methodology","result"]}},"required":["citationType","citations","requestedPageSize","pageNumber","totalCitations","totalPages","sort","citationIntent","citationIntentCount"]},"figureExtractions":{"type":"object","properties":{"figures":{"type":"array"}},"required":["figures"]},"skipperExperiments":{"type":"array","items":{"type":"object","properties":{"objectKey":{"type":"string"},"objectType":{"type":"string"},"experimentName":{"type":"string"},"objectData":{"type":"object","properties":{"corpus_id":{"type":"integer"},"mentions":{"type":"array","items":{"type":"object"}}},"required":["corpus_id","mentions"]},"createdAt":{"type":"number"},"expiresAt":{"type":"number"},"partitionKey":{"type":"string"},"sortKey":{"type":"string"}},"required":["objectKey","objectType","experimentName","objectData","createdAt","expiresAt","partitionKey","sortKey"]}},"citationSortAvailability":{"type":"object","properties":{"citingPapers":{"type":"array","items":{"type":"string"}},"citedPapers":{"type":"array","items":{"type":"string"}}},"required":["citingPapers","citedPapers"]}},"required":["responseType","paper","citedPapers","figureExtractions","skipperExperiments","citationSortAvailability"]},"error":{"type":["object","null"]},"requirements":{"type":"array"},"via":{"type":["string","null"],"enum":["http","rendered",null]}},"required":["runId","status"],"additionalProperties":true}}}},"202":{"description":"The run needs input (`status` input_required): answer `requirements` with POST /api/v1/runs/{runId}/responses.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Run"}}}},"400":{"description":"The body is not JSON, or a value is malformed (invalid_input, bad_request).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or an invalid one: send Authorization: Bearer <key>.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Out of verified calls this month (quota_exceeded) or out of paid credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such tool on this site (not_found).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The tool is quarantined (tool_quarantined): it failed its checks and is rechecked automatically; the message says what to use now.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"An input the tool does not take (unknown_argument): the message lists the ones it does.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (by the site or by Unbrowse): retry after the Retry-After header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"run_timeout: the run did not finish within its deadline. It keeps going: poll the given runId. A verified success is billed once.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunTimeout"}}}}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl -s 'https://unbrowse.ai/api/v1/sites/semanticscholar.org/call/semanticscholar_org__get_paper_by_id' \\\n  -H \"authorization: Bearer $UNBROWSE_API_KEY\" \\\n  -H \"content-type: application/json\" \\\n  -d '{\"q\":\"<q>\",\"query_string\":\"<query_string>\"}'"},{"lang":"TypeScript","label":"TypeScript","source":"import { Unbrowse } from \"@unbrowse/sdk\";\n\nconst ub = new Unbrowse(); // reads UNBROWSE_API_KEY\nconst run = await ub.callTool(\"semanticscholar.org\", \"semanticscholar_org__get_paper_by_id\", {\n  q: \"<q>\",\n  query_string: \"<query_string>\",\n});\nif (run.status === \"succeeded\") console.log(run.result);"},{"lang":"Python","label":"Python","source":"import os, requests\n\nr = requests.post(\n    \"https://unbrowse.ai/api/v1/sites/semanticscholar.org/call/semanticscholar_org__get_paper_by_id\",\n    headers={\"Authorization\": f\"Bearer {os.environ['UNBROWSE_API_KEY']}\"},\n    json={\n        \"q\": \"<q>\",\n        \"query_string\": \"<query_string>\",\n    },\n    timeout=120,\n)\nr.raise_for_status()\nrun = r.json()\nif run[\"status\"] == \"succeeded\":\n    print(run[\"result\"])"}],"x-unbrowse-capability":"public.semanticscholar_org.get_paper_by_id","x-unbrowse-read-only":true,"x-unbrowse-version":"2026.09.28"}},"/api/v1/sites/semanticscholar.org/call/semanticscholar_org__post_search":{"post":{"operationId":"semanticscholar_org__post_search","summary":"Search semanticscholar","description":"Search semanticscholar. Compiled from semanticscholar.org's own requests and shared by an Unbrowse user. Inputs: query. Also takes the site's own parameters, each optional (left out, the recorded value is sent): page (recorded: 1); pageSize (recorded: 10); sort (recorded: \"relevance\"); yearFilter; requireViewablePdf (recorded: false); hydrateWithDdb (recorded: true). Returns results, query, querySuggestions, totalPages, totalResults, stats, matchedAuthors, matchedEntity. Read-only on semanticscholar.org.","tags":["semanticscholar.org"],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/Deadline"},{"$ref":"#/components/parameters/EndUser"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"query (typed during “fill Search text”)"},"page":{"type":"integer","description":"Optional: the site's own page parameter (post_search). Left out, 1 is sent, as recorded.","default":1},"pageSize":{"type":"integer","description":"Optional: the site's own pageSize parameter (post_search). Left out, 10 is sent, as recorded.","default":10},"sort":{"type":"string","description":"Optional: the site's own sort parameter (post_search). Left out, \"relevance\" is sent, as recorded.","default":"relevance"},"yearFilter":{"type":"string","description":"Optional: the site's own yearFilter parameter (post_search). Left out, null is sent, as recorded.","default":null},"requireViewablePdf":{"type":"string","description":"Optional: the site's own requireViewablePdf parameter (post_search). Left out, false is sent, as recorded.","default":false},"hydrateWithDdb":{"type":"string","description":"Optional: the site's own hydrateWithDdb parameter (post_search). Left out, true is sent, as recorded.","default":true},"includeTldrs":{"type":"string","description":"Optional: the site's own includeTldrs parameter (post_search). Left out, true is sent, as recorded.","default":true},"performTitleMatch":{"type":"string","description":"Optional: the site's own performTitleMatch parameter (post_search). Left out, true is sent, as recorded.","default":true},"includeBadges":{"type":"string","description":"Optional: the site's own includeBadges parameter (post_search). Left out, true is sent, as recorded.","default":true},"getQuerySuggestions":{"type":"string","description":"Optional: the site's own getQuerySuggestions parameter (post_search). Left out, false is sent, as recorded.","default":false},"includePdfVisibility":{"type":"string","description":"Optional: the site's own includePdfVisibility parameter (post_search). Left out, true is sent, as recorded.","default":true},"select":{"type":"array","items":{"type":"string"},"description":"Keep only these parts of the result: dots walk keys, [] maps over a list, a final {a,b} keeps several keys (e.g. \"results[].{title,url}\"). Unmatched paths come back in selectMissing."},"deadlineMs":{"type":"integer","minimum":5000,"maximum":300000,"default":60000,"description":"Answer within this many ms (5,000–300,000). Past it: 504 run_timeout with a runId to poll; the run keeps going. The x-unbrowse-deadline-ms header wins."}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The run finished: `status` succeeded carries the site's verified `result`; failed carries `error` (never billed).","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string","description":"The run, for unbrowse_inspect / resume / cancel"},"status":{"type":"string","enum":["succeeded","input_required","failed","outcome_unknown","cancelled","working","accepted","expired"],"description":"succeeded carries the site's result; input_required lists what to answer (unbrowse_resume)"},"capabilityId":{"type":["string","null"]},"result":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"corpusId":{"type":"integer"},"title":{"type":"object","properties":{"text":{"type":"string"},"fragments":{"type":"array","items":{"type":"object"}}},"required":["text","fragments"]},"slug":{"type":"string"},"paperAbstract":{"type":"object","properties":{"text":{"type":"string"},"fragments":{"type":"array","items":{"type":"object"}}},"required":["text","fragments"]},"paperAbstractTruncated":{"type":"string"},"tldr":{"type":"object","properties":{"text":{"type":"string"},"abstractSimilarityScore":{"type":"integer"}},"required":["text","abstractSimilarityScore"]},"authors":{"type":"array","items":{"type":"array","items":{"type":"object"}}},"structuredAuthors":{"type":"array","items":{"type":"object","properties":{"firstName":{"type":"string"},"middleNames":{"type":"array","items":{"type":"string"}},"lastName":{"type":"string"}},"required":["firstName","middleNames","lastName"]}},"year":{"type":"object","properties":{"text":{"type":"string"},"fragments":{"type":"array"}},"required":["text","fragments"]},"venue":{"type":"object","properties":{"text":{"type":"string"},"fragments":{"type":"array"}},"required":["text","fragments"]},"venueId":{"type":"string"},"citationContexts":{"type":"array"},"citationStats":{"type":"object","properties":{"citedByBuckets":{"type":"array","items":{"type":"object"}},"keyCitedByBuckets":{"type":"array"},"numCitations":{"type":"integer"},"estNumCitations":{"type":"number"},"numReferences":{"type":"integer"},"numKeyCitations":{"type":"integer"},"numKeyReferences":{"type":"integer"},"numViewableReferences":{"type":"integer"},"keyCitationRate":{"type":"number"},"citationVelocity":{"type":"number"},"citationAcceleration":{"type":"number"},"firstCitationVelocityYear":{"type":"integer"},"lastCitationVelocityYear":{"type":"integer"}},"required":["citedByBuckets","keyCitedByBuckets","numCitations","estNumCitations","numReferences","numKeyCitations","numKeyReferences","numViewableReferences","keyCitationRate","citationVelocity","citationAcceleration","firstCitationVelocityYear","lastCitationVelocityYear"]},"earliestAcquisitionsDate":{"type":"number"},"journal":{"type":"object","properties":{"name":{"type":"string"},"volume":{"type":"string"},"pages":{"type":"string"}},"required":["name","volume"]},"doiInfo":{"type":"object","properties":{"doi":{"type":"string"},"doiUrl":{"type":"string"}},"required":["doi","doiUrl"]},"links":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"linkType":{"type":"string"},"publisherName":{"type":"string"}},"required":["url","linkType"]}},"primaryPaperLink":{"type":"object","properties":{"url":{"type":"string"},"linkType":{"type":"string"},"publisherName":{"type":"string"}},"required":["url","linkType"]},"alternatePaperLinks":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"linkType":{"type":"string"}},"required":["url","linkType"]}},"entities":{"type":"array"},"entityRelations":{"type":"array"},"faqs":{"type":"array"},"scorecardStats":{"type":"array","items":{"type":"object","properties":{"typeKey":{"type":"string"},"citationCount":{"type":"integer"},"keyCitationCount":{"type":"integer"},"score":{"type":"integer"}},"required":["typeKey","citationCount","keyCitationCount","score"]}},"fieldsOfStudy":{"type":"array","items":{"type":"string"}},"openAccessInfo":{"type":"object","properties":{"status":{"type":"string"},"location":{"type":"object","properties":{"url":{"type":"string"},"isPdf":{"type":"boolean"}},"required":["url","isPdf"]},"license":{"type":"string"}},"required":["status"]},"pubDate":{"type":"string"},"pubUpdateDate":{"type":"string"},"publisher":{"type":"object","properties":{"name":{"type":"string"},"abbreviation":{"type":"string"}},"required":["name"]},"badges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}},"isPdfVisible":{"type":"boolean"},"cues":{"type":"object","properties":{},"required":[]}},"required":["id","corpusId","title","slug","paperAbstract","paperAbstractTruncated","authors","structuredAuthors","year","venue","venueId","citationContexts","citationStats","earliestAcquisitionsDate","journal","doiInfo","links","primaryPaperLink","alternatePaperLinks","entities","entityRelations","faqs","scorecardStats","fieldsOfStudy","openAccessInfo","pubDate","pubUpdateDate","badges","isPdfVisible","cues"]}},"query":{"type":"object","properties":{"queryString":{"type":"string"},"pageSize":{"type":"integer"},"page":{"type":"integer"},"sort":{"type":"string"},"authors":{"type":"array"},"coAuthors":{"type":"array"},"venues":{"type":"array"},"requireViewablePdf":{"type":"boolean"},"includeTldrs":{"type":"boolean"},"getQuerySuggestions":{"type":"boolean"},"fieldsOfStudy":{"type":"array"},"performTitleMatch":{"type":"boolean"},"hydrateWithDdb":{"type":"boolean"},"includeBadges":{"type":"boolean"},"includePdfVisibility":{"type":"boolean"},"cues":{"type":"array","items":{"type":"string"}},"safeFieldsOfStudy":{"type":"array"}},"required":["queryString","pageSize","page","sort","authors","coAuthors","venues","requireViewablePdf","includeTldrs","getQuerySuggestions","fieldsOfStudy","performTitleMatch","hydrateWithDdb","includeBadges","includePdfVisibility","cues","safeFieldsOfStudy"]},"querySuggestions":{"type":"array"},"totalPages":{"type":"integer"},"totalResults":{"type":"integer"},"stats":{"type":"object","properties":{"coAuthors":{"type":"array"},"authors":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"documentCount":{"type":"integer"},"unfilteredDocumentCount":{"type":"integer"}},"required":["value","documentCount","unfilteredDocumentCount"]}},"venues":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"documentCount":{"type":"integer"},"unfilteredDocumentCount":{"type":"integer"}},"required":["value","documentCount","unfilteredDocumentCount"]}},"years":{"type":"array","items":{"type":"object","properties":{"key":{"type":"integer"},"count":{"type":"integer"}},"required":["key","count"]}},"filteredYears":{"type":"array","items":{"type":"object","properties":{"key":{"type":"integer"},"count":{"type":"integer"}},"required":["key","count"]}},"countOfPapersWithViewablePdf":{"type":"integer"},"publicationTypes":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"documentCount":{"type":"integer"},"unfilteredDocumentCount":{"type":"integer"}},"required":["value","documentCount","unfilteredDocumentCount"]}},"fieldsOfStudy":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"documentCount":{"type":"integer"},"unfilteredDocumentCount":{"type":"integer"}},"required":["value","documentCount","unfilteredDocumentCount"]}},"totalCountAfterFilters":{"type":"integer"}},"required":["coAuthors","authors","venues","years","filteredYears","countOfPapersWithViewablePdf","publicationTypes","fieldsOfStudy","totalCountAfterFilters"]},"matchedAuthors":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"influentialCitationCount":{"type":"integer"},"citationCount":{"type":"integer"},"paperCount":{"type":"integer"}},"required":["id","name","slug","influentialCitationCount","citationCount","paperCount"]}},"matchedEntity":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"definition":{"type":"string"},"definitionText":{"type":"string"},"sourceUrls":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"text":{"type":"string"}},"required":["url","text"]}},"relatedEntities":{"type":"array","items":{"type":"object","properties":{"label":{"type":"object","properties":{"parentToChild":{"type":"string"},"childToParent":{"type":"string"}},"required":["parentToChild","childToParent"]},"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"}},"required":["label","id","name","slug"]}}},"required":["id","name","slug","definition","definitionText","sourceUrls","relatedEntities"]}},"required":["results","query","querySuggestions","totalPages","totalResults","stats","matchedAuthors","matchedEntity"]},"error":{"type":["object","null"]},"requirements":{"type":"array"},"via":{"type":["string","null"],"enum":["http","rendered",null]}},"required":["runId","status"],"additionalProperties":true}}}},"202":{"description":"The run needs input (`status` input_required): answer `requirements` with POST /api/v1/runs/{runId}/responses.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Run"}}}},"400":{"description":"The body is not JSON, or a value is malformed (invalid_input, bad_request).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or an invalid one: send Authorization: Bearer <key>.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Out of verified calls this month (quota_exceeded) or out of paid credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such tool on this site (not_found).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The tool is quarantined (tool_quarantined): it failed its checks and is rechecked automatically; the message says what to use now.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"An input the tool does not take (unknown_argument): the message lists the ones it does.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (by the site or by Unbrowse): retry after the Retry-After header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"run_timeout: the run did not finish within its deadline. It keeps going: poll the given runId. A verified success is billed once.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunTimeout"}}}}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl -s 'https://unbrowse.ai/api/v1/sites/semanticscholar.org/call/semanticscholar_org__post_search' \\\n  -H \"authorization: Bearer $UNBROWSE_API_KEY\" \\\n  -H \"content-type: application/json\" \\\n  -d '{\"query\":\"<query>\"}'"},{"lang":"TypeScript","label":"TypeScript","source":"import { Unbrowse } from \"@unbrowse/sdk\";\n\nconst ub = new Unbrowse(); // reads UNBROWSE_API_KEY\nconst run = await ub.callTool(\"semanticscholar.org\", \"semanticscholar_org__post_search\", {\n  query: \"<query>\",\n});\nif (run.status === \"succeeded\") console.log(run.result);"},{"lang":"Python","label":"Python","source":"import os, requests\n\nr = requests.post(\n    \"https://unbrowse.ai/api/v1/sites/semanticscholar.org/call/semanticscholar_org__post_search\",\n    headers={\"Authorization\": f\"Bearer {os.environ['UNBROWSE_API_KEY']}\"},\n    json={\n        \"query\": \"<query>\",\n    },\n    timeout=120,\n)\nr.raise_for_status()\nrun = r.json()\nif run[\"status\"] == \"succeeded\":\n    print(run[\"result\"])"}],"x-unbrowse-capability":"public.semanticscholar_org.post_search","x-unbrowse-read-only":true,"x-unbrowse-version":"2026.09.28"}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"An Unbrowse API key (ub_live_…, from https://unbrowse.ai/app/keys) or an OAuth access token."}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":200},"description":"Makes a retry safe: a repeat with the same key returns the same run instead of starting another."},"Deadline":{"name":"x-unbrowse-deadline-ms","in":"header","required":false,"schema":{"type":"integer","minimum":5000,"maximum":300000,"default":60000},"description":"Answer within this many ms; past it 504 run_timeout (the run keeps going). Same as deadlineMs in the body."},"EndUser":{"name":"X-Unbrowse-End-User","in":"header","required":false,"schema":{"type":"string","maxLength":200},"description":"With an org key: run as this end user, in their own workspace with their own logins."}},"schemas":{"Run":{"type":"object","properties":{"runId":{"type":"string","description":"The run, for unbrowse_inspect / resume / cancel"},"status":{"type":"string","enum":["succeeded","input_required","failed","outcome_unknown","cancelled","working","accepted","expired"],"description":"succeeded carries the site's result; input_required lists what to answer (unbrowse_resume)"},"capabilityId":{"type":["string","null"]},"result":{},"error":{"type":["object","null"]},"requirements":{"type":"array"},"via":{"type":["string","null"],"enum":["http","rendered",null]}},"required":["runId","status"],"additionalProperties":true},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable, e.g. not_found, unknown_argument, quota_exceeded, run_timeout"},"message":{"type":"string","description":"What happened and what to do, in plain words"}},"additionalProperties":true}},"additionalProperties":true},"RunTimeout":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","runId","poll"],"properties":{"code":{"type":"string","const":"run_timeout"},"message":{"type":"string"},"runId":{"type":"string"},"deadlineMs":{"type":"integer"},"poll":{"type":"string","description":"GET this to read the run's answer when it lands"}},"additionalProperties":true}},"additionalProperties":true}}}}