Home › Forums › The XBRL API › Paging
- This topic has 5 replies, 2 voices, and was last updated 6 years, 1 month ago by Saar Sabo.
-
AuthorPosts
-
-
Thursday, November 1, 2018 at 3:48 PM #114886Saar SaboParticipant
There is a possibility to know how much property my request has
I want to import allconcept.local-name
but there are more than 100I think the
offset
does not work well if I understand correctly what it is supposed to do -
Friday, November 2, 2018 at 11:40 AM #115006David TaurielloKeymaster
Including
ENDPOINT.offset(INTEGER)
as part of fields returns additional records not displayed by in the initial set (see 7 Handling Paging in the XBRL API Documentation for complete details).- Company and Institutional Members, as well as Sole Practitioner and Power User Individual Members can return unlimited results with 2,000 records per paged request.
- Basic Individual Members can return a maximum of 2,000 records with 500 records per page (4 pages).
- non-Members can return 1,000 records with 100 records per page (10 pages)
See https://xbrl.us/benefits for details and let me know if you have questions about XBRL US Membership.
-
Saturday, November 3, 2018 at 1:06 PM #115155Saar SaboParticipant
Funny but if you use this way
https://api.xbrl.us/api/v1/concept/search?dts.id=305444&concept.is-monetary=true&fields=concept.local-name,concept.balance-type.sort(ASC)
It does not work well withconcept.offset()
But use the way
https://api.xbrl.us/api/v1/concept/search?dts.id=305444&concept.is-monetary=true&fields=concept.local-name.sort(ASC),concept.balance-type
Works fineBut how can I know how much fields or offset There is in my request
I’m working on Add on
And I do not really know if the user has a Member or not
But I do need to know how I bring him all the information he can get
I do not want to use theconcept.limit(1)
andconcept.offset(i)
And check when I stop getting results In order to should know this is the end
It’s less Api friendlySorry for my English
-
Tuesday, November 6, 2018 at 4:49 PM #115682David TaurielloKeymaster
Thanks for your feedback on counts – I’ve noted this as a feature request. As you’ve discovered, sorting on
concept.balance-type
is likely not reliable because the return will either be debit or credit. Using the sort switch on a field that will always have unique values for each row returned ensures theENDPOINT.offset()
works as expected.Anyone using the XBRL API to return records from our Database of Public Filings will need to be authenticated (either through XBRL US or with a Google Account) – we use this to set maximums per page and for all pages returned to a user. See https://xbrl.us/benefits for details and let me know if you have questions about XBRL US Membership.
-
Tuesday, November 6, 2018 at 5:42 PM #115701Saar SaboParticipant
Ok I just let the user enter their password and username and Api codes
But I still do not understand how I can know how much fields or offset There in the request
If the user is not a member
So he can only see 100 fields
But can be for example 231 fields How can I know how many there are?
For example type of commandENDPOINT.fields.length
OrENDPOINT.offset.length
something similar
Then I can know how many requests I have to make
To import all information -
Tuesday, November 6, 2018 at 6:47 PM #115716Saar SaboParticipant
Hah
I realized there was no way right now
And that you write it down for future development
This is really important for the development of external applications
-
-
AuthorPosts
- You must be logged in to reply to this topic.
Search Forums
Recent Topics
Recent Replies
-
Spreadsheet Commands: Query Worksheet and Query Workbook Query Workbook 1 month, 3 weeks ago
-
Query for multiple dimensions 3 months, 3 weeks ago
-
Query for multiple dimensions 4 months ago
-
Showdata function 6 months, 2 weeks ago
-
Showdata function 6 months, 2 weeks ago
Documentation & Discussion
- Get started with Google Sheets OR
- Get started with Microsoft Excel OR
- Get access to as-filed data from us for other tools or your own app
- XBRL API Interactive Documentation
- Ten Tips & Techniques
- The XBRL API
- XBRL Data Community
- 2024 US GAAP Taxonomy Viewer
- Live support - Monday, 3:30 - 4:30 PM ET
Who's using this free data?
API Use 2024 || API Use 2023 || API Use 2022 || API Use 2021 || API Use 2020 || API Use 2019 || API Use 2018
Join XBRL US
- Individual Options - Basic, Power User & Sole Practitioner
- For Your Team - Startup, Non-Profit, Academic & Corporate options
- Member Benefits Comparison Table
Using the XBRL API with the Public Filings Database
Unless otherwise agreed to in writing, any and all use of the XBRL API to authenticate and retrieve data from the XBRL US Database of Public Filings implies user consent and agreement with the XBRL US API Agreement. If you are unable to agree to these terms, do not use the XBRL API.
To use the XBRL API outside of Google Sheets, your account needs to be provisioned for OAuth2 access.