Frequently Asked Question
105 documents in this type.
- Are there rate limits on the SKYDB API?Read requests are counted per minute, hour and day; Insights and API plans are exempt, and writes are never throttled.
- Can I delete my submitted files whenever I want?
- Can I download and use project photos when I subscribe?
- Can I download contact information on projects?SKYDB Insights Plus includes downloadable contact data for the companies behind each project: email, phone, website, and mailing address, by role.
- Can I import data records into other programs?
- Can I nominate or promote my own building?Yes, every member may nominate their own building and invite others to take part in the SKYDB Awards.
- Can I share my access information with others?
- Can I test SKYDB Insights?Evaluation access to SKYDB Insights is available to selected customers: real projects and real coverage, with commercial data masked, instead of a …
- Can I write data through the SKYDB API?Yes: a token carries the rights of its account, so an account that may edit on the website may edit through the API.
- Can a building missing from SKYDB be considered?A missing building needs a SKYDB record before it can be nominated for an award.
- Do I need permission in order to use or download the standards?
- Do you offer plans which are bound to IP addresses instead of usernames/passwords?
- Does the tallest building of the year win?Height does not determine the result. Eligible members vote for the nominated buildings.
- Getting started as a member
- How are construction status and award year used?The candidate list includes completed and topped-out buildings recorded for the relevant award year.
- How are credits charged for API requests?SKYDB bills data delivery in credits: one credit covers one row of data, and plan allowances and purchased packs share one balance.
- How are floors counted in a building?
- How are the SKYDB Awards decided?Members nominate buildings, eligible contributors vote, and the results are published for each award year.
- How can I cancel my membership?
- How can I communicate with other members?
- How can I delete a building?
- How can I identify business opportunities for my company?
- How can I manage other seats for our company?
- How can I remove false or outdated information?
- How can I set my files to public domain?
- How can I submit an update for a project?
- How can I suggest a definition?
- How can I upload photos?
- How can we upgrade to more seats?
- How current is the data the API returns?The API reads the same index as the website, so a saved edit appears in API responses as soon as it appears on the page.
- How do I authenticate an API request?Send your token in the Authorization header as a Bearer token with every request to https://www.skydb.net/api/v1/.
- How do I create a collection?
- How do I create an API token?Sign in, open My Settings, API, name the token, choose when it expires, and copy it right away because it is shown only once.
- How do I get a written purchase confirmation?
- How do I get help with the SKYDB API?Start with the API reference, then write to [email protected] with the request_id of the failing call.
- How do I link a building to a company?
- How do I page through large result sets?List endpoints take from and pagesize; meta.pagination returns the total and whether more rows follow.
- How do I set access rights for an API token?A token works with the rights of your account, and My Settings, Access is where those rights are listed and set.
- How do membership and editorial roles affect participation?Membership allows nominations. Voting requires 100 buildings added, regardless of role or paid membership.
- How do you ensure the freshness of information?
- How is the Building of the Week determined?
- How is the SKYDB API versioned?The major version is part of the path, /api/v1/; breaking changes ship as a new major version, and new fields can appear within v1.
- How is the integrity of the vote protected?Voting requires a contribution history, and each eligible account has a fixed number of votes.
- How long is a high-rise building typically constructed?
- How many rows can I export?
- How object mapping works
- How often do you update information?SKYDB updates continuously, from editors, data imports, and quality-checked agents. Freshness and coverage vary by region and building type, and ev…
- How related objects work
- How to add a building
- Is there an entry fee, and what do recipients receive?There is no entry fee. The results are published in the award archive and on the building records.
- May I store or republish data from the SKYDB API?Standard access permits reading records for your own use; storing, republishing or reselling them needs a separate license.
- Mistakes to avoid
- My submission is not displayed. What can I do?
- Retrieving a lost password
- What are reaction masks?
- What are the SKYDB Awards?The SKYDB Awards are an annual selection of new tall buildings, with results dating to 1999.
- What are the software requirements for access?
- What can I do with the SKYDB API?Look up a building, search by city or height, read companies and regions, and keep your own system current with SKYDB.
- What determines the sequence of images?
- What do I do if an API token leaks?Revoke the token under My Settings, API, create a new one, and check the usage page for requests you did not send.
- What do object ratings mean?
- What do the API error codes mean?An error response has ok set to false and an error object with a stable code for software and a message for people.
- What do the SKYDB Awards recognize?The awards recognize individual buildings for their architecture, as judged by eligible SKYDB members.
- What does SDC mean, and what is it?
- What does SDC mean?
- What does SKYDB API access cost?API access is a paid service billed in credits; Insights Standard and Plus include it together with a yearly credit allowance.
- What does a lead architect do?
- What does internal use mean?
- What format do API responses have?Every response is a JSON object with the fields ok, data and meta; timestamps follow RFC 3339 in UTC, and heights are in meters.
- What happens when my credits run out?A delivery that needs more credits than you hold is refused as a whole, and your balance stays untouched.
- What is Agent Access?Agent Access connects an AI assistant or software agent to SKYDB, so it can query the database in near real time while it works.
- What is SKYDB Insights?SKYDB Insights is a paid online research service for professionals who need information about tall-building projects and the companies behind them.
- What is a code?
- What is a compound?
- What is a scope?
- What is a standard?
- What is open in SKYDB Definitions?
- What is the SKYDB API?
- What is the SKYDB API?The SKYDB API delivers building and company records as JSON, so your own software can read what the website shows.
- What is the SKYDB map and what is it for?The map lets signed-in users explore buildings and regions, with features and data visibility based on access level or subscription.
- What is the focus of your standardization work?
- What is the skyscraper day?
- What kind of contact information is available for the projects I am researching?
- What kind of objects does SKYDB support?
- What kind of projects are displayed?
- What makes SKYDB Insights special?
- What makes the Burj Khalifa skyscraper so special?
- What's the story of One World Trade Center in New York City?
- When will my paid account expire?
- Where can I change my profile information or settings?
- Where can I find the terms of service?
- Where can I see my credit balance and API usage?My Settings, Credits shows the balance and its history; My Settings, Usage shows requests by token, endpoint and period.
- Where is the SKYDB API documentation?The interactive reference is at /api/docs, and the OpenAPI document behind it is public for generating a client in any language.
- Which buildings are eligible to participate in the award?Eligible buildings are at least 100 meters tall and were completed during the relevant award year.
- Which payment options do you offer?
- Who can nominate a building?Eligible SKYDB members may nominate one eligible building per award year during the nomination period.
- Who can use the SKYDB API?Anyone with a SKYDB account can create a token; API access itself is a paid service, included in Insights Standard and Plus.
- Who can vote in the SKYDB Awards?Voting is open to members who have added at least 100 buildings to SKYDB.
- Why are skyscrapers important?
- Why can I register an account?
- Why do data sources matter?A source shows where a field value came from. It lets editors check a claim, compare conflicting evidence, and correct errors.
- Why do we need SKYDB Definitions?
- Why does SKYDB give an architectural award?The awards give SKYDB members a way to assess the architecture of the buildings they document.
- Will I be informed when relevant projects are added?
- Will SKYDB Definitions support the semantic web and RDF?