Version at: 16/06/2021, 00:43 vs. version at: 16/06/2021, 00:46
11# API
22
33Briefly, ...
44
55## For one sentence
66
77https://tatoeba.org/eng/api_v0/sentence/1
88
99## Search results
1010
1111### Search: Canadian (not an exact match, so gets "Canadians", too.)
1212from: eng
1313to: jpn
1414list: 907
1515direct translations only
1616
1717https://tatoeba.org/eng/api_v0/search?from=eng&list=907&query=Canadian&trans_filter=limit&trans_link=direct&trans_to=jpn&to=jpn
1818
1919### Search: Boston
2020from: eng
2121to: jpn
2222audio: yes
2323sort: created
2424(direct and indirect translations)
2525
2626https://dev.tatoeba.org/eng/api_v0/search?from=eng&trans_filter=limit&query=Boston&sort=created&has_audio=yes&trans_to=jpn&to=jpn
2727
2828### Search: =play (exact match)
2929from: eng
3030to: jpn
3131list: 907
3232sort: words
3333direct translations only
3434
3535https://dev.tatoeba.org/eng/api_v0/search?from=eng&list=907&query=%3Dplay&sort=created&trans_filter=limit&trans_link=direct&trans_to=jpn&to=jpn
36
37
38### Other
39
40Do an advanced search, copy the resulting URL and change the first part of the URL to match the first part of the API URL.
41
42https://tatoeba.org/en/sentences/advanced_search
3643
3744## Paging
3845
3946You can find out how many pages there thanks to the count and the perPage in the paging information.
4047
4148https://dev.tatoeba.org/eng/api_v0/search?from=eng&list=907&query=Canadian&trans_filter=limit&trans_link=direct&trans_to=jpn&to=jpn&page=2
4249
4350 "paging": {
4451 "Sentences": {
4552 "finder": "all",
4653 "page": 2,
4754 "current": 8,
4855 "count": 18,
4956 "perPage": 10,
5057 "start": 11,
5158 "end": 18,
5259 "prevPage": true,
5360 "nextPage": false,
5461 "pageCount": 2,
5562 "sort": null,
5663 "direction": null,
5764 "limit": null,
5865 "sortDefault": false,
5966 "directionDefault": false,
6067 "scope": null,
6168 "completeSort": []
6269 }
6370 },
6471
6572
6673
6774The properties you'll be interested in are:
6875
6976page - this is the current page.
7077current - this is the number of items displayed in the current page.
7178count - this is the total number of results.
7279perPage - this is the number of results per page.
7380To know how many pages there are in total, you divide count by perPage and round up to the upper integer.
7481
7582
7683
7784
7885## For information on the API, ...
7986
8087See https://github.com/Tatoeba/tatoeba2/issues/2669
8188
8289
8390
diff view generated by jsdifflib

Version at: 16/06/2021, 00:43

# API

Briefly, ...

## For one sentence

https://tatoeba.org/eng/api_v0/sentence/1

## Search results

### Search: Canadian (not an exact match, so gets "Canadians", too.)
from: eng
to: jpn
list: 907
direct translations only

https://tatoeba.org/eng/api_v0/search?from=eng&list=907&query=Canadian&trans_filter=limit&trans_link=direct&trans_to=jpn&to=jpn

### Search: Boston
from: eng
to: jpn
audio: yes
sort: created
(direct and indirect translations)

https://dev.tatoeba.org/eng/api_v0/search?from=eng&trans_filter=limit&query=Boston&sort=created&has_audio=yes&trans_to=jpn&to=jpn

### Search: =play (exact match)
from: eng
to: jpn
list: 907
sort: words
direct translations only

https://dev.tatoeba.org/eng/api_v0/search?from=eng&list=907&query=%3Dplay&sort=created&trans_filter=limit&trans_link=direct&trans_to=jpn&to=jpn

## Paging

You can find out how many pages there thanks to the count and the perPage in the paging information.

https://dev.tatoeba.org/eng/api_v0/search?from=eng&list=907&query=Canadian&trans_filter=limit&trans_link=direct&trans_to=jpn&to=jpn&page=2

  "paging": {
    "Sentences": {
      "finder": "all",
      "page": 2,
      "current": 8,
      "count": 18,
      "perPage": 10,
      "start": 11,
      "end": 18,
      "prevPage": true,
      "nextPage": false,
      "pageCount": 2,
      "sort": null,
      "direction": null,
      "limit": null,
      "sortDefault": false,
      "directionDefault": false,
      "scope": null,
      "completeSort": []
    }
  },



The properties you'll be interested in are:

page - this is the current page.
current - this is the number of items displayed in the current page.
count - this is the total number of results.
perPage - this is the number of results per page.
To know how many pages there are in total, you divide count by perPage and round up to the upper integer.




## For information on the API, ...

See https://github.com/Tatoeba/tatoeba2/issues/2669


version at: 16/06/2021, 00:46

# API

Briefly, ...

## For one sentence

https://tatoeba.org/eng/api_v0/sentence/1

## Search results

### Search: Canadian (not an exact match, so gets "Canadians", too.)
from: eng
to: jpn
list: 907
direct translations only

https://tatoeba.org/eng/api_v0/search?from=eng&list=907&query=Canadian&trans_filter=limit&trans_link=direct&trans_to=jpn&to=jpn

### Search: Boston
from: eng
to: jpn
audio: yes
sort: created
(direct and indirect translations)

https://dev.tatoeba.org/eng/api_v0/search?from=eng&trans_filter=limit&query=Boston&sort=created&has_audio=yes&trans_to=jpn&to=jpn

### Search: =play (exact match)
from: eng
to: jpn
list: 907
sort: words
direct translations only

https://dev.tatoeba.org/eng/api_v0/search?from=eng&list=907&query=%3Dplay&sort=created&trans_filter=limit&trans_link=direct&trans_to=jpn&to=jpn


### Other

Do an advanced search, copy the resulting URL and change the first part of the URL to match the first part of the API URL.

https://tatoeba.org/en/sentences/advanced_search

## Paging

You can find out how many pages there thanks to the count and the perPage in the paging information.

https://dev.tatoeba.org/eng/api_v0/search?from=eng&list=907&query=Canadian&trans_filter=limit&trans_link=direct&trans_to=jpn&to=jpn&page=2

  "paging": {
    "Sentences": {
      "finder": "all",
      "page": 2,
      "current": 8,
      "count": 18,
      "perPage": 10,
      "start": 11,
      "end": 18,
      "prevPage": true,
      "nextPage": false,
      "pageCount": 2,
      "sort": null,
      "direction": null,
      "limit": null,
      "sortDefault": false,
      "directionDefault": false,
      "scope": null,
      "completeSort": []
    }
  },



The properties you'll be interested in are:

page - this is the current page.
current - this is the number of items displayed in the current page.
count - this is the total number of results.
perPage - this is the number of results per page.
To know how many pages there are in total, you divide count by perPage and round up to the upper integer.




## For information on the API, ...

See https://github.com/Tatoeba/tatoeba2/issues/2669


Note

The lines in green are the lines that have been added in the new version. The lines in red are those that have been removed.