Edgepedia API
વિશ્વકોશના 500,000થી વધુ લેખો, અને તેમાં સતત ઉમેરો થતો રહે છે—JSON સ્વરૂપે. મફત. કોઈ કી નહીં, કોઈ નોંધણી નહીં. શ્રેય આપીને વ્યાવસાયિક ઉપયોગ કરી શકાય છે. AI તાલીમ સૌ માટે ખુલ્લી છે.
અજમાવી જુઓ
- www.edgepedia.org/api/v1/search?q=koala
- www.edgepedia.org/api/v1/articles/koala
- www.edgepedia.org/api/v1/random
- www.edgepedia.org/api/v1/topics
વાંચવા માટેના રૂટ GET વાપરે છે; માઇગ્રેશન, બૅચ અને તમે મોકલો તે લખાણ માટે POST વપરાય છે. દરેક રૂટ કોઈ પણ પ્રોગ્રામ કે વેબ પેજને JSONમાં જવાબ આપે છે (CORS દરેક ઓરિજિનને મંજૂરી આપે છે). મશીન વાંચી શકે એવું વર્ણન: /openapi.json, જેમાં દરેક રૂટ માટે જવાબનો એક નમૂનો છે; એ જ વર્ણન OpenAPI 3.0માં, મૉડલ માટે ફંક્શન વ્યાખ્યાઓ, TypeScript ટાઇપ્સ અને રિક્વેસ્ટ કલેક્શન્સ નીચે ‘જનરેટ કરેલી ફાઇલો’ હેઠળ આપેલાં છે.
સંદર્ભ કાર્ડ
પસંદ કરેલો લેખ: Cantor's diagonal argument
તમારી વેબસાઇટ માટેના કાર્ડમાં લેખનું શીર્ષક, સંપૂર્ણ સારાંશ અને Edgepediaને શ્રેય.
/embed/{id}?theme=auto લેખના પ્રમાણભૂત ID પરથી કાર્ડ આપે છે. દેખાવ auto, light અથવા dark હોઈ શકે છે. વૈકલ્પિક /assets/edgepedia-embed.js સ્ક્રિપ્ટ ફ્રેમને તેની અંદરની સામગ્રીના માપ પ્રમાણે ગોઠવે છે; તેના વિના પણ ફ્રેમ વાંચી શકાય છે અને સ્ક્રોલ કરી શકાય છે.
/embed/{slug} પણ ચાલે છે: તે થીમ જાળવી રાખીને લેખના ID પરના કાર્ડ તરફ રીડાયરેક્ટ કરે છે. Edgepedia oEmbed પ્રદાતા પણ છે: GET /oembed?url={article or card URL}&format=json ઉપરના બિલ્ડર જેવો જ એમ્બેડ કોડ html તરીકે આપે છે, સાથે શીર્ષક, પહોળાઈ અને ઊંચાઈ પણ આપે છે; maxwidth અને maxheightને અનુસરવામાં આવે છે. Generalના દરેક લેખના પેજના <head>માં તેનું oEmbed સરનામું લિંક કરેલું હોય છે, તેથી WordPress, Discourse અને oEmbed વાપરતાં અન્ય સૉફ્ટવેર પેસ્ટ કરેલી Edgepedia લિંકને કાર્ડમાં ફેરવી દે છે.
રૂટ
| રૂટ | શું આપે છે |
|---|---|
/api/v1/search?q=words | શીર્ષકો અને અન્ય નામો સાથે મેળ શોધે છે, શ્રેષ્ઠ મેળ પહેલાં આપે છે. કોઈ વિષયનું નામ શોધો, પ્રશ્ન નહીં. દરેક પરિણામમાં: id, શીર્ષક, ટોચના સ્તરનો વિષય, પૂર્વાવલોકન લખાણ, લિંક્સ અને મેળ કેવી રીતે મળ્યો તેની માહિતી (match, confidence). કોઈ વિષય દર્શાવતા શબ્દો, જેમ કે "science fiction writers", topics પણ આપે છે, જે તે વિષયના લેખોની લિંક છે. limit પેજદીઠ પરિણામોની સંખ્યા છે, 1થી 30 (ડિફૉલ્ટ 10); pageથી પેજ બદલાય છે, અને છેલ્લાં પેજ પછીનું પેજ ખાલી હોય છે. અન્ય નામો અને ખોટી જોડણી પણ ચાલે છે: "zhu yuanzhang" શોધવાથી હોંગવુ સમ્રાટ મળે છે, અને "siddartha" did_you_mean આપે છે. વધુ વિકલ્પો: નીચે ‘શોધ’ જુઓ. |
/api/v1/articles/{slug} | લેખ Markdown તરીકે, તેનો વિષય-પથ, ભૂગોળ વૃક્ષમાં તેનાં સ્થાન (geo), છેલ્લે અપડેટ થયાની તારીખ અને દર્શાવવાની શ્રેય-પંક્તિ. કોઈ પણ નામ ચાલે છે (Mount_Fuji, શીર્ષક, આખું સરનામું), અને વિકલ્પો દ્વારા કોઈ વિભાગ, રૂપરેખા, અંશો કે અન્ય સ્વરૂપો મેળવી શકાય છે: નીચે ‘લેખ વાંચવો’ જુઓ. |
/api/v1/articles?id={id} | એ જ માહિતી, id પરથી. લેખસંગ્રહના માઇગ્રેશન પછી પણ લેખોના જૂના id કામ કરતા રહે છે; વૃક્ષમાં ફેરફાર થાય ત્યારે વિષયોના id બદલાઈ શકે છે. સરનામું બદલાઈ શકે છે; જૂનું સરનામું હજી પણ moved_from સાથે જવાબ આપે છે. ids= એકસાથે વધુમાં વધુ 10 સ્વીકારે છે. |
/api/v1/leads?ids={id},{id} | કાર્ડના પેજ માટે id પરથી વધુમાં વધુ 50 લેખો, દરેક શોધ-પરિણામના સ્વરૂપમાં (id, શીર્ષક, ટોચના સ્તરનો વિષય, પૂર્વાવલોકન લખાણ, લિંક્સ). માઇગ્રેટ થયેલા અને મર્જ થયેલા id માટે, માગેલા idની કી હેઠળ, અંતે જળવાયેલો લેખ મળે છે; પરિણામનું id પ્રમાણભૂત હોય છે. અજાણ્યા કે અનુપલબ્ધ id છોડી દેવાય છે. |
/api/v1/random | યાદૃચ્છિક રીતે પસંદ કરેલો એક લેખ. new=1 સૌથી નવા લેખોમાંથી પસંદ કરે છે; topic= અથવા geo= કોઈ નોડ હેઠળના લેખોમાંથી પસંદ કરે છે. |
/api/v1/related/{slug} | એક જ કૉલમાં લેખના પાડોશી લેખો: તેના પોતાના વિષયમાં તેની સૌથી નજીકના વધુમાં વધુ 10, નજીકના વધુમાં વધુ 8 વિષયોમાંથી દરેકના 3, અને તે સમાવિષ્ટ હોય તેવા દરેક ભૂગોળ નોડમાં તેની સૌથી નજીકના વધુમાં વધુ 10. ?id={id} પણ. તેના બદલે by=links તેની સાથે સંદર્ભિત થતા લેખો આપે છે. |
/api/v1/topics | વિષય વૃક્ષનું ટોચનું સ્તર. |
/api/v1/topics/{id} | વિષયનો પથ, લેખોની સંખ્યા સાથે તેના પેટાવિષયો અને તેની હેઠળનો દરેક લેખ, પેજદીઠ 30. format=mermaid તેનું ઉપવૃક્ષ દોરે છે. |
/api/v1/geo | ભૂગોળ વૃક્ષ: તેના પ્રદેશો, દરેકના સમયગાળાઓ સાથે. |
/api/v1/geo/{id} | વિષય જેવા જ માળખામાં ભૂગોળ નોડ: તેનો પથ, વધુ ચોક્કસ નોડ અને લેખો, પેજદીઠ 30. પ્રદેશ માત્ર તેના સમયગાળાઓની યાદી આપે છે. |
POST /api/v1/ids/translate | v1.5 માઇગ્રેશન સક્રિય હોય ત્યારે: {"ids":["old-id", "another-id"]} મોકલો (વધુમાં વધુ 500 જુદા id). જવાબ બદલાયેલા idને તેમના પ્રમાણભૂત, જળવાયેલા id સાથે જોડે છે; ન બદલાયેલા કે અજાણ્યા id છોડી દેવાય છે. પૂર્ણ થયેલી બૅચના ચેકપૉઇન્ટ સાચવો અને Retry-Afterનું પાલન કરો. |
પૂર્વાવલોકન લખાણ માટે લેખસંગ્રહમાં ટૂંકો અંશ ઉપલબ્ધ હોય તો તે વપરાય છે, નહીં તો લેખની શરૂઆત વપરાય છે. જે રેકૉર્ડ અને પરિણામોમાં ટૂંકો અંશ હોય તેમાં તે snippet તરીકે પણ સામેલ હોય છે; markdownમાં હંમેશાં લેખનું સંપૂર્ણ લખાણ રહે છે. node હાજર હોય ત્યારે તે લેખનો વર્તમાન સંકલ્પના-વૃક્ષ નોડ છે.
દરેક લેખ તેના પોતાના સરનામે Markdown તરીકે પણ મળે છે. .md ઉમેરો: www.edgepedia.org/koala.md.
MCP સર્વર
https://www.edgepedia.org/mcp. તેને Claudeમાં કસ્ટમ કનેક્ટર તરીકે, ChatGPTમાં Developer mode ચાલુ કરીને, VS Code અથવા Cursorમાં એક ક્લિકથી, અથવા અન્ય કોઈ MCP ક્લાયન્ટમાં તેના સરનામાથી ઉમેરો. કોઈ કી નહીં, કોઈ સાઇન-ઇન નહીં. માત્ર વાંચવા માટેનાં પાંચ ટૂલ: search (વિષયનું નામ આપો, મેળ ખાતા લેખો મેળવો, અને શબ્દો કોઈ વિષય દર્શાવતા હોય તો તે વિષય પણ), fetch (એક લેખ Markdown તરીકે, તેની શ્રેય-પંક્તિ, વિષય-પથ અને ભૂગોળ સાથે; લગભગ ચોથા ભાગ જેટલું ટૂંકું લખાણ મેળવવા citations: false; topic: id તે વિષયનો ઉપરી વિષય, વધુ ચોક્કસ વિષયો અને લેખોની યાદી આપે છે, એક pageમાં 120; topic:root અને topic:geo વિષય અને ભૂગોળ વૃક્ષોનાં ટોચનાં સ્તર છે), related (લેખના પોતાના વિષય, નજીકના વિષયો અને ભૂગોળમાં તેના પાડોશી લેખો; તેની સાથે સંદર્ભિત થતા લેખો માટે by: "links"), connect (from, to: બે લેખો વચ્ચેની લિંક્સની શૃંખલા, જેમ /api/v1/path આપે છે), અને resolve (name, વૈકલ્પિક context અને type સાથે: કોઈ નામ સૌથી સંભવિત રીતે જે લેખને દર્શાવે તે, જેમ /api/v1/resolve આપે છે). searchમાં શીર્ષકનો મેળ ન મળતો હોય પણ લખાણનો મેળ મળતો હોય એવા લેખો શીર્ષકનો મેળ મળતા લેખો પછી આવે છે; તેમને match: fulltext તરીકે ચિહ્નિત કરાય છે, તેઓ limitની મર્યાદામાં રહે છે અને pagesમાં ગણાય છે. ટૂલની ભૂલ એ મૉડલ વાંચે એવું લખાણ છે (કોઈ લેખનો ન હોય એવા id માટે did_you_mean id સાથે); તેનો કોડ _meta["ai.edgechat/error"]માં આવે છે, કદી structuredContentમાં નહીં. links: "in" સાથેનું fetch ત્યાં લિંક કરતા પછીના 30 લેખો માટે links_page સ્વીકારે છે.
searchમાં limit (1થી 30, ડિફૉલ્ટ 10), page, first, topic અને sort આપી શકાય છે, અને તે page તથા pages આપે છે; fetch નીચે આપેલા લેખના વિકલ્પો સ્વીકારે છે, અને એકસાથે ઘણા લેખો માટે ids સ્વીકારે છે. દરેક પરિણામમાં લેખનો કાયમી id, canonical_id, હોય છે: fetch તેને સ્વીકારે છે, અને તમે સાચવી રાખેલો id કે સરનામું બદલાયું હોય ત્યારે fetch લેખ આપે છે અને તેના moved_fromમાં તમે જે માગ્યું હતું તે મૂકે છે. પરિણામો _meta.corpus_versionમાં લેખસંગ્રહની રિલીઝ દર્શાવે છે. 2025-06-18 કે તે પછીના પ્રોટોકોલ પરના ક્લાયન્ટને લેખદીઠ એક resource_link પણ મળે છે.
રિસોર્સ: edgepedia://article/{slug} (લેખ Markdown તરીકે, fetch જેવું જ લખાણ) અને edgepedia://topic/{id} (વિષયના વધુ ચોક્કસ વિષયો અને લેખો), બંને માટે ઑટોકમ્પ્લીશન સાથે; લેખ દર્શાવતી કોઈ પણ દલીલ માટે ઑટોકમ્પ્લીશન લેખનાં શીર્ષકો પણ સૂચવે છે. Agent Skill પણ MCP મારફતે મળે છે (skills/list, skills/get), skill://edgepedia/SKILL.md તરીકે. /mcp પર GET કરવાથી સર્વર કાર્ડ JSON તરીકે મળે છે. માત્ર text/event-stream સ્વીકારતા ક્લાયન્ટને દરેક જવાબ એક SSE message ઇવેન્ટ તરીકે મળે છે. ટૂલ-યાદીનું sha256 દરેક જવાબના _meta (ai.edgechat/tools-sha256)માં આવે છે, જેથી ટૂલના વર્ણનમાં થયેલો ફેરફાર દેખાય છે.
Windows (પ્રીવ્યૂ, બિલ્ડ 26220.7262 કે પછીનું): odr.exe mcp add --uri https://www.edgepedia.org/mcp. અન્ય દરેક ક્લાયન્ટ માટે સેટઅપની લાઇનો, એક Agent Skill અને ઉદાહરણો: github.com/EdgePlat/edgepedia-mcp.
MCP નથી, અથવા ક્લાયન્ટ માત્ર જૂનું SSE ટ્રાન્સપોર્ટ જ વાપરે છે? તમારા મૉડલને /api/v1/search અને /api/v1/articles/{slug}ને કૉલ કરતાં બે ફંક્શન આપો, અથવા /tools.json પરથી તૈયાર ફંક્શન લઈ લો. જૂના ટ્રાન્સપોર્ટનાં સરનામાં (/sse, /mcp/sse) 404 આપે છે, જેના બૉડીમાં https://www.edgepedia.org/mcp દર્શાવેલું હોય છે.
મર્યાદાઓ
IP સરનામાદીઠ મિનિટે 600 અને દિવસે 100,000 રિક્વેસ્ટ—API અને MCP સર્વર બંને માટે. દરેક જવાબ RateLimit-Policyમાં બંને સમયગાળા દર્શાવે છે. મર્યાદા વટાવતાં API, Retry-After અને RateLimit સાથે 429 આપે છે; MCP ટૂલ કૉલ ટૂલની ભૂલ આપે છે, જેના retry_afterમાં સેકન્ડની સંખ્યા હોય છે. ગણતરી સર્વરના દરેક ઇન્સ્ટન્સ માટે અલગ રાખવામાં આવે છે, એટલે આ મર્યાદાઓથી નીચે રહેવાનું છે; તેને ચોક્કસ માપક ગણવું નહીં. કૃપા કરીને કૅશ વાપરો. id-અનુવાદની વિનંતીમાં માગેલા દરેક idની અલગ ગણતરી થાય છે; જૂના id ચકાસતી /leads બૅચમાં પણ જૂના idદીઠ ગણતરી થાય છે. અન્ય બૅચમાં દરેક id કે નામ એક રિક્વેસ્ટ ગણાય છે, અને એનોટેશનમાં દર 1,000 અક્ષરે એક રિક્વેસ્ટ ગણાય છે.
લાઇસન્સ
Edgepedia સમુદાય લાઇસન્સ 1.0: શ્રેય આપો તો મફત, વ્યાવસાયિક ઉપયોગ સહિત. AI તાલીમ સૌ માટે ખુલ્લી છે, અને મૉડલના આઉટપુટમાં શ્રેય આપવો જરૂરી નથી. અન્ય ઉપયોગો માટે, 100 મિલિયન અમેરિકી ડૉલરથી વધુ આવક અથવા 100 મિલિયનથી વધુ માસિક વપરાશકર્તા ધરાવતી સંસ્થાઓએ અલગ લાઇસન્સ લેવું પડે છે.
શ્રેય: જ્યાં પણ કોઈ લેખનું લખાણ દર્શાવો ત્યાં તેની credit પંક્તિ તેની લિંક સહિત દર્શાવો. લેખના જવાબોમાં તે પેસ્ટ કરવા તૈયાર સ્વરૂપે credit_md અને credit_html તરીકે, તેમજ license.spdx (LicenseRef-Edgepedia-Community-1.0) પણ હોય છે. APIના લેખના અને /leadsના જવાબોમાં Link: <https://www.edgepedia.org/edgepedia/license>; rel="license" અને X-License: LicenseRef-Edgepedia-Community-1.0 હોય છે.
EdgeChat ઍપ, તેની Edge Apps અને અમારું સૉફ્ટવેર વિનામૂલ્યે મળે છે, પણ માલિકીહક હેઠળ છે: સોર્સ કોડ આપવામાં આવતો નથી, અને તેમની નકલ, ફેરફાર કે પુનર્વિતરણ કરી શકાતું નથી (EdgeChat લાઇસન્સ કરાર).
ભૂલો
JSON: { "error": { "code": "not_found", "message": "…" } }. 400માં q ખૂટે છે, 404 મળ્યું નથી, 410 દૂર કરાયું છે, 413 લખાણ ખૂબ લાંબું છે, 429 ઘણી વધારે રિક્વેસ્ટ છે, 503 ફરી પ્રયાસ કરો. 404 આગળનો કૉલ દર્શાવે છે: hint, next (એક URL), અને કોઈ જવાબ ન આપતા લેખના સરનામા માટે, સૌથી નજીકનાં ત્રણ શીર્ષકો સાથે did_you_mean. MCPના fetch ટૂલની ‘મળ્યું નથી’ ભૂલમાં પણ એ જ did_you_mean હોય છે.
ફેરફારો
આવૃત્તિ 1નું માળખું યથાવત્ રહે છે: ફીલ્ડ ઉમેરાઈ શકે છે, પણ તેમનાં નામ કદી બદલાશે નહીં કે તેમને દૂર કરાશે નહીં. Edgepediaના પોતાના ફેરફારો /edgepedia/updates પર છે. જ્યારે કોઈ રિલીઝ વિષય વૃક્ષને ફરી ગોઠવે છે, જેમ 1.8.0એ કર્યું હતું, ત્યારે બદલાયેલો વિષય id તેના નવા id સાથે 301 આપે છે, અને /api/v1/changes?since=<release> તે રિલીઝ પછી ઉમેરાયેલા, બદલાયેલા, સ્થાન બદલાયેલા કે દૂર કરાયેલા દરેક લેખની યાદી આપે છે.
/api/v1 પર corpus_version, corpus_updated અને release_notes મળે છે. તે પ્રકાશિત General લેખસંગ્રહની રિલીઝ અને તેની રિલીઝ તારીખ ઓળખાવે છે, દરેક લેખ છેલ્લે ક્યારે સંપાદિત થયો તે તારીખ નહીં. આ જ મેટાડેટા MCP સર્વરની સૂચનાઓમાં પણ જોવા મળે છે. લેખસંગ્રહની રિલીઝથી API કે MCP સૉફ્ટવેરની આવૃત્તિ બદલાતી નથી. ત્યાંનું id_policy જણાવે છે કે id વિશે કઈ ખાતરી મળે છે: કોઈ રિલીઝ idને નવા નંબર આપી શકે છે કે મર્જ કરી શકે છે, જેમ 1.5એ કર્યું હતું, અને જૂના id, 308 તથા POST /api/v1/ids/translate મારફતે, જવાબ આપતા રહે છે.
કંઈક બરાબર કામ કરતું નથી? જાણ કરો.
સંદર્ભ
વ્યૂત્પન્ન ડેટા (મહત્ત્વ, વાંચનકક્ષાઓ, લિંક્સ, તારીખો, અન્ય નામો અને સંપૂર્ણ-લખાણ અનુક્રમણિકા)માંથી વાંચતા રૂટ અને ફીલ્ડ, તે ડેટા સ્ટોર સાથે પ્રકાશિત ન થાય ત્યાં સુધી, Retry-After સાથે 503 આપે છે અથવા તે ફીલ્ડ છોડી દે છે.
લેખ વાંચવો
/api/v1/articles/{slug} અને MCP fetch આ વિકલ્પો સ્વીકારે છે; તેમના વિના જવાબમાં આખો લેખ મળે છે.
| વિકલ્પ | શું આપે છે |
|---|---|
section={heading} | મથાળા કે તેના કોઈ શબ્દ પરથી એક વિભાગ, તેના પેટાવિભાગો સાથે (section=etymologyથી "Name and etymology" મળે છે; section=lead આરંભિક ભાગ છે). અજાણ્યા મથાળા માટે લેખના sections સાથે 404 મળે છે. |
outline=1 | outline: દરેક મથાળું, ટોકનમાં તેના કદ સાથે. |
max_tokens={n} | વિભાગ કે ફકરાની સીમાએ લગભગ n ટોકન સુધી ટૂંકાવેલું લખાણ, tokens_estimate, truncated અને next_cursor સાથે; બાકીનું મેળવવા એ જ max_tokens સાથે તેને cursor તરીકે આપો. |
length=snippet, length=lead | સંપૂર્ણ લખાણને બદલે ટૂંકો અંશ, અથવા શીર્ષક અને શરૂઆતનો ફકરો. |
format=text, html, jsonld, turtle, tables | જવાબ સાદા લખાણ તરીકે, રેન્ડર કરેલા બૉડી તરીકે, અથવા તેના જાહેર ફીલ્ડના JSON-LD કે Turtle તરીકે; tables દરેક કોષ્ટકને columns અને rows તરીકે, csv તરીકે, તેમજ તેના સંદર્ભોને cites અને sourcesમાં ખસેડીને આપે છે. |
chunks=1 | chunks: ફકરાઓમાં લેખ, દરેક ફકરા સાથે તેના મથાળા-પથ પરથી મળતો સ્થિર id (geology-2) અને એક cite_url. |
q={words}&k={1–10} | passages: શબ્દો સાથે શ્રેષ્ઠ મેળ ખાતા k ફકરા (ડિફૉલ્ટ 3), દરેક સાથે એક cite_url. |
quote={sentence or chunk id} | cite_url: ટેક્સ્ટ ફ્રૅગમેન્ટ સાથેનું લેખનું સરનામું, જે પેજને એ અંશ પર ખોલે છે; લેખમાં તે અંશ છે કે નહીં તે quote_found જણાવે છે. |
cite={format} | cite: લેખનો સંદર્ભ, જેમ /api/v1/cite આપે છે. |
દરેક લેખના જવાબમાં speakable પણ હોય છે (વૉઇસ આસિસ્ટન્ટ વાંચી શકે એવા સ્વરૂપમાં ટૂંકો અંશ). importance અને rank (લેખો વચ્ચેની લિંક્સ પર આધારિત PageRank; 1 સૌથી વધુ કેન્દ્રસ્થાને છે; આ લિંક્સની ગણતરી છે, વિષયનું મૂલ્યાંકન નહીં), words, reading_grade (ફ્લેશ-કિન્કેઇડ) અને reading_minutes ત્યારે જ મળે છે જ્યારે fields=માં તેમનાં નામ આપ્યાં હોય (?fields=title,importance,rank); MCP fetchમાં તે હંમેશાં હોય છે. next=1 આગળ વાંચવા માટે વધુમાં વધુ 5 લેખો ઉમેરે છે. citations=false, MCPના citations: falseની જેમ, markdown, chunks અને passagesમાં લખાણ વચ્ચેની સ્રોત-લિંક્સને બદલે [n] ચિહ્નો આપે છે. કોઈ લેખનું ન હોય એવું સરનામું લેખના id (/api/v1/articles/ep7rbwcy0a) તરીકે અથવા મોટા-નાના અક્ષરો અને ઉચ્ચારચિહ્નોનો ભેદ અવગણીને તેના શીર્ષક તરીકે (/api/v1/articles/paris) વાંચવામાં આવે છે; નાના અક્ષરો અને હાઇફનવાળું સરનામું આટલા મેળથી પણ દૂર હોય તો, ?suggest=1 ઉમેર્યું ન હોય ત્યાં સુધી 404 મળે છે. પરંતુ મોટા અક્ષરો, ખાલી જગ્યાઓ કે અન્ડરસ્કોર ધરાવતું સરનામું (/api/v1/articles/Albert_Einstein) નામ તરીકે વાંચવામાં આવે છે, એટલે થોડો ફેર હોય તો resolved_by: search સાથે શોધનો શ્રેષ્ઠ મેળ મળે છે. તમે આપેલું નામ લેખનું સરનામું ન હોય ત્યારે, જવાબમાં તેને કેવી રીતે વાંચવામાં આવ્યું તે જણાવાય છે (resolved_from, resolved_by: સરનામું, શીર્ષક કે શોધ) અને 3 nearest અન્ય લેખોની યાદી મળે છે. /api/v1/articles?ids={slug or id},{name} વધુમાં વધુ 10 લેખો articles તરીકે (દરેક સાથે તે જે નામનો જવાબ છે તે asked તરીકે) અને missing આપે છે; દરેક વિકલ્પ દરેક લેખને લાગુ પડે છે.
લેખનો સંદર્ભ આપવો
/api/v1/cite/{slug}?format= સંદર્ભ csl (CSL-JSON, ડિફૉલ્ટ), bibtex, ris, apa, mla, chicago અથવા harvardમાં આપે છે, સાથે શ્રેય-પંક્તિ સાદા લખાણ, Markdown અને HTML તરીકે આપે છે; /api/v1/cite?ids={id},{slug} વધુમાં વધુ 50 માટે આ જ કરે છે. લેખક Edgepedia (EdgeChat) છે; APA, MLA, Chicago અને Harvardમાં ત્રાંસા અક્ષરોમાં દર્શાવવાના શીર્ષકને Markdownની જેમ ફૂદડીઓથી ચિહ્નિત કરાય છે. સંદર્ભ કાર્ડમાં સંદર્ભ-વ્યવસ્થાપક સૉફ્ટવેર માટે આ જ સંદર્ભ અદૃશ્ય સ્વરૂપે COinS અને JSON-LD તરીકે હોય છે.
શોધ
match | ક્યારે | confidence |
|---|---|---|
exact | શીર્ષક જ શોધમાં આપેલું લખાણ હોય. | આવા પ્રથમ પરિણામ માટે 1.0, પછીના માટે 0.9 |
alias | અન્ય નામ, અથવા શીર્ષકના આદ્યાક્ષરો ("mlk") સાથે મેળ મળે. | 0.8; શોધનો એક પણ શબ્દ ન ધરાવતા પ્રથમ પરિણામ માટે 0.7; લિપ્યંતરિત શોધ માટે 0.6 |
misspelling | શોધે આપેલા લખાણમાં સુધારો કર્યો હોય (did_you_mean). | 0.5 × ટાઇપ કરેલા લખાણનો સુધારામાં જળવાયેલો હિસ્સો |
partial | શોધના કેટલાક શબ્દો શીર્ષકમાં, અથવા માત્ર લખાણમાં હોય. | 0.2 + 0.5 × શોધના શબ્દોનો શીર્ષકમાં રહેલો હિસ્સો; માત્ર લખાણમાં હોય તો 0.2 |
fulltext | કોઈ શીર્ષક કે અન્ય નામ સાથે મેળ ન મળતાં લેખોના લખાણમાં શોધ કરાઈ હોય (BM25): વર્ણન પરથી એવો લેખ મળે જેનું નામ તમે જાણતા ન હો. | ઓછામાં ઓછું 0.2 |
none | કોઈ મેળ ન મળ્યો હોય. જવાબ ખાલી હોય છે. | 0 |
વિશ્વાસ-આંક એક નિશ્ચિત નિયમ છે, માપાંકિત સંભાવના નહીં; જે જવાબના શ્રેષ્ઠ પરિણામનો આંક 0.2થી ઓછો હોય તે ખાલી મળે છે. દરેક પરિણામમાં highlight હોય છે, એટલે કે તેના સારાંશનું એવું વાક્ય જેમાં શોધના સૌથી વધુ શબ્દો હોય. કોઈ મેળ ન મળે તો લૅટિન અક્ષરોમાં ફરી એક વાર શોધ થાય છે (સિરિલિક, ગ્રીક, કાના અને હાંગુલનું લિપ્યંતર કરાય છે, પિનયિનના સ્વરાઘાત દર્શાવતા આંકડા દૂર કરાય છે અને રોમાજીમાં બેવડાયેલા સ્વરો ટૂંકાવાય છે), અને જવાબમાં તેને searched_as તરીકે દર્શાવાય છે. ચીની અક્ષરોનું લિપ્યંતર થતું નથી.
| વિકલ્પ | શું કરે છે |
|---|---|
first=true | માત્ર શ્રેષ્ઠ મેળ, અથવા કોઈ નહીં. |
topic={id}, geo={id} | માત્ર તે વિષય કે ભૂગોળ નોડ હેઠળના લેખો; geo વધુમાં વધુ 1,000 મેળમાંથી દરેકને ગાળે છે, અને scope જણાવે છે કે જવાબ ક્યાં સુધી આવરી લે છે. |
sort=central | વધુમાં વધુ 1,000 મેળમાંથી સૌથી વધુ લિંક્સ જેમની તરફ આવે છે તેવા વિષયો પહેલાં. |
max_grade={grade} | માત્ર તે કે તેનાથી નીચી વાંચનકક્ષાના લેખો. |
facets=1 | વધુમાં વધુ 1,000 મેળમાંથી ટોચના સ્તરના વિષય અને ભૂગોળના પ્રદેશ પ્રમાણે મેળની સંખ્યા (facets.counted). |
દરેક જવાબ
fields=a,b દરેક પરિણામની (અથવા પરિણામો ન હોય ત્યારે જવાબની) માત્ર આપેલી કી જ રાખે છે; બહારનું માળખું (total, page, next, license) યથાવત્ રહે છે. કૅશમાં રાખી શકાય એવા 200 જવાબમાં ETag હોય છે: તેને If-None-Match તરીકે પાછું મોકલો, અને જવાબ બદલાયો ન હોય તો બૉડી વિનાનો 304 મળે છે. Last-Modified લેખસંગ્રહની રિલીઝ તારીખ છે અને માત્ર જાણકારી માટે છે. Edgepedia-Corpus-Version લેખસંગ્રહની રિલીઝ દર્શાવે છે, અને Content-Digest બૉડીનું SHA-256 છે (RFC 9530); લેખના .mdમાં પણ આ બંને હોય છે.
વધુ રૂટ
| રૂટ | શું આપે છે |
|---|---|
/api/v1/articles?after={id}&limit={1..1000} | એક નિશ્ચિત ક્રમમાં Generalનો દરેક લેખ: {id, slug, title, api_url} અને next (અંતે null). after= ખાલી હોય તો શરૂઆતથી ચાલે છે, અને કોઈ પણ id પછીથી ફરી આગળ વધી શકાય છે, દૂર કરેલા id પછીથી પણ. |
/api/v1/trees, /api/v1/trees/topic, /api/v1/trees/geo | સંપૂર્ણ વિષય અને ભૂગોળ વૃક્ષો: nodes: [[id, label, parent index, own articles]]; ટપકાથી શરૂ થતો id તેના ઉપરી નોડના idની આગળ જોડાય છે. |
/api/v1/releases | લેખસંગ્રહની રિલીઝ, સૌથી નવી પહેલાં, અને current. |
/api/v1/health | application/health+json: pass, warn અથવા fail (503). |
/api/v1/manifest | એક gzip JSONL ફાઇલ તરફ રીડાયરેક્ટ, લેખદીઠ એક પંક્તિ: { id, slug, title, updated, sha256, topic } (લેખના .mdનું sha256). Edgepediaની પ્રતિનકલ રાખવા તેને એક વાર ડાઉનલોડ કરો. ચેકસમ વાચકોએ સૂચવેલા સુધારા પહેલાંના પ્રકાશિત લખાણનો હોય છે: રિલીઝ પછી વાચકે જણાવેલા સુધારાથી કોઈ લેખ બદલાયો હોય તો આગામી રિલીઝ સુધી તે ચેકસમ સાથે મેળ નહીં ખાય. |
/api/v1/changes?since={release} | તે રિલીઝથી વર્તમાન રિલીઝ સુધીની ફેરફાર-ફાઇલો ક્રમમાં (ફીડ 1.5થી શરૂ થાય છે: since=1.5 સૌથી જૂની છે); દરેક પંક્તિ { op, id, … } છે, જેમાં op એ added, changed, moved (from_slug જૂનું સરનામું છે) અથવા removedમાંથી એક હોય છે. |
/api/v1/events/{slug} | લેખનાં એ વાક્યો જેમાં તારીખ દર્શાવેલી હોય: { date, precision, text, para }, date એ YYYY, YYYY-MM અથવા YYYY-MM-DD તરીકે (ઈસવી સન પૂર્વેની તારીખો ઋણ હોય છે: -0044-03-15). ઈસવી સન પૂર્વેની તારીખો ઐતિહાસિક પરંપરાને અનુસરે છે, ખગોળશાસ્ત્રીય વર્ષોને નહીં: -0044 એટલે ઈ. સ. પૂર્વે 44 (પ્રમાણભૂત ISO 8601 પાર્સર તેને ઈ. સ. પૂર્વે 45 તરીકે વાંચશે). વાક્ય જ પુરાવો છે: તારીખને હકીકત માની લેતાં પહેલાં તે વાંચો. |
/api/v1/aliases/{id} | લેખનાં અન્ય નામો, જેમાં લેખોમાં જણાવેલાં સંક્ષિપ્ત નામો પણ હોય છે ("NASA"); ખોટી જોડણીઓ અને માત્ર મોટા-નાના અક્ષરોના ભેદવાળાં રૂપો છોડવામાં આવે છે, અને એક જ નામની બે જોડણીઓમાંથી ટપકાં વિનાની રખાય છે ("WHO", "W.H.O." નહીં). |
નામનો ઉકેલ, એનોટેશન અને રેકન્સિલિએશન
મુક્ત લખાણ આપો, લેખોના id મેળવો, કોઈ મૉડલ કે એમ્બેડિંગ વિના. એનોટેશન, વર્ગીકરણ અને ભૌગોલિક ઓળખ માટે મોકલેલું લખાણ કદી લૉગમાં નોંધાતું કે સાચવવામાં આવતું નથી.
| રૂટ | શું આપે છે |
|---|---|
/api/v1/resolve?name=Mercury&context=planet | કોઈ નામ સૌથી સંભવિત રીતે જે લેખને દર્શાવે તે: result, confidence, ambiguous, match (exact, alias, anchor, partial અથવા none) અને alternatives. type= સંભવિત લેખોમાંથી એક વિષય id હેઠળના જ રાખે છે (નામના પહેલા 30 મેળમાંથી કોઈ ત્યાં ન હોય તો, એક જ નામ માટે તેના પછીના 60 મેળ પણ તપાસાય છે); limit= 1થી 10. POST વધુમાં વધુ 50 સ્વીકારે છે: { "names": ["Paris", "Koala"] } અથવા { "queries": [{ "name": "Mercury", "context": "planet" }] }. માત્ર નામ પરથી એક લેખ નક્કી ન થઈ શકે તો ambiguous: true જવાબ મળે છે અને શ્રેષ્ઠ અનુમાન result તરીકે મળે છે; પસંદગી કરવા context આપો. |
/api/v1/surface?form=mercury | લેખસંગ્રહની પોતાની લિંક્સમાં આ જ શબ્દસમૂહ જે જે લેખને દર્શાવતો હોય તે દરેક લેખ, લિંક્સની સંખ્યા અને દરેકના હિસ્સા સાથે (commonness). |
/api/v1/suggest?prefix=koa | પહેલાં બરાબર એ જ શીર્ષક ધરાવતો લેખ, પછી બરાબર એ જ અન્ય નામ ધરાવતો લેખ, પછી આપેલા શરૂઆતના અક્ષરોથી શરૂ થતાં શીર્ષકો, પછી એ રીતે શરૂ થતાં અન્ય નામો (matched તે નામ આપે છે), શોધ-બૉક્સ અને વૉઇસ ઇન્ટરફેસ માટે. |
POST /api/v1/annotate | { "text": "…" } (વધુમાં વધુ 20,000 અક્ષરો): દરેક લિંક કરેલો શબ્દસમૂહ, તેના સ્થાન-આંક (start, end, UTF-16 કોડ એકમોમાં, જેમ JavaScript સ્ટ્રિંગમાં સ્થાન ગણે છે: Pythonમાં Basic Multilingual Planeની બહારનો અક્ષર, જેમ કે ઇમોજી, બે તરીકે ગણાય છે), લેખ અને વિશ્વાસ-આંક સાથે. ?format=html લખાણને HTML-એસ્કેપ કરીને, દરેક શબ્દસમૂહને લિંક સાથે પણ આપે છે. |
POST /api/v1/classify | { "text": "…" }: લખાણમાં ઉલ્લેખાયેલા લેખોના વિષય-પથ પરથી આંક આપીને લખાણના વિષયો, અને ટોચના સ્તરના વિષયોના હિસ્સા. |
POST /api/v1/geoparse | { "text": "…" }: તેમાં નામ લેવાયેલાં સ્થળો અને સમયગાળાઓ, ભૂગોળ વૃક્ષ પર (nodes, regions, places, periods); વૃક્ષની બિનભૌગોલિક શાખા (geo.nongeo) કદી સ્થળ ગણાતી નથી. |
/api/v1/mentions?term=CRISPR | કોઈ વિષયના લેખને લિંક આપ્યા વિના તેનો ઉલ્લેખ કરતા લેખો; complete: falseનો અર્થ છે કે લિંક આપતા લેખોની યાદી ટૂંકાવાઈ છે. |
/api/v1/reconcile | Reconciliation Service API 0.2 એન્ડપૉઇન્ટ: મૅનિફેસ્ટ, બૅચ queries (GET કે POST), એન્ટિટી, પ્રકાર અને ગુણધર્મ માટે સૂચનો, પૂર્વાવલોકન અને ડેટા વિસ્તરણ (title, url, excerpt, topic, topic_path, importance_rank). callback= સાથે JSONP. OpenRefineમાં: Reconcile › Start reconciling › Add standard service પસંદ કરો, અને https://www.edgepedia.org/api/v1/reconcile પેસ્ટ કરો. |
લિંક ગ્રાફ, તારીખો અને યાદીઓ
આકૃતિઓ (format=mermaid) Mermaid લખાણમાં હોય છે, તેને રેન્ડર કરી શકે એવા હોસ્ટ માટે.
| રૂટ | શું આપે છે |
|---|---|
/api/v1/links/{slug} | લેખમાંથી અન્ય લેખો તરફની લિંક્સ, વાંચનક્રમમાં, દરેક સાથે તેનું લિંક-લખાણ અને વાક્ય. |
/api/v1/backlinks/{slug}?page= | તેને લિંક આપતા લેખો, પેજદીઠ 30, સૌથી મહત્ત્વના પહેલાં, તેમના લિંક-લખાણ સાથે. |
/api/v1/path?from=&to= | બે લેખો વચ્ચેની લિંક્સની સૌથી ટૂંકી શૃંખલા (વધુમાં વધુ 6 પગલાં, શક્ય હોય ત્યાં ઘણી લિંક્સ ધરાવતા કેન્દ્રોને ટાળીને), દરેક પગલું જોડતા વાક્ય સાથે. MCP સર્વર તેને connect કહે છે. |
/api/v1/compare?a=&b= | બે લેખો બાજુબાજુ: આરંભિક ભાગો, વિષય-પથ, તેમનો સૌથી ચોક્કસ સહિયારો વિષય, તેમની વચ્ચેની શૃંખલા, સહિયારી અને પોતપોતાની લિંક્સ, અને દરેકનું મુખ્ય તથ્યોનું કોષ્ટક. |
/api/v1/graph/{slug}?depth=1|2&limit= | તેના સૌથી મહત્ત્વના પાડોશી લેખોમાંથી વધુમાં વધુ limit (ડિફૉલ્ટ 50, વધુમાં વધુ 200), અને તેમની વચ્ચેની દરેક લિંક. complete: falseનો અર્થ (અહીં, પાછલી લિંક્સ પર અને rank/top પર) એ છે કે રૂટની આશરે એક સેકન્ડની સમયમર્યાદાને કારણે જવાબ ટૂંકાવાયો છે; આવો જવાબ માત્ર એક મિનિટ માટે કૅશમાં રખાય છે. |
POST /api/v1/context | { "ids": [...] }, વધુમાં વધુ 50 id કે સરનામાં (/rank?ids= અને /leads?ids= પણ તે સ્વીકારે છે): તેમની વચ્ચેની લિંક્સ, તેમાંના મોટા ભાગના લેખો સાથે લિંકથી જોડાયેલા લેખો, તેમનો સૌથી ચોક્કસ સહિયારો વિષય અને સ્થળ, અને દરેકનો આરંભિક ભાગ. |
/api/v1/rank?ids=, /api/v1/rank/top?topic=&limit= | PageRank પ્રમાણે મહત્ત્વ: સમગ્ર લેખસંગ્રહમાં prનો સરવાળો 1 થાય છે, ક્રમાંક 1 સૌથી વધુ કેન્દ્રસ્થાને છે. નામો ધ્યાનમાં રાખો: /search અને લેખો પરનું importance આ ક્રમાંકને 0થી 1 વચ્ચેના પર્સન્ટાઇલ તરીકે દર્શાવે છે; /resolveનું importance મૂળ pr છે, અને /leadsનું { pr, rank } છે. |
/api/v1/timeline?topic=|geo=&from=&to= | કોઈ વિષય કે સ્થળના લેખોમાંથી તારીખ ધરાવતાં વાક્યો, સૌથી જૂનાં પહેલાં, પેજદીઠ 50; ઈસવી સન પૂર્વેનાં વર્ષો ઋણ હોય છે. નોડ તેની તારીખોમાં ફેલાયેલી વધુમાં વધુ 200 ઘટનાઓ રાખે છે, અને from તથા to એ નમૂનાને ગાળે છે; મહત્તમ મર્યાદા સુધી ભરાયેલા નમૂનામાંથી લેવાયેલો જવાબ sampled: true અને તેનું cap જણાવે છે, અને તેનું total નમૂનાની ગણતરી આપે છે. |
/api/v1/onthisday?date=MM-DD, /api/v1/year/{year} | વર્ષના કોઈ દિવસે (ડિફૉલ્ટ તરીકે UTC પ્રમાણે આજનો દિવસ), અથવા કોઈ એક વર્ષમાં (-9999થી 2100) બનેલી ઘટનાઓ. એક દિવસમાં વધુમાં વધુ 500 ઘટનાઓ અને એક વર્ષમાં 2,000 હોય છે; મહત્તમ મર્યાદા સુધી ભરાયેલું હોય તો sampled: true જણાવાય છે. |
/api/v1/featured?date=, /api/v1/featured.xml | દિવસનો વિશેષ લેખ (મુખ્ય પેજ પરનું આજનું તથ્ય), અને છેલ્લા દસ દિવસની Atom ફીડ. |
/api/v1/list?topic=|geo=&period=&type=person | કોઈ વિષયના, અથવા કોઈ સ્થળ અને સમયગાળાના (TBC, T500, T1000, T1800, T1946, T2001, T2021, NODATE) લેખો, પેજદીઠ 30; type=person માત્ર વ્યક્તિઓને રાખે છે. ભૂગોળની યાદીની પંક્તિઓમાં geo હોય છે અને id હોતું નથી (તે માટે લેખ મેળવો). |
/api/v1/keyterms?topic=|geo=&limit= | વાણી ઓળખતી પ્રણાલીને અગાઉથી તૈયાર કરવા માટે, કોઈ ઉપવૃક્ષનાં શીર્ષકો અને અન્ય નામો. |
/api/v1/stats?topic=|geo=&by=period | માત્ર સંખ્યા: લેખસંગ્રહ માટે અથવા કોઈ નોડ અને તેના પેટાનોડ માટે લેખો, લિંક્સ અને અન્ય નામોની. અહીં articles જુદા લેખો ગણે છે; /geo અને /trees/geo પર તે સ્થાનોની ગણતરી કરે છે, એટલે કોઈ પ્રદેશના બે સમયગાળામાં રહેલો લેખ ત્યાં બે વાર ગણાય છે. |
શોધખોળ અને અન્ય પ્રોટોકોલ
- MCP સર્વર કાર્ડ: /.well-known/mcp/server-card.json (
/mcp/server-cardપણ): કનેક્ટ થયા વિના નામ, એન્ડપૉઇન્ટ, ટૂલ અને આવૃત્તિઓ. રજિસ્ટ્રી ગોઠવણી:/.well-known/mcp/config-schema.jsonઅને/.well-known/mcp/examples.json. - AI કૅટલૉગ: /.well-known/ai-catalog.json: ઉપયોગ કરવાના બધા માર્ગો (MCP, આ API, A2A, NLWeb અને Agent Skill), શોધનાં ઉદાહરણો સાથે.
- API કૅટલૉગ: /.well-known/api-catalog, આ API, તેનું વર્ણન અને આ દસ્તાવેજો દર્શાવતો RFC 9727 લિંકસેટ.
- Agent Skill: /.well-known/agent-skills/index.json પર
SKILL.mdતેના sha256 ડાઇજેસ્ટ સાથે સૂચવેલું છે. - OpenSearch: /opensearch.xml Edgepediaને શોધ પ્રદાતા તરીકે ઉમેરે છે.
- A2A:
https://www.edgepedia.org/a2a(JSON-RPC; A2A 1.0SendMessageઅને 0.3message/send; કાર્ડ/.well-known/agent-card.jsonપર). વિષયનું નામ આપતાં ટોચના પાંચ લેખો મળે છે; લેખનું સરનામું આપતાં લેખ તેની શ્રેય-પંક્તિ સાથે Markdown તરીકે મળે છે. જવાબ હંમેશાં સંદેશ હોય છે, કદી કાર્ય નહીં, અને આ જ પદ્ધતિઓના જવાબ/mcpપર પણ મળે છે. - NLWeb:
https://www.edgepedia.org/ask?query=Mount%20Fuji(GET, અથવા JSON કે ફૉર્મ બૉડી સાથે POST) NLWebના યાદી-સ્વરૂપમાં જવાબ આપે છે, દરેક પરિણામ માટે એક schema.orgschema_objectસાથે;streaming=trueયાદીને સર્વરથી મોકલાતી ઇવેન્ટ્સ તરીકે મોકલે છે. કોઈ મૉડલને કૉલ કરવામાં આવતો નથી. - લેખનાં મશીન-વાંચનીય સ્વરૂપો: લેખનું સરનામું
Acceptહેડરમાં જણાવેલું સ્વરૂપ આપે છે:text/markdown(x-markdown-tokensના અંદાજ સાથે),application/json(આ APIનો જવાબ), અથવાapplication/ld+json; બીજું કંઈ પણ હોય તો પેજ મળે છે. લેખનાં પેજમાંLinkહેડર હોય છે, જે આ સ્વરૂપો, લાઇસન્સ, API કૅટલૉગ અને OpenAPI વર્ણન દર્શાવે છે.
જનરેટ કરેલી ફાઇલો
/openapi.json પરથી બનેલી છે, એટલે તેનાથી કદી જુદી પડતી નથી.
| ફાઇલ | શું છે |
|---|---|
| /openapi-3.0.json | 3.1 વાંચી ન શકતાં ટૂલ માટે એ જ વર્ણન OpenAPI 3.0.3માં. |
| /arazzo.json | Arazzo 1.0 કાર્યપ્રવાહ: શોધો, શ્રેષ્ઠ મેળ મેળવો, પછી તેના સંબંધિત લેખો મેળવો. |
| /tools.json | દરેક JSON રૂટ મૉડલ કૉલ કરી શકે એવા ફંક્શન તરીકે, OpenAI, Anthropic અને Geminiનાં સ્વરૂપોમાં, અને તેના રૂટ સાથે JSON Schema તરીકે. |
| /edgepedia.d.ts | દરેક જવાબ અને દરેક રૂટના પૅરામીટર માટે TypeScript પ્રકારો. |
| /edgepedia.postman_collection.json, /edgepedia.bruno.json, /edgepedia.insomnia.json, /edgepedia.http | Postman, Bruno, Insomnia અને VS Code કે JetBrains માટે રૂટદીઠ એક ઉદાહરણ રિક્વેસ્ટ. |
કૃપા કરીને સંગ્રહોની જેમ તમારા પ્રોગ્રામનું નામ દર્શાવતું User-Agent મોકલો (edgepedia-collection/1).