{"openapi":"3.1.0","info":{"title":"ApiDatasets API","version":"1.0.0","description":"Clean API reference for ApiDatasets dataset endpoints. Web, dashboard, and admin pages are intentionally excluded."},"servers":[{"url":"https://apidatasets.com","description":"ApiDatasets production"}],"paths":{"/api/v1/geo/zip/{zip_code}":{"get":{"tags":["Dataset APIs","geo"],"summary":"Geo ZIP lookup","description":"Geo ZIP lookup. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_geo_zip","parameters":[{"name":"zip_code","in":"path","required":true,"description":"ZIP code","schema":{"type":"string","example":"30301"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Geo ZIP lookup","value":{"data":{"id":"30301","type":"geo_zip_profile","attributes":{"zip_code":"30301","city":"Atlanta","state":"GA","county":"Fulton","county_fips":"13121","latitude":33.75,"longitude":-84.39,"timezone":"America/New_York"}},"meta":{"credits_used":1,"source":"SimpleMaps US ZIP Codes Basic / ApiDatasets normalization","source_url":"https://simplemaps.com/data/us-zips","last_updated":"2026-05-08T00:00:00Z"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/geo/zip/{zip_code}":{"get":{"tags":["Demo Dataset APIs","geo"],"summary":"Geo ZIP lookup","description":"Guarded no-key demo for Geo ZIP lookup. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_geo_zip","parameters":[{"name":"zip_code","in":"path","required":true,"description":"ZIP code","schema":{"type":"string","example":"30301"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Geo ZIP lookup","value":{"data":{"id":"30301","type":"geo_zip_profile","attributes":{"zip_code":"30301","city":"Atlanta","state":"GA","county":"Fulton","county_fips":"13121","latitude":33.75,"longitude":-84.39,"timezone":"America/New_York"}},"meta":{"source":"SimpleMaps US ZIP Codes Basic / ApiDatasets normalization","source_url":"https://simplemaps.com/data/us-zips","last_updated":"2026-05-08T00:00:00Z","demo":true,"production_endpoint":"/api/v1/geo/zip/{zip_code}"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/geo/enrich":{"get":{"tags":["Dataset APIs","geo"],"summary":"Geo enrich","description":"Geo enrich. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_geo_enrich","parameters":[{"name":"zip","in":"query","required":true,"description":"ZIP code","schema":{"type":"string","example":"30301"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Geo enrich","value":{"data":{"id":"30301","type":"geo_enrichment","attributes":{"zip_code":"30301","city":"Atlanta","enrichment_level":"zip_profile"}},"meta":{"credits_used":2,"source":"SimpleMaps US ZIP Codes Basic / ApiDatasets normalization","confidence":"source_dataset"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/geo/enrich":{"get":{"tags":["Demo Dataset APIs","geo"],"summary":"Geo enrich","description":"Guarded no-key demo for Geo enrich. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_geo_enrich","parameters":[{"name":"zip","in":"query","required":true,"description":"ZIP code","schema":{"type":"string","example":"30301"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Geo enrich","value":{"data":{"id":"30301","type":"geo_enrichment","attributes":{"zip_code":"30301","city":"Atlanta","enrichment_level":"zip_profile"}},"meta":{"source":"SimpleMaps US ZIP Codes Basic / ApiDatasets normalization","confidence":"source_dataset","demo":true,"production_endpoint":"/api/v1/geo/enrich"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/geo/city":{"get":{"tags":["Dataset APIs","geo"],"summary":"Geo city search","description":"Geo city search. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_geo_city","parameters":[{"name":"name","in":"query","required":true,"description":"City","schema":{"type":"string","example":"Atlanta"}},{"name":"state","in":"query","required":true,"description":"State","schema":{"type":"string","example":"GA"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Geo city search","value":{"data":[{"id":"30301","type":"geo_zip_profile","attributes":{"zip_code":"30301","city":"Atlanta","state":"GA"}}],"pagination":{"page":1,"per_page":25,"total":1},"meta":{"credits_used":2,"source":"SimpleMaps US ZIP Codes Basic / ApiDatasets normalization"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/geo/city":{"get":{"tags":["Demo Dataset APIs","geo"],"summary":"Geo city search","description":"Guarded no-key demo for Geo city search. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_geo_city","parameters":[{"name":"name","in":"query","required":true,"description":"City","schema":{"type":"string","example":"Atlanta"}},{"name":"state","in":"query","required":true,"description":"State","schema":{"type":"string","example":"GA"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Geo city search","value":{"data":[{"id":"30301","type":"geo_zip_profile","attributes":{"zip_code":"30301","city":"Atlanta","state":"GA"}}],"pagination":{"page":1,"per_page":25,"total":1},"meta":{"source":"SimpleMaps US ZIP Codes Basic / ApiDatasets normalization","demo":true,"production_endpoint":"/api/v1/geo/city"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/geo/county/{fips}":{"get":{"tags":["Dataset APIs","geo"],"summary":"Geo county lookup","description":"Geo county lookup. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_geo_county","parameters":[{"name":"fips","in":"path","required":true,"description":"County FIPS","schema":{"type":"string","example":"13121"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Geo county lookup","value":{"data":[{"id":"30301","type":"geo_zip_profile","attributes":{"zip_code":"30301","county":"Fulton","county_fips":"13121"}}],"pagination":{"page":1,"per_page":50,"total":1},"meta":{"credits_used":2,"source":"SimpleMaps US ZIP Codes Basic / ApiDatasets normalization"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/geo/county/{fips}":{"get":{"tags":["Demo Dataset APIs","geo"],"summary":"Geo county lookup","description":"Guarded no-key demo for Geo county lookup. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_geo_county","parameters":[{"name":"fips","in":"path","required":true,"description":"County FIPS","schema":{"type":"string","example":"13121"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Geo county lookup","value":{"data":[{"id":"30301","type":"geo_zip_profile","attributes":{"zip_code":"30301","county":"Fulton","county_fips":"13121"}}],"pagination":{"page":1,"per_page":50,"total":1},"meta":{"source":"SimpleMaps US ZIP Codes Basic / ApiDatasets normalization","demo":true,"production_endpoint":"/api/v1/geo/county/{fips}"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/geo/timezone":{"get":{"tags":["Dataset APIs","geo"],"summary":"Geo timezone","description":"Geo timezone. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_geo_timezone","parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude","schema":{"type":"number","example":"33.75"}},{"name":"lon","in":"query","required":true,"description":"Longitude","schema":{"type":"number","example":"-84.39"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Geo timezone","value":{"data":{"id":"33.75,-84.39","type":"geo_timezone","attributes":{"timezone":"America/New_York","nearest_zip_code":"30301","method":"nearest ZIP centroid"}},"meta":{"credits_used":1,"source":"SimpleMaps US ZIP Codes Basic / ApiDatasets normalization"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/geo/timezone":{"get":{"tags":["Demo Dataset APIs","geo"],"summary":"Geo timezone","description":"Guarded no-key demo for Geo timezone. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_geo_timezone","parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude","schema":{"type":"number","example":"33.75"}},{"name":"lon","in":"query","required":true,"description":"Longitude","schema":{"type":"number","example":"-84.39"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Geo timezone","value":{"data":{"id":"33.75,-84.39","type":"geo_timezone","attributes":{"timezone":"America/New_York","nearest_zip_code":"30301","method":"nearest ZIP centroid"}},"meta":{"source":"SimpleMaps US ZIP Codes Basic / ApiDatasets normalization","demo":true,"production_endpoint":"/api/v1/geo/timezone"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/geo/nearby":{"get":{"tags":["Dataset APIs","geo"],"summary":"Geo nearby ZIPs","description":"Geo nearby ZIPs. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_geo_nearby","parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude","schema":{"type":"number","example":"33.75"}},{"name":"lon","in":"query","required":true,"description":"Longitude","schema":{"type":"number","example":"-84.39"}},{"name":"radius_miles","in":"query","required":true,"description":"Radius miles","schema":{"type":"number","example":"10"}},{"name":"limit","in":"query","required":true,"description":"Limit","schema":{"type":"integer","example":"10"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Geo nearby ZIPs","value":{"data":[{"id":"30301","type":"geo_nearby_zip_profile","attributes":{"zip_code":"30301","city":"Atlanta","state":"GA","distance_miles":0.4}}],"pagination":{"page":1,"per_page":10,"total":1,"has_more":false},"meta":{"credits_used":2,"source":"SimpleMaps US ZIP Codes Basic / ApiDatasets normalization","method":"bounded nearest ZIP centroid query"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/geo/nearby":{"get":{"tags":["Demo Dataset APIs","geo"],"summary":"Geo nearby ZIPs","description":"Guarded no-key demo for Geo nearby ZIPs. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_geo_nearby","parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude","schema":{"type":"number","example":"33.75"}},{"name":"lon","in":"query","required":true,"description":"Longitude","schema":{"type":"number","example":"-84.39"}},{"name":"radius_miles","in":"query","required":true,"description":"Radius miles","schema":{"type":"number","example":"10"}},{"name":"limit","in":"query","required":true,"description":"Limit","schema":{"type":"integer","example":"10"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Geo nearby ZIPs","value":{"data":[{"id":"30301","type":"geo_nearby_zip_profile","attributes":{"zip_code":"30301","city":"Atlanta","state":"GA","distance_miles":0.4}}],"pagination":{"page":1,"per_page":10,"total":1,"has_more":false},"meta":{"source":"SimpleMaps US ZIP Codes Basic / ApiDatasets normalization","method":"bounded nearest ZIP centroid query","demo":true,"production_endpoint":"/api/v1/geo/nearby"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/tax/federal/brackets":{"get":{"tags":["Dataset APIs","tax"],"summary":"Tax federal brackets","description":"Tax federal brackets. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_tax_brackets","parameters":[{"name":"year","in":"query","required":true,"description":"Year","schema":{"type":"integer","example":"2026"}},{"name":"filing_status","in":"query","required":true,"description":"Filing status","schema":{"type":"string","example":"single"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Tax federal brackets","value":{"data":[{"id":"1","type":"tax_federal_bracket","attributes":{"year":2026,"filing_status":"single","bracket_min":0,"bracket_max":11925,"rate":0.1}}],"pagination":{"page":1,"per_page":7,"total":7},"meta":{"credits_used":2,"source":"IRS reference data","disclaimer":"Tax data is provided as reference data only and does not constitute tax, legal, accounting, or financial advice."}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/tax/federal/brackets":{"get":{"tags":["Demo Dataset APIs","tax"],"summary":"Tax federal brackets","description":"Guarded no-key demo for Tax federal brackets. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_tax_brackets","parameters":[{"name":"year","in":"query","required":true,"description":"Year","schema":{"type":"integer","example":"2026"}},{"name":"filing_status","in":"query","required":true,"description":"Filing status","schema":{"type":"string","example":"single"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Tax federal brackets","value":{"data":[{"id":"1","type":"tax_federal_bracket","attributes":{"year":2026,"filing_status":"single","bracket_min":0,"bracket_max":11925,"rate":0.1}}],"pagination":{"page":1,"per_page":7,"total":7},"meta":{"source":"IRS reference data","disclaimer":"Tax data is provided as reference data only and does not constitute tax, legal, accounting, or financial advice.","demo":true,"production_endpoint":"/api/v1/tax/federal/brackets"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/tax/standard-deduction":{"get":{"tags":["Dataset APIs","tax"],"summary":"Tax standard deduction","description":"Tax standard deduction. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_tax_standard_deduction","parameters":[{"name":"year","in":"query","required":true,"description":"Year","schema":{"type":"integer","example":"2026"}},{"name":"filing_status","in":"query","required":true,"description":"Filing status","schema":{"type":"string","example":"married_filing_jointly"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Tax standard deduction","value":{"data":[{"id":"1","type":"tax_reference_value","attributes":{"year":2026,"jurisdiction":"federal","value_type":"standard_deduction_single","value":16100,"unit":"USD"}}],"meta":{"credits_used":1,"source":"IRS reference data","disclaimer":"Tax data is provided as reference data only and does not constitute tax, legal, accounting, or financial advice."}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/tax/standard-deduction":{"get":{"tags":["Demo Dataset APIs","tax"],"summary":"Tax standard deduction","description":"Guarded no-key demo for Tax standard deduction. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_tax_standard_deduction","parameters":[{"name":"year","in":"query","required":true,"description":"Year","schema":{"type":"integer","example":"2026"}},{"name":"filing_status","in":"query","required":true,"description":"Filing status","schema":{"type":"string","example":"married_filing_jointly"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Tax standard deduction","value":{"data":[{"id":"1","type":"tax_reference_value","attributes":{"year":2026,"jurisdiction":"federal","value_type":"standard_deduction_single","value":16100,"unit":"USD"}}],"meta":{"source":"IRS reference data","disclaimer":"Tax data is provided as reference data only and does not constitute tax, legal, accounting, or financial advice.","demo":true,"production_endpoint":"/api/v1/tax/standard-deduction"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/tax/mileage-rates":{"get":{"tags":["Dataset APIs","tax"],"summary":"Tax mileage rates","description":"Tax mileage rates. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_tax_mileage_rates","parameters":[{"name":"year","in":"query","required":true,"description":"Year","schema":{"type":"integer","example":"2026"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Tax mileage rates","value":{"data":[{"id":"1","type":"tax_reference_value","attributes":{"year":2026,"value_type":"mileage_rate_business","value":70,"unit":"cents_per_mile"}}],"meta":{"credits_used":1,"source":"IRS reference data","disclaimer":"Tax data is provided as reference data only and does not constitute tax, legal, accounting, or financial advice."}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/tax/mileage-rates":{"get":{"tags":["Demo Dataset APIs","tax"],"summary":"Tax mileage rates","description":"Guarded no-key demo for Tax mileage rates. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_tax_mileage_rates","parameters":[{"name":"year","in":"query","required":true,"description":"Year","schema":{"type":"integer","example":"2026"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Tax mileage rates","value":{"data":[{"id":"1","type":"tax_reference_value","attributes":{"year":2026,"value_type":"mileage_rate_business","value":70,"unit":"cents_per_mile"}}],"meta":{"source":"IRS reference data","disclaimer":"Tax data is provided as reference data only and does not constitute tax, legal, accounting, or financial advice.","demo":true,"production_endpoint":"/api/v1/tax/mileage-rates"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/tax/retirement-limits":{"get":{"tags":["Dataset APIs","tax"],"summary":"Tax retirement limits","description":"Tax retirement limits. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_tax_retirement_limits","parameters":[{"name":"year","in":"query","required":true,"description":"Year","schema":{"type":"integer","example":"2026"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Tax retirement limits","value":{"data":[{"id":"1","type":"tax_reference_value","attributes":{"year":2026,"value_type":"retirement_401k_employee_limit","value":24500,"unit":"USD"}}],"meta":{"credits_used":1,"source":"IRS reference data","disclaimer":"Tax data is reference only."}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/tax/retirement-limits":{"get":{"tags":["Demo Dataset APIs","tax"],"summary":"Tax retirement limits","description":"Guarded no-key demo for Tax retirement limits. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_tax_retirement_limits","parameters":[{"name":"year","in":"query","required":true,"description":"Year","schema":{"type":"integer","example":"2026"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Tax retirement limits","value":{"data":[{"id":"1","type":"tax_reference_value","attributes":{"year":2026,"value_type":"retirement_401k_employee_limit","value":24500,"unit":"USD"}}],"meta":{"source":"IRS reference data","disclaimer":"Tax data is reference only.","demo":true,"production_endpoint":"/api/v1/tax/retirement-limits"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/tax/deadlines":{"get":{"tags":["Dataset APIs","tax"],"summary":"Tax deadlines","description":"Tax deadlines. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_tax_deadlines","parameters":[{"name":"year","in":"query","required":true,"description":"Year","schema":{"type":"integer","example":"2026"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Tax deadlines","value":{"data":[{"id":"1","type":"tax_reference_value","attributes":{"year":2026,"value_type":"filing_deadline_individual","value":"2026-04-15","unit":"date"}}],"meta":{"credits_used":1,"source":"IRS reference data","disclaimer":"Tax data is reference only."}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/tax/deadlines":{"get":{"tags":["Demo Dataset APIs","tax"],"summary":"Tax deadlines","description":"Guarded no-key demo for Tax deadlines. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_tax_deadlines","parameters":[{"name":"year","in":"query","required":true,"description":"Year","schema":{"type":"integer","example":"2026"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Tax deadlines","value":{"data":[{"id":"1","type":"tax_reference_value","attributes":{"year":2026,"value_type":"filing_deadline_individual","value":"2026-04-15","unit":"date"}}],"meta":{"source":"IRS reference data","disclaimer":"Tax data is reference only.","demo":true,"production_endpoint":"/api/v1/tax/deadlines"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/tax/summary":{"get":{"tags":["Dataset APIs","tax"],"summary":"Tax year summary","description":"Tax year summary. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_tax_summary","parameters":[{"name":"year","in":"query","required":true,"description":"Year","schema":{"type":"integer","example":"2026"}},{"name":"filing_status","in":"query","required":true,"description":"Filing status","schema":{"type":"string","example":"single"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Tax year summary","value":{"data":{"id":"2026-single","type":"tax_year_summary","attributes":{"year":2026,"filing_status":"single","standard_deduction":{"value":16100,"unit":"USD"},"federal_brackets":[{"bracket_min":0,"bracket_max":11925,"rate":0.1}]}},"meta":{"credits_used":2,"source":"IRS reference data","disclaimer":"Tax data is provided as reference data only and does not constitute tax, legal, accounting, or financial advice."}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/tax/summary":{"get":{"tags":["Demo Dataset APIs","tax"],"summary":"Tax year summary","description":"Guarded no-key demo for Tax year summary. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_tax_summary","parameters":[{"name":"year","in":"query","required":true,"description":"Year","schema":{"type":"integer","example":"2026"}},{"name":"filing_status","in":"query","required":true,"description":"Filing status","schema":{"type":"string","example":"single"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Tax year summary","value":{"data":{"id":"2026-single","type":"tax_year_summary","attributes":{"year":2026,"filing_status":"single","standard_deduction":{"value":16100,"unit":"USD"},"federal_brackets":[{"bracket_min":0,"bracket_max":11925,"rate":0.1}]}},"meta":{"source":"IRS reference data","disclaimer":"Tax data is provided as reference data only and does not constitute tax, legal, accounting, or financial advice.","demo":true,"production_endpoint":"/api/v1/tax/summary"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/tax/state/{state}/brackets":{"get":{"tags":["Dataset APIs","tax"],"summary":"Tax state brackets","description":"Tax state brackets. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_tax_state_brackets","parameters":[{"name":"state","in":"path","required":true,"description":"State","schema":{"type":"string","example":"GA"}},{"name":"year","in":"query","required":true,"description":"Year","schema":{"type":"integer","example":"2026"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Tax state brackets","value":{"data":[{"id":"1","type":"tax_state_bracket","attributes":{"year":2026,"state":"GA","filing_status":"all","bracket_min":0,"bracket_max":null,"rate":0.0519}}],"pagination":{"page":1,"per_page":1,"total":1},"meta":{"credits_used":2,"source":"State revenue reference data","source_url":"https://dor.georgia.gov/taxes/important-tax-updates","disclaimer":"Tax data is provided as reference data only and does not constitute tax, legal, accounting, or financial advice."}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/tax/state/{state}/brackets":{"get":{"tags":["Demo Dataset APIs","tax"],"summary":"Tax state brackets","description":"Guarded no-key demo for Tax state brackets. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_tax_state_brackets","parameters":[{"name":"state","in":"path","required":true,"description":"State","schema":{"type":"string","example":"GA"}},{"name":"year","in":"query","required":true,"description":"Year","schema":{"type":"integer","example":"2026"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Tax state brackets","value":{"data":[{"id":"1","type":"tax_state_bracket","attributes":{"year":2026,"state":"GA","filing_status":"all","bracket_min":0,"bracket_max":null,"rate":0.0519}}],"pagination":{"page":1,"per_page":1,"total":1},"meta":{"source":"State revenue reference data","source_url":"https://dor.georgia.gov/taxes/important-tax-updates","disclaimer":"Tax data is provided as reference data only and does not constitute tax, legal, accounting, or financial advice.","demo":true,"production_endpoint":"/api/v1/tax/state/{state}/brackets"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/flights/reliability":{"get":{"tags":["Dataset APIs","flights"],"summary":"Flight reliability","description":"Flight reliability. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_flight_reliability","parameters":[{"name":"origin","in":"query","required":true,"description":"Origin","schema":{"type":"string","example":"ATL"}},{"name":"dest","in":"query","required":true,"description":"Destination","schema":{"type":"string","example":"LGA"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Flight reliability","value":{"data":{"id":"ATL-LGA-1","type":"flight_route_reliability","attributes":{"origin_airport":"ATL","destination_airport":"LGA","reliability_score":87.5,"sample_size":1042}},"meta":{"credits_used":10,"source":"ApiDatasets normalized historical flight reliability dataset","dataset_status":"Beta aggregate; not live tracking"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/flights/reliability":{"get":{"tags":["Demo Dataset APIs","flights"],"summary":"Flight reliability","description":"Guarded no-key demo for Flight reliability. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_flight_reliability","parameters":[{"name":"origin","in":"query","required":true,"description":"Origin","schema":{"type":"string","example":"ATL"}},{"name":"dest","in":"query","required":true,"description":"Destination","schema":{"type":"string","example":"LGA"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Flight reliability","value":{"data":{"id":"ATL-LGA-1","type":"flight_route_reliability","attributes":{"origin_airport":"ATL","destination_airport":"LGA","reliability_score":87.5,"sample_size":1042}},"meta":{"source":"ApiDatasets normalized historical flight reliability dataset","dataset_status":"Beta aggregate; not live tracking","demo":true,"production_endpoint":"/api/v1/flights/reliability"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/flights/airports/{airport_code}/delay-profile":{"get":{"tags":["Dataset APIs","flights"],"summary":"Flight airport delay profile","description":"Flight airport delay profile. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_flight_airport_delay_profile","parameters":[{"name":"airport_code","in":"path","required":true,"description":"Airport","schema":{"type":"string","example":"ATL"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Flight airport delay profile","value":{"data":{"id":"ATL","type":"flight_airport_delay_profile","attributes":{"airport_code":"ATL","route_count":2,"sample_size":2130,"average_departure_delay":8.9,"average_arrival_delay":6.1,"average_cancellation_rate":0.012,"average_reliability_score":88.2,"top_routes":["ATL-LGA","ATL-MCO"]}},"meta":{"credits_used":10,"source":"ApiDatasets normalized historical flight reliability dataset","dataset_status":"Beta aggregate; not live tracking"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/flights/airports/{airport_code}/delay-profile":{"get":{"tags":["Demo Dataset APIs","flights"],"summary":"Flight airport delay profile","description":"Guarded no-key demo for Flight airport delay profile. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_flight_airport_delay_profile","parameters":[{"name":"airport_code","in":"path","required":true,"description":"Airport","schema":{"type":"string","example":"ATL"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Flight airport delay profile","value":{"data":{"id":"ATL","type":"flight_airport_delay_profile","attributes":{"airport_code":"ATL","route_count":2,"sample_size":2130,"average_departure_delay":8.9,"average_arrival_delay":6.1,"average_cancellation_rate":0.012,"average_reliability_score":88.2,"top_routes":["ATL-LGA","ATL-MCO"]}},"meta":{"source":"ApiDatasets normalized historical flight reliability dataset","dataset_status":"Beta aggregate; not live tracking","demo":true,"production_endpoint":"/api/v1/flights/airports/{airport_code}/delay-profile"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/flights/routes/{route}/best-times":{"get":{"tags":["Dataset APIs","flights"],"summary":"Flight route best times","description":"Flight route best times. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_flight_route_best_times","parameters":[{"name":"route","in":"path","required":true,"description":"Route","schema":{"type":"string","example":"ATL-LGA"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Flight route best times","value":{"data":[{"id":"ATL-LGA-06-09","type":"flight_route_time_bucket","attributes":{"origin_airport":"ATL","destination_airport":"LGA","departure_hour_bucket":"06-09","sample_size":1042,"reliability_score":90.4}}],"pagination":{"page":1,"per_page":1,"total":1},"meta":{"credits_used":10,"source":"ApiDatasets normalized historical flight reliability dataset","dataset_status":"Beta aggregate; not live tracking"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/flights/routes/{route}/best-times":{"get":{"tags":["Demo Dataset APIs","flights"],"summary":"Flight route best times","description":"Guarded no-key demo for Flight route best times. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_flight_route_best_times","parameters":[{"name":"route","in":"path","required":true,"description":"Route","schema":{"type":"string","example":"ATL-LGA"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Flight route best times","value":{"data":[{"id":"ATL-LGA-06-09","type":"flight_route_time_bucket","attributes":{"origin_airport":"ATL","destination_airport":"LGA","departure_hour_bucket":"06-09","sample_size":1042,"reliability_score":90.4}}],"pagination":{"page":1,"per_page":1,"total":1},"meta":{"source":"ApiDatasets normalized historical flight reliability dataset","dataset_status":"Beta aggregate; not live tracking","demo":true,"production_endpoint":"/api/v1/flights/routes/{route}/best-times"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/flights/airlines/{airline_code}/reliability":{"get":{"tags":["Dataset APIs","flights"],"summary":"Flight airline reliability","description":"Flight airline reliability. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_flight_airline_reliability","parameters":[{"name":"airline_code","in":"path","required":true,"description":"Airline","schema":{"type":"string","example":"DL"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Flight airline reliability","value":{"data":{"id":"DL","type":"flight_airline_reliability","attributes":{"airline":"DL","route_count":3,"sample_size":3120,"average_reliability_score":88.7,"top_routes":["ATL-LGA","ATL-MCO"]}},"meta":{"credits_used":10,"source":"ApiDatasets normalized historical flight reliability dataset","dataset_status":"Beta aggregate; not live tracking"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/flights/airlines/{airline_code}/reliability":{"get":{"tags":["Demo Dataset APIs","flights"],"summary":"Flight airline reliability","description":"Guarded no-key demo for Flight airline reliability. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_flight_airline_reliability","parameters":[{"name":"airline_code","in":"path","required":true,"description":"Airline","schema":{"type":"string","example":"DL"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Flight airline reliability","value":{"data":{"id":"DL","type":"flight_airline_reliability","attributes":{"airline":"DL","route_count":3,"sample_size":3120,"average_reliability_score":88.7,"top_routes":["ATL-LGA","ATL-MCO"]}},"meta":{"source":"ApiDatasets normalized historical flight reliability dataset","dataset_status":"Beta aggregate; not live tracking","demo":true,"production_endpoint":"/api/v1/flights/airlines/{airline_code}/reliability"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/flights/cancellation-risk":{"get":{"tags":["Dataset APIs","flights"],"summary":"Flight cancellation risk","description":"Flight cancellation risk. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_flight_cancellation_risk","parameters":[{"name":"origin","in":"query","required":true,"description":"Origin","schema":{"type":"string","example":"ATL"}},{"name":"dest","in":"query","required":true,"description":"Destination","schema":{"type":"string","example":"LGA"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Flight cancellation risk","value":{"data":{"id":"ATL-LGA","type":"flight_cancellation_risk","attributes":{"origin_airport":"ATL","destination_airport":"LGA","sample_size":1904,"cancellation_rate":0.014,"risk_level":"low","reliability_score":88.6}},"meta":{"credits_used":10,"source":"ApiDatasets normalized historical flight reliability dataset","dataset_status":"Beta aggregate; not live tracking"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/flights/cancellation-risk":{"get":{"tags":["Demo Dataset APIs","flights"],"summary":"Flight cancellation risk","description":"Guarded no-key demo for Flight cancellation risk. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_flight_cancellation_risk","parameters":[{"name":"origin","in":"query","required":true,"description":"Origin","schema":{"type":"string","example":"ATL"}},{"name":"dest","in":"query","required":true,"description":"Destination","schema":{"type":"string","example":"LGA"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Flight cancellation risk","value":{"data":{"id":"ATL-LGA","type":"flight_cancellation_risk","attributes":{"origin_airport":"ATL","destination_airport":"LGA","sample_size":1904,"cancellation_rate":0.014,"risk_level":"low","reliability_score":88.6}},"meta":{"source":"ApiDatasets normalized historical flight reliability dataset","dataset_status":"Beta aggregate; not live tracking","demo":true,"production_endpoint":"/api/v1/flights/cancellation-risk"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/flights/routes/summary":{"get":{"tags":["Dataset APIs","flights"],"summary":"Flight route summary","description":"Flight route summary. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_flight_route_summary","parameters":[{"name":"origin","in":"query","required":true,"description":"Origin","schema":{"type":"string","example":"ATL"}},{"name":"dest","in":"query","required":true,"description":"Destination","schema":{"type":"string","example":"LGA"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Flight route summary","value":{"data":{"id":"ATL-LGA","type":"flight_route_summary","attributes":{"origin_airport":"ATL","destination_airport":"LGA","sample_size":1904,"risk_level":"low","best_departure_hour_bucket":"06-09"}},"meta":{"credits_used":10,"source":"ApiDatasets normalized historical flight reliability dataset","dataset_status":"Beta aggregate; not live tracking"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/flights/routes/summary":{"get":{"tags":["Demo Dataset APIs","flights"],"summary":"Flight route summary","description":"Guarded no-key demo for Flight route summary. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_flight_route_summary","parameters":[{"name":"origin","in":"query","required":true,"description":"Origin","schema":{"type":"string","example":"ATL"}},{"name":"dest","in":"query","required":true,"description":"Destination","schema":{"type":"string","example":"LGA"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Flight route summary","value":{"data":{"id":"ATL-LGA","type":"flight_route_summary","attributes":{"origin_airport":"ATL","destination_airport":"LGA","sample_size":1904,"risk_level":"low","best_departure_hour_bucket":"06-09"}},"meta":{"source":"ApiDatasets normalized historical flight reliability dataset","dataset_status":"Beta aggregate; not live tracking","demo":true,"production_endpoint":"/api/v1/flights/routes/summary"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/company/domain":{"get":{"tags":["Dataset APIs","company"],"summary":"Company domain","description":"Company domain. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_company_domain","parameters":[{"name":"domain","in":"query","required":true,"description":"Domain","schema":{"type":"string","example":"example.com"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Company domain","value":{"data":{"id":"apple.com","type":"company_profile","attributes":{"company_name":"Apple Inc.","domain":"apple.com","ticker":"AAPL","exchange":"NASDAQ"}},"meta":{"credits_used":5,"source":"ApiDatasets normalized company profile dataset","dataset_status":"Beta profile"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/company/domain":{"get":{"tags":["Demo Dataset APIs","company"],"summary":"Company domain","description":"Guarded no-key demo for Company domain. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_company_domain","parameters":[{"name":"domain","in":"query","required":true,"description":"Domain","schema":{"type":"string","example":"example.com"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Company domain","value":{"data":{"id":"apple.com","type":"company_profile","attributes":{"company_name":"Apple Inc.","domain":"apple.com","ticker":"AAPL","exchange":"NASDAQ"}},"meta":{"source":"ApiDatasets normalized company profile dataset","dataset_status":"Beta profile","demo":true,"production_endpoint":"/api/v1/company/domain"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/company/search":{"get":{"tags":["Dataset APIs","company"],"summary":"Company search","description":"Company search. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_company_search","parameters":[{"name":"q","in":"query","required":true,"description":"Search","schema":{"type":"string","example":"technology"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Company search","value":{"data":[{"id":"apple.com","type":"company_profile","attributes":{"company_name":"Apple Inc.","domain":"apple.com","industry":"Consumer Electronics","ticker":"AAPL"}},{"id":"microsoft.com","type":"company_profile","attributes":{"company_name":"Microsoft Corporation","domain":"microsoft.com","industry":"Software","ticker":"MSFT"}}],"pagination":{"page":1,"per_page":25,"total":2},"meta":{"credits_used":5,"source":"ApiDatasets normalized company profile dataset","dataset_status":"Beta profile search"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/company/search":{"get":{"tags":["Demo Dataset APIs","company"],"summary":"Company search","description":"Guarded no-key demo for Company search. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_company_search","parameters":[{"name":"q","in":"query","required":true,"description":"Search","schema":{"type":"string","example":"technology"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Company search","value":{"data":[{"id":"apple.com","type":"company_profile","attributes":{"company_name":"Apple Inc.","domain":"apple.com","industry":"Consumer Electronics","ticker":"AAPL"}},{"id":"microsoft.com","type":"company_profile","attributes":{"company_name":"Microsoft Corporation","domain":"microsoft.com","industry":"Software","ticker":"MSFT"}}],"pagination":{"page":1,"per_page":25,"total":2},"meta":{"source":"ApiDatasets normalized company profile dataset","dataset_status":"Beta profile search","demo":true,"production_endpoint":"/api/v1/company/search"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/company/industry":{"get":{"tags":["Dataset APIs","company"],"summary":"Company industry search","description":"Company industry search. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_company_industry","parameters":[{"name":"industry","in":"query","required":true,"description":"Industry","schema":{"type":"string","example":"technology"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Company industry search","value":{"data":[{"id":"nvidia.com","type":"company_profile","attributes":{"company_name":"NVIDIA Corporation","domain":"nvidia.com","industry":"Semiconductors","ticker":"NVDA"}}],"pagination":{"page":1,"per_page":25,"total":1,"has_more":false},"meta":{"credits_used":5,"source":"ApiDatasets normalized company profile dataset","dataset_status":"Beta industry profile search"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/company/industry":{"get":{"tags":["Demo Dataset APIs","company"],"summary":"Company industry search","description":"Guarded no-key demo for Company industry search. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_company_industry","parameters":[{"name":"industry","in":"query","required":true,"description":"Industry","schema":{"type":"string","example":"technology"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Company industry search","value":{"data":[{"id":"nvidia.com","type":"company_profile","attributes":{"company_name":"NVIDIA Corporation","domain":"nvidia.com","industry":"Semiconductors","ticker":"NVDA"}}],"pagination":{"page":1,"per_page":25,"total":1,"has_more":false},"meta":{"source":"ApiDatasets normalized company profile dataset","dataset_status":"Beta industry profile search","demo":true,"production_endpoint":"/api/v1/company/industry"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/company/ticker/{ticker}":{"get":{"tags":["Dataset APIs","company"],"summary":"Company ticker","description":"Company ticker. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_company_ticker","parameters":[{"name":"ticker","in":"path","required":true,"description":"Ticker","schema":{"type":"string","example":"NVDA"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Company ticker","value":{"data":{"id":"NVDA","type":"company_profile","attributes":{"company_name":"NVIDIA Corporation","domain":"nvidia.com","ticker":"NVDA","industry":"Semiconductors"}},"meta":{"credits_used":5,"source":"ApiDatasets normalized company profile dataset","dataset_status":"Beta ticker profile"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/company/ticker/{ticker}":{"get":{"tags":["Demo Dataset APIs","company"],"summary":"Company ticker","description":"Guarded no-key demo for Company ticker. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_company_ticker","parameters":[{"name":"ticker","in":"path","required":true,"description":"Ticker","schema":{"type":"string","example":"NVDA"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Company ticker","value":{"data":{"id":"NVDA","type":"company_profile","attributes":{"company_name":"NVIDIA Corporation","domain":"nvidia.com","ticker":"NVDA","industry":"Semiconductors"}},"meta":{"source":"ApiDatasets normalized company profile dataset","dataset_status":"Beta ticker profile","demo":true,"production_endpoint":"/api/v1/company/ticker/{ticker}"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/company/nonprofit/ein/{ein}":{"get":{"tags":["Dataset APIs","company"],"summary":"Company nonprofit EIN","description":"Company nonprofit EIN. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_company_nonprofit_ein","parameters":[{"name":"ein","in":"path","required":true,"description":"EIN","schema":{"type":"string","example":"20-0049703"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Company nonprofit EIN","value":{"data":{"id":"20-0049703","type":"nonprofit_profile","attributes":{"ein":"20-0049703","organization_name":"Wikimedia Foundation Inc.","category":"Knowledge and education","state":"CA","subsection":"501(c)(3)"}},"meta":{"credits_used":5,"source":"ApiDatasets normalized nonprofit beta profile","dataset_status":"Beta nonprofit profile"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/company/nonprofit/ein/{ein}":{"get":{"tags":["Demo Dataset APIs","company"],"summary":"Company nonprofit EIN","description":"Guarded no-key demo for Company nonprofit EIN. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_company_nonprofit_ein","parameters":[{"name":"ein","in":"path","required":true,"description":"EIN","schema":{"type":"string","example":"20-0049703"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Company nonprofit EIN","value":{"data":{"id":"20-0049703","type":"nonprofit_profile","attributes":{"ein":"20-0049703","organization_name":"Wikimedia Foundation Inc.","category":"Knowledge and education","state":"CA","subsection":"501(c)(3)"}},"meta":{"source":"ApiDatasets normalized nonprofit beta profile","dataset_status":"Beta nonprofit profile","demo":true,"production_endpoint":"/api/v1/company/nonprofit/ein/{ein}"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/company/nonprofit/search":{"get":{"tags":["Dataset APIs","company"],"summary":"Company nonprofit search","description":"Company nonprofit search. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_company_nonprofit_search","parameters":[{"name":"q","in":"query","required":true,"description":"Search","schema":{"type":"string","example":"education"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Company nonprofit search","value":{"data":[{"id":"20-0049703","type":"nonprofit_profile","attributes":{"ein":"20-0049703","organization_name":"Wikimedia Foundation Inc.","category":"Knowledge and education","state":"CA"}},{"id":"26-1544963","type":"nonprofit_profile","attributes":{"ein":"26-1544963","organization_name":"Khan Academy Inc.","category":"Education technology","state":"CA"}}],"pagination":{"page":1,"per_page":25,"total":2},"meta":{"credits_used":5,"source":"ApiDatasets normalized nonprofit beta profile","dataset_status":"Beta nonprofit search"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/company/nonprofit/search":{"get":{"tags":["Demo Dataset APIs","company"],"summary":"Company nonprofit search","description":"Guarded no-key demo for Company nonprofit search. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_company_nonprofit_search","parameters":[{"name":"q","in":"query","required":true,"description":"Search","schema":{"type":"string","example":"education"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Company nonprofit search","value":{"data":[{"id":"20-0049703","type":"nonprofit_profile","attributes":{"ein":"20-0049703","organization_name":"Wikimedia Foundation Inc.","category":"Knowledge and education","state":"CA"}},{"id":"26-1544963","type":"nonprofit_profile","attributes":{"ein":"26-1544963","organization_name":"Khan Academy Inc.","category":"Education technology","state":"CA"}}],"pagination":{"page":1,"per_page":25,"total":2},"meta":{"source":"ApiDatasets normalized nonprofit beta profile","dataset_status":"Beta nonprofit search","demo":true,"production_endpoint":"/api/v1/company/nonprofit/search"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/company/classify":{"get":{"tags":["Dataset APIs","company"],"summary":"Company classify","description":"Company classify. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_company_classify","parameters":[{"name":"url","in":"query","required":true,"description":"URL","schema":{"type":"string","example":"nvidia.com"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Company classify","value":{"data":{"id":"nvidia.com","type":"company_classification","attributes":{"domain":"nvidia.com","classification":"Semiconductors","confidence":"matched_profile","ticker":"NVDA"}},"meta":{"credits_used":5,"source":"ApiDatasets normalized company profile dataset","dataset_status":"Beta classification"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/company/classify":{"get":{"tags":["Demo Dataset APIs","company"],"summary":"Company classify","description":"Guarded no-key demo for Company classify. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_company_classify","parameters":[{"name":"url","in":"query","required":true,"description":"URL","schema":{"type":"string","example":"nvidia.com"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Company classify","value":{"data":{"id":"nvidia.com","type":"company_classification","attributes":{"domain":"nvidia.com","classification":"Semiconductors","confidence":"matched_profile","ticker":"NVDA"}},"meta":{"source":"ApiDatasets normalized company profile dataset","dataset_status":"Beta classification","demo":true,"production_endpoint":"/api/v1/company/classify"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/jobs/trends":{"get":{"tags":["Dataset APIs","jobs"],"summary":"Jobs skill trend","description":"Jobs skill trend. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_jobs_trends","parameters":[{"name":"skill","in":"query","required":true,"description":"Skill","schema":{"type":"string","example":"python"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Jobs skill trend","value":{"data":[{"id":"1","type":"job_skill_trend","attributes":{"skill":"python","job_title":"data analyst","trend_direction":"up","job_count":1280}}],"pagination":{"page":1,"per_page":25,"total":1},"meta":{"credits_used":5,"source":"ApiDatasets normalized labor-market trend dataset","dataset_status":"Beta trend"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/jobs/trends":{"get":{"tags":["Demo Dataset APIs","jobs"],"summary":"Jobs skill trend","description":"Guarded no-key demo for Jobs skill trend. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_jobs_trends","parameters":[{"name":"skill","in":"query","required":true,"description":"Skill","schema":{"type":"string","example":"python"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Jobs skill trend","value":{"data":[{"id":"1","type":"job_skill_trend","attributes":{"skill":"python","job_title":"data analyst","trend_direction":"up","job_count":1280}}],"pagination":{"page":1,"per_page":25,"total":1},"meta":{"source":"ApiDatasets normalized labor-market trend dataset","dataset_status":"Beta trend","demo":true,"production_endpoint":"/api/v1/jobs/trends"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/jobs/related-skills":{"get":{"tags":["Dataset APIs","jobs"],"summary":"Jobs related skills","description":"Jobs related skills. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_jobs_related_skills","parameters":[{"name":"skill","in":"query","required":true,"description":"Skill","schema":{"type":"string","example":"python"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Jobs related skills","value":{"data":[{"id":"sql","type":"job_related_skill_signal","attributes":{"skill":"sql","signal_count":320,"matched_roles":["data analyst"]}}],"pagination":{"page":1,"per_page":25,"total":1,"has_more":false},"meta":{"credits_used":5,"source":"ApiDatasets normalized labor-market trend dataset","dataset_status":"Beta related-skill signal"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/jobs/related-skills":{"get":{"tags":["Demo Dataset APIs","jobs"],"summary":"Jobs related skills","description":"Guarded no-key demo for Jobs related skills. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_jobs_related_skills","parameters":[{"name":"skill","in":"query","required":true,"description":"Skill","schema":{"type":"string","example":"python"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Jobs related skills","value":{"data":[{"id":"sql","type":"job_related_skill_signal","attributes":{"skill":"sql","signal_count":320,"matched_roles":["data analyst"]}}],"pagination":{"page":1,"per_page":25,"total":1,"has_more":false},"meta":{"source":"ApiDatasets normalized labor-market trend dataset","dataset_status":"Beta related-skill signal","demo":true,"production_endpoint":"/api/v1/jobs/related-skills"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/jobs/skills":{"get":{"tags":["Dataset APIs","jobs"],"summary":"Jobs role skills","description":"Jobs role skills. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_jobs_skills","parameters":[{"name":"title","in":"query","required":true,"description":"Title","schema":{"type":"string","example":"data analyst"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Jobs role skills","value":{"data":[{"id":"python","type":"job_role_skill_signal","attributes":{"skill":"python","signal_count":1280}},{"id":"sql","type":"job_role_skill_signal","attributes":{"skill":"sql","signal_count":815}}],"pagination":{"page":1,"per_page":25,"total":2},"meta":{"credits_used":5,"source":"ApiDatasets normalized labor-market trend dataset","dataset_status":"Beta role skill signal"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/jobs/skills":{"get":{"tags":["Demo Dataset APIs","jobs"],"summary":"Jobs role skills","description":"Guarded no-key demo for Jobs role skills. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_jobs_skills","parameters":[{"name":"title","in":"query","required":true,"description":"Title","schema":{"type":"string","example":"data analyst"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Jobs role skills","value":{"data":[{"id":"python","type":"job_role_skill_signal","attributes":{"skill":"python","signal_count":1280}},{"id":"sql","type":"job_role_skill_signal","attributes":{"skill":"sql","signal_count":815}}],"pagination":{"page":1,"per_page":25,"total":2},"meta":{"source":"ApiDatasets normalized labor-market trend dataset","dataset_status":"Beta role skill signal","demo":true,"production_endpoint":"/api/v1/jobs/skills"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/jobs/remote-trends":{"get":{"tags":["Dataset APIs","jobs"],"summary":"Jobs remote trends","description":"Jobs remote trends. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_jobs_remote_trends","parameters":[{"name":"role","in":"query","required":true,"description":"Role","schema":{"type":"string","example":"software engineer"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Jobs remote trends","value":{"data":[{"id":"remote","type":"job_remote_trend","attributes":{"remote_status":"remote","job_count":1420,"share":0.61}},{"id":"hybrid","type":"job_remote_trend","attributes":{"remote_status":"hybrid","job_count":910,"share":0.39}}],"pagination":{"page":1,"per_page":2,"total":2},"meta":{"credits_used":5,"source":"ApiDatasets normalized labor-market trend dataset","dataset_status":"Beta remote-work signal"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/jobs/remote-trends":{"get":{"tags":["Demo Dataset APIs","jobs"],"summary":"Jobs remote trends","description":"Guarded no-key demo for Jobs remote trends. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_jobs_remote_trends","parameters":[{"name":"role","in":"query","required":true,"description":"Role","schema":{"type":"string","example":"software engineer"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Jobs remote trends","value":{"data":[{"id":"remote","type":"job_remote_trend","attributes":{"remote_status":"remote","job_count":1420,"share":0.61}},{"id":"hybrid","type":"job_remote_trend","attributes":{"remote_status":"hybrid","job_count":910,"share":0.39}}],"pagination":{"page":1,"per_page":2,"total":2},"meta":{"source":"ApiDatasets normalized labor-market trend dataset","dataset_status":"Beta remote-work signal","demo":true,"production_endpoint":"/api/v1/jobs/remote-trends"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/jobs/companies/hiring":{"get":{"tags":["Dataset APIs","jobs"],"summary":"Jobs companies hiring","description":"Jobs companies hiring. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_jobs_companies_hiring","parameters":[{"name":"location","in":"query","required":true,"description":"Location","schema":{"type":"string","example":"atlanta"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Jobs companies hiring","value":{"data":[{"id":"1","type":"job_company_hiring_signal","attributes":{"company_name":"Delta Air Lines, Inc.","location":"Atlanta, GA","hiring_signal":"active","open_roles_estimate":38}},{"id":"2","type":"job_company_hiring_signal","attributes":{"company_name":"The Home Depot, Inc.","location":"Atlanta, GA","hiring_signal":"active","open_roles_estimate":44}}],"pagination":{"page":1,"per_page":25,"total":2},"meta":{"credits_used":5,"source":"ApiDatasets normalized company hiring beta signal","dataset_status":"Beta company hiring signal"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/jobs/companies/hiring":{"get":{"tags":["Demo Dataset APIs","jobs"],"summary":"Jobs companies hiring","description":"Guarded no-key demo for Jobs companies hiring. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_jobs_companies_hiring","parameters":[{"name":"location","in":"query","required":true,"description":"Location","schema":{"type":"string","example":"atlanta"}},{"name":"page","in":"query","required":false,"description":"Result page number. Starts at 1.","schema":{"type":"integer","minimum":1,"example":1}},{"name":"per_page","in":"query","required":false,"description":"Results per page. Maximum 100.","schema":{"type":"integer","minimum":1,"maximum":100,"example":25}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Jobs companies hiring","value":{"data":[{"id":"1","type":"job_company_hiring_signal","attributes":{"company_name":"Delta Air Lines, Inc.","location":"Atlanta, GA","hiring_signal":"active","open_roles_estimate":38}},{"id":"2","type":"job_company_hiring_signal","attributes":{"company_name":"The Home Depot, Inc.","location":"Atlanta, GA","hiring_signal":"active","open_roles_estimate":44}}],"pagination":{"page":1,"per_page":25,"total":2},"meta":{"source":"ApiDatasets normalized company hiring beta signal","dataset_status":"Beta company hiring signal","demo":true,"production_endpoint":"/api/v1/jobs/companies/hiring"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/jobs/salary-signals":{"get":{"tags":["Dataset APIs","jobs"],"summary":"Jobs salary signals","description":"Jobs salary signals. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_jobs_salary_signals","parameters":[{"name":"title","in":"query","required":true,"description":"Title","schema":{"type":"string","example":"cloud engineer"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Jobs salary signals","value":{"data":{"id":"cloud engineer","type":"job_salary_signal","attributes":{"title_query":"cloud engineer","salary_min":116000,"salary_max":178000,"salary_midpoint":147000,"sample_job_count":930}},"meta":{"credits_used":5,"source":"ApiDatasets normalized labor-market trend dataset","dataset_status":"Beta salary signal"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/jobs/salary-signals":{"get":{"tags":["Demo Dataset APIs","jobs"],"summary":"Jobs salary signals","description":"Guarded no-key demo for Jobs salary signals. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_jobs_salary_signals","parameters":[{"name":"title","in":"query","required":true,"description":"Title","schema":{"type":"string","example":"cloud engineer"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Jobs salary signals","value":{"data":{"id":"cloud engineer","type":"job_salary_signal","attributes":{"title_query":"cloud engineer","salary_min":116000,"salary_max":178000,"salary_midpoint":147000,"sample_job_count":930}},"meta":{"source":"ApiDatasets normalized labor-market trend dataset","dataset_status":"Beta salary signal","demo":true,"production_endpoint":"/api/v1/jobs/salary-signals"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/meta/catalog":{"get":{"tags":["Dataset APIs","meta"],"summary":"Catalog metadata","description":"Catalog metadata. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_meta_catalog","parameters":[{"name":"include_endpoints","in":"query","required":true,"description":"Include endpoints","schema":{"type":"boolean","example":"false"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Catalog metadata","value":{"data":[{"id":"location-enrichment","type":"dataset","attributes":{"name":"Location Enrichment API","status":"Live","record_count":33100,"endpoint_count":6,"demo_available":true}}],"meta":{"credits_used":0,"dataset_count":5,"live_count":2,"beta_count":3,"message":"Public-safe API catalog metadata."}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/meta/catalog":{"get":{"tags":["Demo Dataset APIs","meta"],"summary":"Catalog metadata","description":"Guarded no-key demo for Catalog metadata. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_meta_catalog","parameters":[{"name":"include_endpoints","in":"query","required":true,"description":"Include endpoints","schema":{"type":"boolean","example":"false"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Catalog metadata","value":{"data":[{"id":"location-enrichment","type":"dataset","attributes":{"name":"Location Enrichment API","status":"Live","record_count":33100,"endpoint_count":6,"demo_available":true}}],"meta":{"dataset_count":5,"live_count":2,"beta_count":3,"message":"Public-safe API catalog metadata.","demo":true,"production_endpoint":"/api/v1/meta/catalog"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}},"/api/v1/meta/datasets/{slug}":{"get":{"tags":["Dataset APIs","meta"],"summary":"Dataset coverage metadata","description":"Dataset coverage metadata. Production requests require an ApiDatasets API key and are usage tracked.","operationId":"api_meta_dataset","parameters":[{"name":"slug","in":"path","required":true,"description":"Dataset slug","schema":{"type":"string","example":"location-enrichment"}}],"security":[{"BearerAuth":[]},{"ApiKeyHeader":[]}],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Dataset coverage metadata","value":{"data":{"id":"location-enrichment","type":"dataset","attributes":{"name":"Location Enrichment API","status":"Live","record_count":33100,"coverage_summary":"Live ZIP profile coverage.","endpoint_count":6}},"meta":{"credits_used":0,"mode":"production","message":"Public-safe dataset coverage metadata."}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"missing_api_key":{"summary":"Missing API key","value":{"error":{"code":"missing_api_key","message":"Provide an API key using Authorization: Bearer or X-API-Key."}}},"invalid_api_key":{"summary":"Invalid API key","value":{"error":{"code":"invalid_api_key","message":"The provided API key is invalid or inactive."}}}}}}},"402":{"description":"Monthly usage limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}},"403":{"description":"Plan does not allow this endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"monthly_limit":{"summary":"Monthly limit exceeded","value":{"error":{"code":"monthly_limit_exceeded","message":"This API key has exceeded the monthly credit limit for the current plan.","upgrade_url":"https://apidatasets.com/pricing"}}}}}}}}}},"/demo/api/v1/meta/datasets/{slug}":{"get":{"tags":["Demo Dataset APIs","meta"],"summary":"Dataset coverage metadata","description":"Guarded no-key demo for Dataset coverage metadata. Demo values are allowlisted and rate limited; arbitrary lookup is intentionally blocked.","operationId":"demo_meta_dataset","parameters":[{"name":"slug","in":"path","required":true,"description":"Dataset slug","schema":{"type":"string","example":"location-enrichment"}}],"security":[],"responses":{"200":{"description":"Successful ApiDatasets response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDatasetsResponse"},"examples":{"success":{"summary":"Dataset coverage metadata","value":{"data":{"id":"location-enrichment","type":"dataset","attributes":{"name":"Location Enrichment API","status":"Live","record_count":33100,"coverage_summary":"Live ZIP profile coverage.","endpoint_count":6}},"meta":{"mode":"production","message":"Public-safe dataset coverage metadata.","demo":true,"production_endpoint":"/api/v1/meta/datasets/{slug}"}}}}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"404":{"description":"Resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"rate_limit":{"summary":"Rate limited","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}}}}}}},"403":{"description":"Demo parameter is not allowlisted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"demo_blocked":{"summary":"Demo value not allowed","value":{"error":{"code":"demo_parameter_not_allowed","message":"Demo routes only allow selected sample values. Create a free API key to test custom values.","examples":["30301","10001","94105"]}}}}}}}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"ApiDatasets API key"},"ApiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"ApiDatasetsResponse":{"type":"object","properties":{"data":{"description":"Object or list payload.","oneOf":[{"type":"object"},{"type":"array"}]},"meta":{"type":"object","additionalProperties":true},"pagination":{"type":"object","additionalProperties":true}},"required":["data","meta"]},"ErrorResponse":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":true}},"required":["error"]}}}}